Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The MapGetImage.aspx Web Service provides various methods for building a map image. This method allows you to build the required image URL on the fly.  This can be done in one of several ways:

...

Note
  1. The BaseMap set as the Default for your selected Map Source (&MapSource) needs to refer to a 'local' map, not an ADS map i.e the URI should be something similar to http://localhost/mapserver/ms60?map=
  2. Any Overlay Layer (&Layers) should be a Classic Layer and not an OGC Layer.

1. Using ZoomtoLocation or GotoLocation

...


URL Parameters

Explanation

http://isharemaps.bathnes.gov.uk/MapGetImage.aspx?

URL to the page that generates a map image

RequestType=Map

Always use Map

&MapHeight=400

Height of the map window in pixels

&MapWidth=400

Width or the map window in pixels

&MapSource= Banes%2fBanes

Defines the MapSource to use. Note: Click on the MyMaps node in Studio, select the MapSource you wish to use and this parameter needs to be the MapSource Name escaping any / with %2f.

&MapID=-1

Unique ID for this call – always use -1

&Easting=367320

Easting coordinate for the centre of the map

&Northing=158020

Northing coordinate for the centre of the map

&Zoom=200

Zoom Level – this is affected by the Min / Max zoom level in the MapSource

&ServiceAction=ZoomToLocation OR

&ServiceAction=GotoLocation

ServiceAction – telling iShare to simply zoom [or Go] to that location

&ZoomPin=1

Optional addition of green arrow for that location

&layersList of comma separated layer names. Note: Not Display names.

 


Example output:

http://isharemaps.bathnes.gov.uk/MapGetImage.aspx?RequestType=Map&MapSource=Banes%2fBanes&MapHeight=400&MapWidth=400&mapid=-1&ServiceAction=ZoomToLocation&Easting=367320&Northing=158020&Zoom=200&ZoomPin=1


2.  Using SearchLayer


 

URL Parameters

Explanation

http://isharemaps.bathnes.gov.uk/MapGetImage.aspx?

URL to the page that generates a map image

RequestType=Map

Always use Map

&MapHeight=400

Height of the map window in pixels

&MapWidth=400

Width or the map window in pixels

&MapSource= Banes%2fBanes

Defines the MapSource to use

&MapID=-1

Unique ID for this call – always use -1

&Zoom=100

Zoom Level – this is affected by the Min / Max zoom level in the MapSource

&ServiceAction=SearchLayer

ServiceAction – telling iShare which layer to search on

&SearchLayer=Roadworks

Defines the layer on which to perform the search

&SearchField=WORKS_REF

Defines the field in the layer to search in

&SearchValue=004000018395

Details the value to search for in the search field

 

...



Example output:

http://isharemaps.bathnes.gov.uk/MapGetImage.aspx?RequestType=Map&MapSource=Banes%2fBanes&MapHeight=400&MapWidth=400&mapid=-1&ServiceAction=SearchLayer&SearchLayer=Roadworks&SearchValue=004000018395&SearchField=WORKS_REF&Zoom=1100


3. Using ZoomToPolygon

You can use this to embed a map of any boundary in (for example) My House. In order to draw a highlighted single feature, your map file needs to be prepared as shown here.

The next step is to generate the correct URL, as below:

...


URL Parameters

Explanation

http://isharemaps.bathnes.gov.uk/MapGetImage.aspx?

URL to the page that generates a map image

RequestType=Map

Always use Map

&MapHeight=400

Height of the map window in pixels

&MapWidth=400

Width or the map window in pixels

&MapSource= Banes%2fBanes

Defines the MapSource to use

&MapID=-1

Unique ID for this call – always use -1

&Zoom=100

Zoom Level – this is affected by the Min / Max zoom level in the MapSource

&ServiceAction=ZoomToPolygon

ServiceAction – telling iShare to zoom to a feature

&SearchLayer=Roadworks

Defines the layer on which to perform the search

&SearchField=WORKS_REF

Defines the field in the layer to search in

&SearchValue=004000018395

Details the value to search for in the search field

 


Example Output:

http://maps.doriconline.org.uk/MapGetImage.aspx?RequestType=Map&MapSource=DORIC/overlays&MapWidth=500&MapHeight=500&Zoom=300&mapid=-1&ServiceAction=ZoomToPolygon&SearchLayer=police_beats_filter&SearchField=Beat_Name&SearchValue=Ledsham

Embedding this map in My House

In PostgreSQL

To embed this in My House, first create a lookup table in PostgreSQL that contains the unique name that you are searching on, and the HTML that you need to generate an IMG tag. This table should have at least two columns- the name, which can be of whatever character type is appropriate, and the image_html, which needs to be of type varchar.

...

Code Block
languagesql
titleSyntax
UPDATE [new_table_name] SET image_html = '<img src=“MapGetImage.aspx?… 
the rest of your URL as in the table above as far as… &SearchValue='||new_field_name||'” alt=””/>';

In Studio

Create an Internal data share connection to your new lookup table. Ensure that the field you are going to be searching on is the linking field. Create a new layer (or edit an existing one) and add your new Data Share connection, using the linking field as the unique ID. Set the search type to be “Show My”, and in the available fields box, include the image_html field along with any others that you require. The appropriate ward boundary (polygon) will then be shown when you use My House.

...

  1. At a specific location - &ServiceAction=ZoomToLocation or GotoLocation
  2. With an ID form - &ServiceAction=SearchLayer
  3. Zooming to a Polygon - &ServiceAction=ZoomToPolygon

1. Using ZoomtoLocation or GotoLocation


 

URL Parameters

Explanation

http://isharemaps.bathnes.gov.uk/MapGetImage.aspx?

URL to the page that generates a map image

RequestType=Map

Always use Map

&MapHeight=400

Height of the map window in pixels

&MapWidth=400

Width or the map window in pixels

&MapSource= Banes%2fBanes

Defines the MapSource to use

&MapID=-1

Unique ID for this call – always use -1

&Easting=367320

Easting coordinate for the centre of the map

&Northing=158020

Northing coordinate for the centre of the map

&Zoom=200

Zoom Level – this is affected by the Min / Max zoom level in the MapSource

&ServiceAction=ZoomToLocation OR

&ServiceAction=GotoLocation

ServiceAction – telling iShare to simply zoom [or Go] to that location

&ZoomPin=1

Optional addition of green arrow for that location

&layersList of comma separated layer names. Note: Not display names.
 


Example output:

http://isharemaps.bathnes.gov.uk/MapGetImage.aspx?RequestType=Map&MapSource=Banes%2fBanes&MapHeight=400&MapWidth=400&mapid=-1&ServiceAction=ZoomToLocation&Easting=367320&Northing=158020&Zoom=200&ZoomPin=1


2.  Using SearchLayer

...


URL Parameters

Explanation

http://isharemaps.bathnes.gov.uk/MapGetImage.aspx?

URL to the page that generates a map image

RequestType=Map

Always use Map

&MapHeight=400

Height of the map window in pixels

&MapWidth=400

Width or the map window in pixels

&MapSource= Banes%2fBanes

Defines the MapSource to use

&MapID=-1

Unique ID for this call – always use -1

&Zoom=100

Zoom Level – this is affected by the Min / Max zoom level in the MapSource

&ServiceAction=SearchLayer

ServiceAction – telling iShare which layer to search on

&SearchLayer=Roadworks

Defines the layer on which to perform the search

&SearchField=WORKS_REF

Defines the field in the layer to search in

&SearchValue=004000018395

Details the value to search for in the search field

 

 



Example output:

http://isharemaps.bathnes.gov.uk/MapGetImage.aspx?RequestType=Map&MapSource=Banes%2fBanes&MapHeight=400&MapWidth=400&mapid=-1&ServiceAction=SearchLayer&SearchLayer=Roadworks&SearchValue=004000018395&SearchField=WORKS_REF&Zoom=1100


3. Using ZoomToPolygon

You can use this to embed a map of any boundary in (for example) My House. In order to draw a highlighted single feature, your map file needs to be prepared as shown here.

The next step is to generate the correct URL, as below:


 

URL Parameters

Explanation

http://isharemaps.bathnes.gov.uk/MapGetImage.aspx?

URL to the page that generates a map image

RequestType=Map

Always use Map

&MapHeight=400

Height of the map window in pixels

&MapWidth=400

Width or the map window in pixels

&MapSource= Banes%2fBanes

Defines the MapSource to use

&MapID=-1

Unique ID for this call – always use -1

&Zoom=100

Zoom Level – this is affected by the Min / Max zoom level in the MapSource

&ServiceAction=ZoomToPolygon

ServiceAction – telling iShare to zoom to a feature

&SearchLayer=Roadworks

Defines the layer on which to perform the search

&SearchField=WORKS_REF

Defines the field in the layer to search in

&SearchValue=004000018395

Details the value to search for in the search field

 


Example Output:

http://maps.doriconline.org.uk/MapGetImage.aspx?RequestType=Map&MapSource=DORIC/overlays&MapWidth=500&MapHeight=500&Zoom=300&mapid=-1&ServiceAction=ZoomToPolygon&SearchLayer=police_beats_filter&SearchField=Beat_Name&SearchValue=Ledsham

Embedding this map in My House

In PostgreSQL

To embed this in My House, first create a lookup table in PostgreSQL that contains the unique name that you are searching on, and the HTML that you need to generate an IMG tag. This table should have at least two columns- the name, which can be of whatever character type is appropriate, and the image_html, which needs to be of type varchar.

...

Code Block
languagesql
titleSyntax
UPDATE [new_table_name] SET image_html = '<img src=“MapGetImage.aspx?… 
the rest of your URL as in the table above as far as… &SearchValue='||new_field_name||'” alt=””/>';

In Studio

Create an Internal data share connection to your new lookup table. Ensure that the field you are going to be searching on is the linking field. Create a new layer (or edit an existing one) and add your new Data Share connection, using the linking field as the unique ID. Set the search type to be “Show My”, and in the available fields box, include the image_html field along with any others that you require. The appropriate ward boundary (polygon) will then be shown when you use My House.