Environmental Data Explorer Webservices

If you want to use one of these services, please contact the Environmental Data Explorer team (see email/contact form at the bottom) to request permission. Thank you.




REST/JSON Services:

Check out this REST/JSON webservice list for all available services.
Display All Countries in Short Form

http://geodata.grid.unep.ch

Get all country names with region and subregion names, ISO 2 and ISO 3 and UN codes.
Get Variable for a Country

http://geodata.grid.unep.ch/api/countries/DE/variables/1

Display all data for a specific variable for a specific country (ISO-2 Code)

Parameters:
  ISO-2 of the country (for example DE or TZ)
  ID of the Variable (for example 1 or 1213)
Get Values for a Country and Year

http://geodata.grid.unep.ch/api/countries/DE/variables/1/years/2000:2003

Display all data for a specific variable for a specific country (ISO-2 Code) for specific years (these can be indicated as a single year ("2008") or as a timestamp ("1990:2000"))

Parameters:
  ISO-2 of the country (for example DE or TZ)
  ID of the Variable (for example 1 or 1213)
  Year range of the Variable (for example 1980:2010)
Get Variables

http://geodata.grid.unep.ch/api/variables

Display all (national statistics) variables in short form
Search with a Specific Keyword for Variables

http://geodata.grid.unep.ch/api/variables/find/co2

Search with a specific keyword for variables

Parameters:
  Keyword (for example CO2 or water)
Display Metadata

http://geodata.grid.unep.ch/api/variables/1

Display a specific (national statistics) variable in long form

Parameters:
  ID of the Variable (for example 1 or 1213)
Dynamic Graph Generation

Use the JSON-API in order to fill a graph.


SOAP Services:

Keyword Search



WSDL, RetrieveMetadataInformation

This service is an example for a keyword search of the Environmental Data Explorer, that is: Entering a keyword and selecting a variable. One can restict the search to a specific UNEP Priority Area.
Parameters:
  Keyword (for example "water" or "population"); mandatory
  UNEP Priority Area (for example "climate change"); not mandatory
Get Metadata



WSDL, DataSetSearch

This service enables a search for metadata information, such as variable definition, units, abstract, source etc. for a given ID.
Parameters:
  ID of the Variable (for example 1 or 1213); mandatory
Display Values



WSDL, DataSearch
Example SOAP Request

This web service returns what is normally displayed on the "table"-page of the Environmental Data Explorer: the national statisitcs.
Parameters:
  ID of the Variable (for example 1 or 1213); mandatory
  GEO-Region, if one wants to display only countries for a specific region; not mandatory
  Country, if one wants to display only a specific country; accepts GEO-ID, ISO-2 or ISO-3; not mandatory
Retrieve Country Names List



WSDL, RetrieveCountryName

Retrieve the list of country names plus GEO-ID, ISO-2 and ISO-3 codes, and coordinates (west, south, east north).
Retrieve Country Values



WSDL, RetrieveCountryValues

Retrieve data values from all existing tables for a specific country.
Country Specifics



Display some basic information about the country, name, sovereign etc.

URL: geodata_country_name_ws.php?wsdl
Parameters: id_geo, language

Request Updated Variables



Receive update variables, that is the data values for those variables/datasets which have been added or updated since a given date.

URL: geodata_data_update_ws?wsdl
Parameters: date, region



WMS / WFS Services:

WMS - GetMap



The WMS-GetMap command to retrieve a map, indicating specific layers.

via Geoserver
for example: WMS - GetMap
WMS - GetLegend
WFS - GetMap



The WFS-GetMap command to retrieve a map, indicating specific layers.

via Geoserver