Description of data feed

The 5,000 UK locations forecast site list data feed provides a list of the locations (also known as sites) for which results are available for the 5,000 UK locations three hourly forecast and 5,000 UK locations daily forecast data feeds. You can use this data feed to find details such as the ID of the site that you are interested in finding data for.

Accessing the feed via its web service

Description of web service

The mountain area forecast site list web service is used to check which locations the 5,000 UK locations three hourly forecast data feed provides data for. You should set the data format in the URL to specify whether the web service should return XML or JSON, and include your API key in the query string.

Possible use cases for this web service with example URLs

By changing the resource you can check which sites are available for each of the other web services provided by DataPoint. You should set the data format in the URL to specify that the web service should return XML or JSON as required, and include your API key in the query string.

1. You would like to know which sites are available for the 5,000 UK locations forecast web services in XML format. In this case you would set the data type to xml.

Example: to obtain sites for the forecast web services:

http://datapoint.metoffice.gov.uk/public/data/val/wxfcs/all/xml/sitelist?res=daily&key=<API key>

The above example would return around 5,000 sites in XML format, resulting in a file size of approximately 397 kB

2. You would like to know which sites are available for the 5,000 UK locations forecast web services in JSON format. In this case you would set the data type to json.

Example: to obtain sites for the forecast web services:

http://datapoint.metoffice.gov.uk/public/data/val/wxfcs/all/json/sitelist?key=<APIkey>

The above example would return around 5,000 sites in JSON format, resulting in a file size of approximately 435 kB

Example of XML and JSON responses

The following examples show a typical result of a call to the 5,000 UK locations forecast site list web service requesting a complete list of sites for which forecasts are available.

XML

The XML that follows is a representative response to a call to the following URL, with a valid key:

http://datapoint.metoffice.gov.uk/public/data/val/wxfcs/all/xml/sitelist?key=<APIkey>

JSON

The JSON that follows shows the structure of a representative response to a call to the following URL, with a valid key:

http://datapoint.metoffice.gov.uk/public/data/val/wxfcs/all/json/sitelist?key=<APIkey>