URL Syntax

Application Development

These utilities are meant for web developers and should not be revealed to users.

• showapps – Given alone, shows the list of available applications. Must be enabled with the AllowShowApps setting in the [Web.config](Web.config Settings) file.
• keepurl – Given any value (1 or "true" would be sufficient), will retain the URL that started the GPV in the address bar.

Map

• application – Required, the ID of the GPV application to run.
• maptab – The ID of the map tab to activate. If not specified, this will be set to the DefaultMapTab specified for the application. If the DefaultMapTab is null, the first map tab will be activated.
• layerson - A comma-separated list of IDs of layers to turn on in an interactive legend, overriding the default layer visibility settings in the GPVMapTabLayer table.
• layersoff - A comma-separated list of IDs of layers to turn off in an interactive legend, overriding the default layer visibility settings in the GPVMapTabLayer table.
• New at 5.0 tileson - A comma-separated list of IDs of tile groups to turn on in an interactive legend, overriding the default tile group visibility settings in the GPVMapTabTileGroup table.
• New at 5.0 tilesoff - A comma-separated list of IDs of tile groups to turn off in an interactive legend, overriding the default tile group visibility settings in the GPVMapTabTileGroup table.

Selection

• New at 5.0 search - The ID of the search to show. Sets the initial value of the search pulldown list. Does not provide search criteria nor perform a search.
• action - The action to perform on the features with the specified IDs. One of: "select", "findallwithin", "findnearest1", "findnearest2", "findnearest3", "findnearest4" or "findnearest5". Set the initial value of the action pulldown list.
• targetlayer – The ID of the layer containing target features. If specified, maptab must also be specified or the application must have a DefaultMapTab. Sets the initial value of the target layer pulldown list.
• targetids – A comma-separated list of map IDs for the target features. Only valid if action is "select". If specified, targetlayer must also be specified or the application must have a DefaultTargetLayer defined and targetparams must not be specified.
• targetparams – A comma-separated list of parameters which are passed to the target parameters stored procedure of the target layer. The stored procedure will return the map IDs of the target features. Only valid if action is "select". If specified, targetlayer must also be specified or the application must have a DefaultTargetLayer defined and targetids must not be specified.
• proximity - The ID of the proximity (named search distance) to use when action is "findallwithin".
• selectionlayer – The ID of the layer containing selection features. If specified, maptab must also be specified or the application must have a DefaultMapTab. Sets the initial value of the selection layer pulldown list.
• selectionids – A comma-separated list of Map IDs of features to use for selecting target features. If specified, selectionlayer must also be specified or the application must have a DefaultSelectionLayer defined.
• activemapid – The Map ID of one feature to highlight on the map. This Map ID must also be specified in the list of targetids.
• activedataid – The Data ID of one record to highlight in the query grid. This should be associated with the feature specified by activemapid. If not specified, this defaults to the same value as activemapid.

User Interface

• functiontabs – The function tabs to display to the left of the map, either: "none", "all", or any combination of "selection", "legend", "location", "markup" or New at 4.2 "share" separated by commas. If not specified, this is set to the FunctionTabs that were configured for the application. If FunctionTabs is null, this defaults to "none" (map-only mode). Note that it is not possible to add function tabs that have not already been configured for the application -- this must be either "none" or a subset of the configured FunctionTabs.
• activefunctiontab - The function tab to activate. This function tab must displayed as defined in functiontabs above. If not specified, defaults to the first available function tab.
• query – The ID of the initial query to run against the target data. If not specified, this defaults to the first query. Set the initial value of the query (filtered by) pulldown list.
• datatab – The ID of the data tab to activate. If not specified, this defaults to the first data tab.
• markupcategory - The ID of the markup category to activate on the markup tab. If not specified, defaults to the first available markup category.
• markupgroup - The ID of the markup group zoom to and display on the map. The markupcategory above must be provided and this markup group must belong to that markup category.
• tool - The map tool to activate, one of: "identify", "select", "drawpoint", "drawline", "drawpolygon", "drawcircle", "drawtext", "drawcoordinates", "drawlength", "drawarea", "deletemarkup", "colorpicker" or "paintbucket". For backward compatibility "pan" is still supported but it's now a synonym for "identify". If not specified or if the specified tool is disabled, this defaults to "identify".

Zones and Levels

• zone - The ID of the zone which specifies the initial extent of the map. If specified, extent, centerx, centery, centerlat, centerlon must not be specified.
• level - The ID of the initial level to display. If not specified, this will be set to the DefaultLevel specified for the application. If the DefaultLevel is null, the first level will be displayed if available.

Zooming

• extent - The initial extent for the map specified as four comma-separated numbers: minimum X, minimum Y, maximum X, maximum Y in the measurement projection's units. If specified, zone, zoomlevel, scaleby and mapscale must not be specified.
• zoomlevel – The initial zoom level for the map, where 1 is equivalent to the full extent and each whole number greater is a 2x zoom in. If specified, extent, scaleby and mapscale must not be specified. Can be any real number greater than zero.
• centerx, centery – The center coordinates of the initial map extent when using zoomlevel specified in the measurement projection's units. If specified, zone, centerlat, centerlon and scaleby must not be specified.
• centerlat, centerlon – The center coordinates of the initial map extent when using zoomlevel specified as a latitutde and longitude in decimal degrees. If specified, zone, centerx, centery and scaleby must not be specified.
• scaleby – The scale factor to apply to the extent of the zone or all target and selection features as the initial extent of the map. A value of 1 fits the extent exactly to the zone or features. Can be any real number greater than zero, but is usually set between 1 and 2. If specified, extent, zoomlevel, centerx, centery, centerlat, centerlon and mapscale must not be specified.
• markcenter - Given any value (1 or "true" would be sufficient), will draw the coordinates at the center of the map.

See GPVSetting for details on the MeasureProjection setting.

Printing

• printtemplate – The ID of the printable map template to use. This forces the GPV to display the printable map directly without first showing the user interface.
• printtitle – The title to place on the printable map. Only used with printtemplate.
• mapscale - The scale of the map, a distance in ground units relative to one inch on the printed page. If specified, extent, zoomlevel and scaleby must not be specified. Can be any real number greater than zero. At version 4.2 this parameter only works for printing.