...
In the above example we are selecting to show the Planning map source with the planning1 and planning2 layers.
| Code Block | ||
|---|---|---|
| ||
http://localhost/isharemaps.net/mycouncil.aspx?MapSource=organisation/education&StartEasting=351688&StartNorthing=385335&StartZoom=500&tab=maps |
By adding the &tab=maps in the above example My Maps will be displayed with the Map tab shown.
| Code Block | ||
|---|---|---|
| ||
http://localhost/isharemaps.net/mycouncil.aspx?MapSource=organisation/education&SearchLayer=Secondary_Schools&SearchField=New_School_Name&SearchValue=Wade%20Deacon%20High&20School&StartZoom=500 |
Parameters
...
Parameter | Description | Type | Required? |
|---|---|---|---|
MapSource | The name of an existing My Maps MapSource in the form "Organisation/MapSource". The Organisation component is the name of the folder under WebApps\WebService\config that contains your Map Source configuration (this is usually your organisation name) while the MapSource component is the name of the MapSource filename without the .xml extension. E.g. <MapName>organisation/planning</MapName> OR <MapName>organisation/education</MapName> | String | Mandatory |
BaseMapSource | This is the same as the MapSource parameter above but applies to Base Maps. | String | Optional |
StartEasting or x | This is the Easting co-ordinate for the centre of the map. If an MBR has been defined for the MapSource selected then this parameter must fall within it. | Float |
Optional | ||
StartNorthing or y | This is the Northing co-ordinate for the centre of the map. If an MBR has been defined for the MapSource selected then this parameter must fall within it. | Float |
Optional | ||
StartZoom or z | This is the zoom level that you wish to be set when displaying the map. If this parameter is not specified the default of 500 is assumed. The zoom level is specified in metres. | String |
Optional | |||
SearchLayer | This must be a VALID Layer name as defined in the MapSource configuration file. E.g. <LayerName> Secondary_Schools </LayerName> | String | Optional |
SearchField | This must be a VALID field name defined for the previous SearchLayer as defined in the MapSource configuration file. E.g. <Field> New_School_Name </Field> | String | Optional |
SearchValue | This is the search string to use for searching the previously defined SearchField. Spaces should be replaced with %20. E.g. Wade%20Deacon%20High&20School | String | Optional |
Layers | A comma separated list of layers to show (the layer names should match the names in the MapServer mapfile) | String | Optional |
Tab | This parameter is used to display the specified tab when My Maps is displayed. The values are restricted to the following: maps - displays the Map tab n - where n = 0 - 2 and represents the numeric value for the tab to display where the first tab is 0. | String | Optional |
Notes
- For simplicity StartEasting can be replaced with x, StartNorthing can be replaced with y and StartZoom can be replaced with z.
- The StartEasting, StartNorthing (Easting/Northing Location), StartZoom and SearchLayer, SearchField, SearchValue (Attribute Value) parameters are mutually exclusive i.e. if SearchLayer, SearchField and SearchValue are supplied then the other parameters of StartEasting, StartNorthin & StartZoom will be ignored.
- If the Search parameters are incorrect then the map will be displayed for the MapSource selected using the default startup parameters defined in the MapSource configuration file.
- If the MapSource parameter is incorrect then the default Map source will be displayed as defined in the Root configuration file.
- If the Easting or Northing parameters are invalid then the map will be displayed using the Startup Easting and Northing co-ordinates defined for the Map Source in the MapSource configuration file.