Maps


Simple maps of sites.

Query Index:


Maps of specific sites

A minimal query specifies a single site by siteID. The map bounds are calculated to suit the selected site and keep New Zealand in the map. The site is marked with a red triangle with the site at the center. Width defaults to 130 and the height is calculated from the map bounds and width. If the map is included in a page using an object tag (and viewed using a recent web browser) then when the site marker is moused over a label for the site is briefly displayed. If the image is included in an img tag the mouse over functionality is not available.



<object data="http://fits.geonet.org.nz/map/site?siteID=GISB" type="image/svg+xml"></object>

Multiple sites can be specified with the sites query parameter. The map bounds are calculated from the sites and maps wrap the 180 meridian.



<object data="http://fits.geonet.org.nz/map/site?sites=GISB,CHTI,RAUL" type="image/svg+xml"></object>



<object data="http://fits.geonet.org.nz/map/site?sites=GISB,CHTI,FALE" type="image/svg+xml"></object>



<object data="http://fits.geonet.org.nz/map/site?sites=GISB,CHTI,FALE,SCTB" type="image/svg+xml"></object>

The size of the map can be changed with the width parameter. The map bounds can be controlled with the bbox query parameter either by specifiying the lower left and upper right corners or by using one of the named map bounds. Zoomed in maps have higher resolution map data. When width allows the full site name is included in the label.


<object data="http://fits.geonet.org.nz/map/site?sites=RAUL&width=500&bbox=RaoulIsland" type="image/svg+xml"></object>


Map data are assembled from a number of sources:

NZTopo data is licensed by LINZ for re-use under the Creative Commons Attribution 3.0 New Zealand licence.

Method: GET
URI
/map/site?siteID=(string)|&sites=(siteID,...))[&bbox=(float,float,float,float)|string][&width=(int)]
Accept

Query Parameters

Optional:
bbox
If bbox is not specified is it calculated from the sites. The bounding box for the map defining the lower left and upper right longitude latitude (EPSG:4327) corners e.g., 165,-48,179,-34. Latitude must be in the range -85 to 85. Maps can be 180 centric and bbox definitions for longitude can be -180 to 180 or 0 to 360 e.g., both these bbox include New Zealand and the Chatham islands; 165,-48,-175,-34 165,-48,185,-34. The following named bbox are available as well. Use the name as the bbox arguement e.g., bbox=WhiteIsland;
  • ChathamIsland
  • LakeTaupo
  • NewZealand
  • NewZealandRegion
  • RaoulIsland
  • WhiteIsland
insetBbox
If specified then is used to draw a small inset map in the upper left corner. Useful for giving context to zoomed in regions. Same specification options as bbox.
siteID
Site identifier e.g., WI000.
sites
A comma separated list of sites specified by siteID e.g., GISB,TAUP.
width
Default 130. The width of the returned image in px.

Response Properties


Maps of sites filtered by observation type, method, and location.

Maps of site type have the same width and bbox query parameters as maps for individual sites. The type of site displayed can be filtered by typeID, methodID, and within.



<object data="http://fits.geonet.org.nz/map/site?typeID=u&width=500&bbox=NewZealand" type="image/svg+xml"></object>




<object data="http://fits.geonet.org.nz/map/site?typeID=z&width=500&bbox=LakeTaupo&insetBbox=NewZealand" type="image/svg+xml"></object>



<object data="http://fits.geonet.org.nz/map/site?typeID=SO2-flux-a&methodID=mdoas-m" type="image/svg+xml"></object>



<object data="http://fits.geonet.org.nz/map/site?typeID=t&width=500&bbox=WhiteIsland&insetBbox=NewZealand" type="image/svg+xml"></object>



<object data="http://fits.geonet.org.nz/map/site?typeID=t&methodID=thermcoup&bbox=177.185,-37.531,177.197,-37.52&width=400&within=POLYGON((177.18+-37.52,177.19+-37.52,177.20+-37.53,177.18+-37.52))" type="image/svg+xml"></object>

Method: GET
URI
/map/site?[typeID=(typeID)]&[methodID=(methodID)]&[within=POLYGON((...))][&bbox=(float,float,float,float)|string][&width=(int)]
Accept

Query Parameters

Optional:
bbox
If bbox is not specified is it calculated from the sites. The bounding box for the map defining the lower left and upper right longitude latitude (EPSG:4327) corners e.g., 165,-48,179,-34. Latitude must be in the range -85 to 85. Maps can be 180 centric and bbox definitions for longitude can be -180 to 180 or 0 to 360 e.g., both these bbox include New Zealand and the Chatham islands; 165,-48,-175,-34 165,-48,185,-34. The following named bbox are available as well. Use the name as the bbox arguement e.g., bbox=WhiteIsland;
  • ChathamIsland
  • LakeTaupo
  • NewZealand
  • NewZealandRegion
  • RaoulIsland
  • WhiteIsland
insetBbox
If specified then is used to draw a small inset map in the upper left corner. Useful for giving context to zoomed in regions. Same specification options as bbox.
methodID
A valid method identifier for observation type e.g., doas-s. typeID must be specified as well.
typeID
A type identifier for observations e.g., e.
width
Default 130. The width of the returned image in px.
within
Only return sites that fall within the polygon (uses ST_Within). The polygon is defined in WKT format (WGS84). The polygon must be topologically closed. Spaces can be replaced with + or URL encoded as %20 e.g., POLYGON((177.18+-37.52,177.19+-37.52,177.20+-37.53,177.18+-37.52)).

Response Properties