Introduction

This web page provides information on how to access Landcare Research's Web Map Services.

These services have been established and are operated by the Informatics team at Landcare Research New Zealand Limited. We intend to make additional Web Map Services available in the future. The services provide access to a topographic base map of New Zealand (shown in a dynamic OpenLayers map to the right), a landcover relief base map of New Zealand which uses ECOSAT Landcover data, layers from the New Zealand Land Resource Inventory (NZLRI), layers from the Land Cover Database (LCDB) (all versions) and a layer from the Fundamental Soil Layer (FSL) New Zealand Soil Classification (NZSC). The NZLRI is a national database of physical land resource information. You can find out more about the NZLRI on the LRIS portal. The LCDB is a thematic classification of land cover and land use classes. The current version LCDB v3 contains 33 classes designed to be compatible with earlier LCDB versions. You can download the data about the LCDB dataset on the LRIS portal, and can find out more at the LCDB website. Developed in the 1980s, the NZSC is split into four levels of soil classification - orders, groups, subgroups and soilforms. Further information can be found at Landcare Research's Soil Portal.

Currently our Web Map Services are provided in several forms, which fall into two groups: Uncached maps that are rendered on the fly, and a more restrictive but generally quicker to render, set of cached map tiles.

The uncached services can be accessed through the OpenGIS® Web Map Service Interface Standard (WMS) (Versions 1.1.1 & 1.3.0). The OpenGIS® Web Map Service Interface Standard (WMS) provides a simple HTTP interface for requesting geo-registered map images from one or more distributed geospatial databases. A WMS request defines the geographic layer(s) and area of interest to be processed. The response to the request is one or more geo-registered map images (returned as JPEG, PNG, etc) that can be displayed in a browser application. We have implemented WMS using MapServer. For details of using WMS version 1.3.0, check out a description and example requests here and the OpenLayers section on the Using Services page.

The pre-cached map tiles can be accessed using one of the supported tile service protocols. Perhaps the easiest way is using the commonly used standard OpenGIS Web Map Service Version 1.1.1 requests. OpenGIS Web Map Tile Service (WMTS) is also supported. WMTS is an official OGC standard for delivering tiled geographic data. This service follows the standard OGC WMTS requests and supports both the classical OGC style KVP encoded and REST style requests. In addition, our layers are accessible using the GoogleMaps XYZ Service, or the Tile Map Service (TMS). TMS is a specification for storing and retrieving geographic data, developed by the Open Source Geospatial Foundation, however it is not an official standard.

We have implemented our cached services using Mapserver's Mapcache. Use our cached services if performance, specifically the time it takes to draw the map, is a key requirement.

Web Feature Services (WFS) are available for some of Landcare Research’s data through the 'Services' tab of the respective layers in the LRIS portal.



The Legal Stuff (back to top)

Terms of Use of the Content

Landcare Research has compiled the maps we make available through these services from information derived from a variety of sources. The information may not be complete, correct or up to date.  Landcare does not accept responsibility for any actions taken in reliance on it or consequences arising from the use of it.

The web services use data for the basemap layers sourced from the Land Information New Zealand.s NZTopo Database and Landcare Research's own in-house datasets. Do not use the maps for navigation purposes or any application which potentially lives might depend on.

Creative Commons Licence (BY) The science information provided by this service is licensed under Creative Commons CC-BY New Zealand license.

If you use the web services and publish the spatial information to the public without adapting it, the following attribution to Landcare Research should be used in your work/product/application:

Source: Landcare Research and licensed by Landcare Research for re-use under Creative Commons CC-BY New Zealand license.

Amongst other things, the licence provides that:

  • Except as required by law or as otherwise agreed in writing between us, the maps are licensed by Landcare Research on an "as is" and "as available" basis and without any warranty of any kind, either express or implied.
  • Subject to any liability which may not be excluded or limited by law Landcare Research shall not be liable on any legal basis (including without limitation negligence) and expressly excludes all liability for loss or damage howsoever and whenever caused to you.

Any maps you request from our web services MUST display the relevant copyright and license statement. For the science data layers the following should be used:

© Landcare Research 2014 CC-BY NZ License

Basemap layers should include the following:

© Landcare Research 2014. Contains data sourced from LINZ. Crown Copyright Reserved.

A copyright layer is available from the WMS's which you can overlay on the map you request (see using the copyright layer with OpenLayers for more information).

Terms of Use of the Site and the Web Services

By using this site and the web services provided you agree, and are deemed, to be bound by the following Terms. If you choose not to be bound by the following Terms, then Landcare Research does not grant you the right to use this site and its services.

  1. Landcare Research may vary these Terms at any time. Amendments will be effective immediately upon posting of the amended Terms of Use on this website and by continuing to use the site and its services after the Terms have been varied you agree, and are deemed, to be bound by the variation.
  2. You are responsible for ensuring you are familiar with the latest Terms of Use, which were last updated on 18th April 2012.
  3. You agree that you will not attempt to alter the web services nor employ any robot, spider, or other device or process or means whatever to use this site and the services for any unauthorised purposes. You agree not to:
  • make excessive traffic demands of the site and web services;
  • deliver viruses or forward any other system which is of a destructive nature or capable of so being whether alone or in combination;
  • otherwise engage in any other behaviour that may be reasonably expected to inhibit other users from using and enjoying the web services; or
  • damage or destroy the reputation of Landcare Research.
  1. You acknowledge that Landcare Research may terminate, suspend or restrict your access to the web services at any time at its absolute discretion.
  2. You also acknowledge that Landcare Research may suspend the operation of the services for repair or maintenance work or in order to update the contents or functionality of the website and the web services.
  3. You accept that access to or use of the site and web services will not necessarily be uninterrupted or error free.
  4. Landcare Research reserves the right to modify or terminate the web services for any reason without notice at any time.
  5. Where possible we will make an announcement on this web page of any proposed changes to the web services, interruptions to the services or termination of the services.


About The Services (back to top)

The sections below describe the key aspects of our services, including supported protocols and standards. Each section contains a link to the relevant capabilities document, the URL used for a getCapabilities request, and example GetMap & GetLegendGraphic requests. Tables are provided which are dynamically populated by a getCapabilities request and summarises what layers are currently available. Each row in the table is clickable, and clicking on the row should open a preview map of the layer selected.

These services are being run from the Amazon Cloud using a MapServer and Mapserver's Mapcache on top of a PostgreSQL / PostGIS database. Projections currently supported are NZTM, NZGD49, WGS84 and Google's Spherical Mercator.

OGC WMS

Our services support both version 1.1.1 & 1.3.0 of the OpenGIS® Web Map Service Interface Standard (WMS). The OpenGIS® WMS Interface Standard is the most widely used standard for generating maps on the web and provides a simple HTTP interface for requesting geo-registered map images from one or more distributed geospatial databases.

The major differences between WMS versions 1.1.1 & 1.3.0 are:

  • In 1.1.1 geographic coordinate systems specified with the EPSG namespace are defined to have an axis ordering of longitude/latitude. In 1.3.0 (for certain Coordinate Reference Systems, e.g. EPSG:4326) the ordering is latitude/longitude.
  • The 'srs' parameter in the GetMap operation is called 'crs' in 1.3.0.

For example, the version 1.1.1 request:


using version 1.3.0 would become:


Note the changes of VERSION to '1.3.0', 'SRS' paramater to 'CRS' and BBOX coordinate order reversed.

Landcare Research's NZ Topographic Basemaps

This WMS is for Landcare Research's Topographic Basemaps, operated as part of the SCENZ-Grid project. The data contained includes the terrain, hydrography, transport infrastructure, settlements, coastline and coastal features of New Zealand.

Basemap Layers Available (*Click on a layer to view a preview map*)


GetCapabilities

URL :http://maps.scinfo.org.nz/basemaps/wms?version=1.1.1&service=WMS&request=GetCapabilities


Example GetMap request:


Landcare Research's Land Resource Inventory

This is a WMS for Landcare Research's Land Resource Inventory, operated as part of the SCENZ-Grid project. The data is sourced from Landcare Research's New Zealand Resource Inventory (NZLRI), a single spatial (polygon) layer with national coverage. It comprises several physical resource themes: Land Use capability, Lithology, Soil, etc.

The raw data can be downloaded from the LRIS Portal. In addition, Web Feature Services (WFS) are available through the 'Services' tab of the NZLRI layers in the LRIS Portal.

LRI Layers Available (*Click on a layer to view a preview map*)


GetCapabilities

URL: http://maps.scinfo.org.nz/lri/wms?version=1.1.1&service=WMS&request=GetCapabilities


Example GetMap request:

Legends/keys for our science layers should display in the preview map window next to the map, alternatively, they can all be viewed here. Dynamic legends can be accessed via the GetLegendGraphic request, see below for an example.

Example GetLegendGraphic request:

http://maps.scinfo.org.nz/lri/wms?SERVICE=WMS&VERSION=1.1.1&REQUEST=GetLegendGraphic&LAYER=lri_luc_main&FORMAT=png8


New Zealand Land Cover Database(s)

This is a WMS for the New Zealand Land Cover Database(s), operated and maintained by Landcare Research. The data is sourced from the Land Cover Database (LCDB), a thematic classification of land cover and land use classes. The current version, LCDB v3, contains 33 classes designed to be compatible with earlier LCDB versions. You can download the data at the LRIS portal, use the WFS via the 'services' tab or obtain more in depth information from the LCDB website.

LCDB Layers Available (*Click on a layer to view a preview map*)


GetCapabilities

URL: http://maps.scinfo.org.nz/lcdb/wms?version=1.1.1&service=WMS&request=GetCapabilities


Example GetMap request:

Legends/keys for our science layers should display in the preview map window next to the map, alternatively, they can all be viewed here. Dynamic legends can be accessed via the GetLegendGraphic request, see below for an example.

Example GetLegendGraphic request:

http://maps.scinfo.org.nz/lcdb/wms?SERVICE=WMS&VERSION=1.1.1&REQUEST=GetLegendGraphic&LAYER=lcdb_lcdb3&FORMAT=png8


Fundamental Soil Layer - New Zealand Soil Classification

This is a WMS for the Fundamental Soil Layer (FSL) - New Zealand Soil Classification (NZSC), operated and maintained by Landcare Research. The NZSC was developed in the 1980s and consists of four levels: orders, groups, subgroups and soilforms. Currently only the soil groups level is provided. The classification represents the best attempt to classify New Zealand soils, at our current state of knowledge. You can download the data at the LRIS portal, use the WFS via the 'services' tab or obtain more in depth information from the Soils Portal.

FSL Layers Available (*Click on a layer to view a preview map*)


GetCapabilities

URL: http://maps.scinfo.org.nz/fsl/wms?version=1.1.1&service=WMS&request=GetCapabilities


Example GetMap request:

Legends/keys for our science layers should display in the preview map window next to the map, alternatively, they can all be viewed here. Dynamic legends can be accessed via the GetLegendGraphic request, see below for an example.

Example GetLegendGraphic request:

http://maps.scinfo.org.nz/fsl/wms?SERVICE=WMS&VERSION=1.1.1&REQUEST=GetLegendGraphic&LAYER=fsl_nzsc_groups&FORMAT=png8


Cached Tile Services

Using one of the supported tile service protocols allows our maps to be accessed faster, and reduces server load. We currently support the following tile service protocols:

Unlike our WMS, which are accessed via either 'maps.scinfo.org.nz/basemaps/wms', 'maps.scinfo.org.nz/lri/wms' or 'maps.scinfo.org.nz/lcdb/wms', all our cached maps are accessed through 'maps.scinfo.org.nz/cached/'. This means a getCapabilities request to the cached service will return information relating to *all* layers available.

Projections

Currently NZTM, WGS84 & Spherical Mercator are fully supported across all layers.

Available Cached Layers

The tables below summarise the layers that are available through our cached service. The tables are dynamically populated via a (filtered) getCapabilities request, and each row in the table is clickable. Clicking on a row should open a preview map of the layer selected. Although our cached service has a single endpoint ('maps.scinfo.org.nz/cached/'), and therefore all layers use the same base URL (dependent on protocol), these tables have been organised in a similar way to our straight WMS tables. A getCapabilities request to our cached service will return all available layers, examples of which can be found above. Below each table is an example getMap request, which relates to one of the layers in each table.

Cached Topographic Basemap Layers Available (*Click on a layer to view a preview map*)



Example GetMap request:


Cached LRI Layers Available (*Click on a layer to view a preview map*)


Example GetMap request:


Cached LCDB Layers Available (*Click on a layer to view a preview map*)


Example GetMap request:


Cached FSL Layers Available (*Click on a layer to view a preview map*)


Example GetMap request:

To find out how to use our services in Openlayers or desktop GIS like Quantum GIS and uDig click here.



Known Issues (back to top)

In attempting to provide useful and usable operational web map services we have encountered a number of issues.

  1. When viewing tiles from the cached service in desktop GIS applications, the best results are achieved using one of the recommended scales (see using services for more information).
  2. GetFeatureInfo requests are not currently supported by the WMS services.
  3. GetLegendGraphic requests are supported. To view these legends and their corresponding requests click here, alternatively click on a record in one of the tables.
  4. The Capabilities document, provided in response to the GetCapabilities request to the cached service, is limited in the amount of metadata provided about the layers.


Further Information (back to top)

If you have any enquiries about the information or services provided, please contact us: lris_support@landcareresearch.co.nz

We also provide an OGC CSW (Catalog Services for the Web) which can be used to discovery information on spatial data sets held by Landcare Research. More information on the CSW service can be found here.

Web Feature Services (WFS) are available for some of Landcare Research’s data through the 'Services' tab of the respective layers in the LRIS Portal.

The web services provided here are one element of scinfo.org.nz, a new repository of authoritative New Zealand science datasets and information. It is has been created in response to a growing expectation that government and publicly funded science data should be readily available in authoritative human and machine readable forms.

scinfo.org.nz is hosted by the Informatics Team at Landcare Research. We are a team of 30 data researchers, software developers and system engineers with deep experience in managing specialist science data resources and using them for our research and to support natural resource policy and management. We have particular specialist knowledge of geospatial datasets, satellite image analysis, taxonomic data, laboratory data and web services.

Last updated: 30th January 2014