IUCN Spatial Web Services

At present there are three web data services. The services can be found in the service directory at the url below.

http://mapservices.iucnredlist.org/arcgis/rest/services/IUCN_Spatial_API

Rest Service Description SpeciesRange_WM_API - All range projected to Web mercator (including extinct ranges) SpeciesRange_WM_API_Extinct_Excluded - Species Ranges projected to Web Mercator (excluding extinct and possibly extinct ranges) SpeciesRange_WGS_API - Species ranges in WGS 84 geographic coordinate system

The services also include a non-spatial table called ’species’. This table can be queried to find the extent of a species range or check if a species range exists or not. It is important to note that the range extents are calculated using the web mercator projection. See examples below.

Spatial API Login and Token Authentication

The Spatial API web services are secured and need to be accessed using login credentials. For the services to be called from an application a token will also need to be provided.It’s a token specially for the Spatial API. This token can be provided by the Red List GIS team on request (RedListGIS@iucn.org).

We will need your HTTP Referer to generate the token i.e. the website URL on which you will be using the web services.

more info on using tokens

Incorporating maps into your website

All of the maps that are shown in the examples are available to embed within your own website in accordance with the terms and conditions set out below. The technology that is used to publish the maps is ESRI’s ArcGIS Server technology and the maps are published in two different formats: ESRI Map Services and Open Geospatial Consortium (OGC) Web Standards.

These map services can be incorporated into websites using a wide range of technologies including a number of free API’s that are produced by ESRI. These ArcGIS Server Web APIS are fully documented here: http://resources.arcgis.com/content/arcgisserver/web-apis. You have a choice of the technology that you use (Javascript, Flex or Silverlight) and a choice of the background maps data (Google Maps API, ESRI ArcGIS Online Content or Microsoft Bing Maps). The OGC Standards are Web Mapping Services (WMS) and Web Feature Services (WFS). WMS services are images that are transferred to the client and WFS services are streams of data which contain the attributes and the geometries of any features. These OGS services can be consumed using a number of different web technologies, including OpenLayers (see here for more information).

For the ESRI ArcGIS Server Web APIs, the main method for including maps into you own websites is to use one of the API’s and to reference it in your own website. You can then add any of the services that are available from the REST Services Directory published at the following address:http://mapservices.iucnredlist.org/arcgis/rest/services/IUCN_Spatial_API These REST map services are described in the relevant REST Map Service.

Examples

 Below are some samples of the API using the ArcGIS API for JavaScript. View the source of the pages to understand how the API works

http://mapservices.iucnredlist.org/iucn_spatial_api/demo_js.html

http://mapservices.iucnredlist.org/iucn_spatial_api/demo_zoom_js.html

http://mapservices.iucnredlist.org/iucn_spatial_api/demo_zoom_extinct_excluded_js.html

http://mapservices.iucnredlist.org/iucn_spatial_api/demo_species_check_js.html

Incorporating non-spatial data

Non-spatial data can be returned from the ArcGIS Server REST services using a number of different operations. The Query operation allows you to query the data in the services directory and the Identify operation allows you to retrieve matching features within a particular geometry.

For example, the following query returns the species BINOMIAL with the ID_NO of 8543:

http://mapservices.iucnredlist.org/arcgis/rest/services/IUCN_Spatial_API/SpeciesRange_WM_API/MapServer/0/query?where=ID_NO=8543&returnGeometry=false&outFields=*&f=html 

This can be used with a QueryTask class to retrieve the data in a web page. See ArcGIS Server Javascript Web API - QueryTask Class.

Terms and Conditions of Use

Please view the terms of use on the Red List website

The use of the mapping and data services is on acceptance of the following use conditions: