Appendix |
Administrators can create URLs using the available parameters, which can then be used to automatically display the Spectrum Spatial Analyst interface in a specific way. Note that the parameters added to the URL will override the settings for the selected map configuration. If any parameters are entered incorrectly they will be ignored and the settings for the default map configuration used instead.
The following table shows the parameters you can specify in the URL for launching Spectrum Spatial Analyst :
Parameter | Description | Example |
---|---|---|
mapcfg | The name of the map configuration to use. | mapcfg=mytestmap |
lang |
The supported languages are:
To launch either the Admin Console or Spectrum Spatial Analyst in one of these languages please add a "lang" parameter to the end of the URL. |
lang=cy |
x | The X location of the map center point. The map is centered here. | x=530000 |
y | The Y location of the map center point. The map is centered here. | y=183000 |
lon | The lon location of the map center point. The map is
lon=1.131415 centered here. Note: If both X,Y and lon lat
mentioned in the url, lon,lat will be given preference. lon,
lat values should be Corresponding to projection
(EPSG:4326).
|
lon=1.131415 |
lat | The lat location of the map center point. The map is lat=1.131415 centered here. | lat=1.131415 |
showRings | Specifies whether a circle or concentric rings are added to Spectrum Spatial Analyst
as an annotation. One or more comma separated values can be
included. If a single value is specified a circle is added. If
more than one value is specified then concentric rings are
added. The unit of the values will be taken from the
showRingsUnit parameter and will default to meters is that
parameter is omitted. You can enter 2 to 5 rings only. Note: The
concentric circle is drawn at the XY location. The radius
can be a whole number or decimal up to max of 2 or 3 decimal
places.
|
showRings=2.2,4,6,8 |
showRingsUnit | Specifies the unit for the showRings parameter. The supported units are kilometers, meters, miles and feet. By default, unit is meters. | showRingsUnit=kilometers |
addAsLayer |
Determines whether the X,Y (or lat lon) location specified is added as a point vector layer into Spectrum Spatial Analyst. If omitted the default is false. The layer will appear in the map legend. |
addAsLayer=true |
layerName |
Defines the name of the layer added with addAsLayer param, by default the name will be pointLayer. |
layerName= vectorLayer |
custTemplate | It helps user define a custom template on callout for the layer Created by
addAsLayer. Using a custom template with the showInfo parameter set to true allows users to launch Spectrum Spatial Analyst at any arbitrary location and show any information that the admin has added to the template. For example the template can be designed to make server side requests to calculate the total insured risk value at that point, or to show other information both related or unrelated to the map layers loaded into Spectrum Spatial Analyst. Custom templates are saved to the following folder in Spectrum:- C:\Program Files\Pitney Bowes\SpectrumSpatialAnalyst\ customerconfigurations\analyst\theme\infotemplates Refer to Appendix D for more details. |
custTemplate=MyTemplate |
reload | If set to true the SSA application will fully re-fresh the browser page, as if the URL was browsed for the first time. If set to false (the default value if reload is not specified) the URL parameters (such as the X, Y and Zoom) are applied to the current map in the browser view. | reload=true |
zoom | The map zoom to use when Spectrum Spatial Analyst is launched. | zoom=10 |
showInfo | Indicates whether the map call out is shown by passing true. The map call out is shown at the XY location and a query at that point is made on the visible map layers to retrieve attribute data for the call out. |
showInfo=true
|
showNearest | Indicates whether a search nearest result set is displayed
using the XY as the search center. You pass the name of the
search table as the parameter and optionally a name for the
location that is specified by the XY (the name is displayed in
the map area, e.g. showing nearest Primary Schools to Our
Office). Repository path is supported for Tables or Table name.
Note: Zoom is not a valid parameter if valid value exists
for showNearest in
url.
‘addrName’ is an optional parameter for showNearest url. It should have valid value for the search location. Note: Different
tables may have same name with different repository path. By
default, search will pick the first repository path
encountered in the find nearest
configuration.
|
showNearest=Primary Schools addrName=Our Office |
queryTable | a Named Table name on which query will be executed. | queryTable=/QA-Maps/NamedTables/ListedBuildings |
queryColumn | a column name of that table for query criteria. |
queryColumn=LB_NO |
queryValues | comma separated list of values for query criteria Note: If query values contains
special characters like ," '$ #%^&*() it needs to be
encoded before passing in as query values.
|
queryValues=1325,1326 |
overlays | A comma separated list of map overlays to be toggled to visible when Spectrum Spatial Analyst is launched. The overlays must be included in the map configuration specified in mapcfg. Any overlays in the map configuration that are not listed will be toggled invisible. A user can change the visibility after Spectrum Spatial Analyst is launched using the legend control. | overlays=Development Map, Conservation Map |
baseMap | The name of the active basemap when Spectrum Spatial Analyst is launched. It must be one of base maps included in the map configuration specified in mapcfg. | baseMap=Hybrid |
Be aware of the following when defining your URLs: