Regional extremes observations detailed documentation

Detailed documentation on each of the data feeds associated specifically with regional extremes observations.

Here we provide detailed descriptions of the following feeds:

Regional extremes observations capabilities feed

Description of data feed

The regional extremes observation capabilities web service indicates when the regional extremes observations data feed was last updated, and the period it covers.

Accessing the feed via its web service

Description of web service

The capabilities web service returns the output of the capabilities data feed in either XML or JSON format. It is recommended that you query the capabilities web service to check whether the forecasts have been updated when querying for new data from the regional extremes observations web service rather than calling the regional extremes observations web service repeatedly, as this reduces the amount of data that has to be transferred, enhancing the user experience.

Possible use cases for this web service with example URLs

Whenever this web service is used the data category field in the URL should be set to txt, the resource category field should be set to wxobs, indicating that the capabilities web service concerns observation data, and, as is the case for all web services, you should also 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.

  1. You would like to know which timesteps are available for the regional extremes observations data feed in XML format. In this case you would set the data category to txt, the resource category to wxobs, and the data type to xml:

    Example: to obtain capabilities for the regional extremes observations data feed in XML format:

    http://datapoint.metoffice.gov.uk/public/data/txt/wxobs/ukextremes/xml/capabilities?key=<APIkey>

    The above example would return a file of approximately 1 kB in size
  2. You would like to know which timesteps are available for the regional extremes observations data feed in JSON format In this case you would set the data category to txt, the resource category to wxobs, and the data type to json:

    Example: to obtain capabilities for the regional extremes observations data feed in JSON format:

    http://datapoint.metoffice.gov.ukpublic/data/txt/wxobs/ukextremes/json/capabilities?key=<APIkey>

    The above example would return a file of approximately 1 kB in size

Example of XML and JSON responses

The following examples show a typical result of a call to the capabilities web service requesting a complete list of timesteps available from the regional extremes observations web service for a given site ID.

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/txt/wxobs/ukextremes/xml/capabilities?key=<APIkey>

<?xml version="1.0" encoding="ISO-8859-1"?>
<UkExtremes extremeDate="2012-03-06" issuedAt="2012-03-06T23:02:07Z"></UkExtremes>
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/txt/wxobs/ukextremes/json/capabilities?key=<APIkey>

{
    "UkExtremes": {
        "extremeDate": "2012-03-06",
        "issuedAt": "2012-03-06T23:02:07Z"
    }
}

Anatomy of responses

The XML and JSON responses produced by this web service are identical in terms of their high level structure and the information they represent. Each contains a single UkExtremes object (or node in XML), defined as follows:

UkExtremes

A UkExtremes object defines the capabilities for the regional extremes observations data feeds, and contains the following elements:

  • extremeDate: This describes the date of the observation
  • issuedAt: This describes the date at which the observation was issued, in ISO8601 format

Regional extremes observations data feed

Accessing the feed via its web service

Description of web service

This provides access to the observed extremes of weather across the UK for the day of issue. The data provided by the web service is updated on a daily basis.

Possible use cases for this web service with example URLs

Since this web service supplies observation data, whenever this web service is used the resource category field in the URL should be set to wxobs. You should also 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.

  1. You would like the observed extremes of weather across the UK in XML format.

    Example: to obtain forecasts for a specified location at all available times in XML format:

    http://datapoint.metoffice.gov.uk/public/data/txt/wxobs/ukextremes/xml/latest?key=<APIkey>

    The above example would return a file of approximately 9 kB in size
  2. You would like the observed extremes of weather across the UK in JSON format.

    Example: to obtain forecasts for a specified location at all available times in JSON format:

    http://datapoint.metoffice.gov.uk/public/data/txt/wxobs/ukextremes/json/latest?key=<APIkey>

    The above example would return a file of approximately 9 kB in size

Example of XML and JSON responses

The following examples show a typical result of a call to the regional extremes observations web service requesting the observed extremes of weather across the UK. The following section provides a detailed description of the structure and content of the responses.

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/txt/wxobs/ukextremes/xml/latest?key=<APIkey>

<?xml version="1.0" encoding="UTF-8"?>
<UkExtremes extremeDate="2012-03-06" issuedAt="2012-03-06T23:02:07Z">
   <Regions>
      <Region id="sw" name="South West England">
         <Extremes>
            <Extreme locId="03827" locationName="Plymouth" type="HMAXT" uom="degC">11.9</Extreme>
            <Extreme locId="99094" locationName="Okehampton" type="LMAXT" uom="degC">8.9</Extreme>
            <Extreme locId="03839" locationName="Exeter Airport" type="LMINT" uom="degC">-3.3</Extreme>
            <Extreme locId="99094" locationName="Okehampton" type="HRAIN" uom="mm">0.2</Extreme>
            <Extreme locId="03740" locationName="Lyneham" type="HSUN" uom="hours">10.0</Extreme>
         </Extremes>
      </Region>
      <Region id="uk" name="UK">
         <Extremes>
            <Extreme locId="03321" locationName="Hawarden" type="HMAXT" uom="degC">11.9</Extreme>
            <Extreme locId="03781" locationName="Kenley" type="LMAXT" uom="degC">5.4</Extreme>
            <Extreme locId="03080" locationName="Aboyne" type="LMINT" uom="degC">-6.6</Extreme>
            <Extreme locId="03132" locationName="West Freugh" type="HRAIN" uom="mm">13.6</Extreme>
            <Extreme locId="03649" locationName="Brize Norton" type="HSUN" uom="hours">10.2</Extreme>
         </Extremes>
      </Region>
      <Region id="ni" name="Northern Ireland">
         <Extremes>
            <Extreme locId="03907" locationName="Magilligan" type="HMAXT" uom="degC">11.4</Extreme>
            <Extreme locId="99121" locationName="Altnahinch Filters" type="LMAXT" uom="degC">7.8</Extreme>
            <Extreme locId="99014" locationName="Katesbridge" type="LMINT" uom="degC">-2.8</Extreme>
            <Extreme locId="03911" locationName="Lough Fea" type="HRAIN" uom="mm">4.6</Extreme>
            <Extreme locId="03907" locationName="Magilligan" type="HSUN" uom="hours">0.0</Extreme>
         </Extremes>
      </Region>
      <Region id="wl" name="Wales">
         <Extremes>
            <Extreme locId="03321" locationName="Hawarden" type="HMAXT" uom="degC">11.9</Extreme>
            <Extreme locId="03410" locationName="Lake Vyrnwy" type="LMAXT" uom="degC">7.1</Extreme>
            <Extreme locId="99170" locationName="Llysdinam" type="LMINT" uom="degC">-3.7</Extreme>
            <Extreme locId="99163" locationName="Porthmadog" type="HRAIN" uom="mm">1.0</Extreme>
            <Extreme locId="03716" locationName="St Athan" type="HSUN" uom="hours">7.5</Extreme>
         </Extremes>
      </Region>
      <Region id="se" name="London &amp; South East England">
         <Extremes>
            <Extreme locId="03874" locationName="Solent" type="HMAXT" uom="degC">11.7</Extreme>
            <Extreme locId="03781" locationName="Kenley" type="LMAXT" uom="degC">5.4</Extreme>
            <Extreme locId="03658" locationName="Benson" type="LMINT" uom="degC">-4.7</Extreme>
            <Extreme locId="03797" locationName="Manston" type="HRAIN" uom="mm">5.4</Extreme>
            <Extreme locId="03649" locationName="Brize Norton" type="HSUN" uom="hours">10.2</Extreme>
         </Extremes>
      </Region>
      <Region id="st" name="Strathclyde">
         <Extremes>
            <Extreme locId="03100" locationName="Tiree" type="HMAXT" uom="degC">9.5</Extreme>
            <Extreme locId="99024" locationName="Salsburgh" type="LMAXT" uom="degC">6.4</Extreme>
            <Extreme locId="99134" locationName="Saughall" type="LMINT" uom="degC">-2.3</Extreme>
            <Extreme locId="99006" locationName="Dunstaffnage" type="HRAIN" uom="mm">12.6</Extreme>
            <Extreme locId="03136" locationName="Prestwick" type="HSUN" uom="hours">0.9</Extreme>
         </Extremes>
      </Region>
      <Region id="ne" name="North East England">
         <Extremes>
            <Extreme locId="03238" locationName="Albemarle" type="HMAXT" uom="degC">10.2</Extreme>
            <Extreme locId="03230" locationName="Redesdale Camp" type="LMAXT" uom="degC">8.3</Extreme>
            <Extreme locId="03230" locationName="Redesdale Camp" type="LMINT" uom="degC">-5.5</Extreme>
            <Extreme locId="03238" locationName="Albemarle" type="HRAIN" uom="mm">1.4</Extreme>
            <Extreme locId="03240" locationName="Boulmer" type="HSUN" uom="hours">5.4</Extreme>
         </Extremes>
      </Region>
      <Region id="dg" name="Dumfries,Galloway,Lothian &amp; Borders">
         <Extremes>
            <Extreme locId="99180" locationName="Edinburgh Botanic Gardens" type="HMAXT" uom="degC">9.0</Extreme>
            <Extreme locId="03162" locationName="Eskdalemuir" type="LMAXT" uom="degC">7.0</Extreme>
            <Extreme locId="03162" locationName="Eskdalemuir" type="LMINT" uom="degC">-3.9</Extreme>
            <Extreme locId="03132" locationName="West Freugh" type="HRAIN" uom="mm">13.6</Extreme>
            <Extreme locId="03162" locationName="Eskdalemuir" type="HSUN" uom="hours">1.9</Extreme>
         </Extremes>
      </Region>
      <Region id="ta" name="Central Tayside &amp; Fife">
         <Extremes>
            <Extreme locId="03171" locationName="Leuchars" type="HMAXT" uom="degC">8.5</Extreme>
            <Extreme locId="99020" locationName="Tyndrum" type="LMAXT" uom="degC">7.5</Extreme>
            <Extreme locId="03171" locationName="Leuchars" type="LMINT" uom="degC">-3.4</Extreme>
            <Extreme locId="99020" locationName="Tyndrum" type="HRAIN" uom="mm">8.6</Extreme>
            <Extreme locId="03171" locationName="Leuchars" type="HSUN" uom="hours">2.2</Extreme>
         </Extremes>
      </Region>
      <Region id="gr" name="Grampian">
         <Extremes>
            <Extreme locId="03066" locationName="Kinloss" type="HMAXT" uom="degC">10.1</Extreme>
            <Extreme locId="99089" locationName="Braemar" type="LMAXT" uom="degC">5.7</Extreme>
            <Extreme locId="03080" locationName="Aboyne" type="LMINT" uom="degC">-6.6</Extreme>
            <Extreme locId="99010" locationName="Fyvie Castle" type="HRAIN" uom="mm">4.0</Extreme>
            <Extreme locId="03091" locationName="Dyce" type="HSUN" uom="hours">3.3</Extreme>
         </Extremes>
      </Region>
      <Region id="os" name="Orkney &amp; Shetland">
         <Extremes>
            <Extreme locId="03002" locationName="Baltasound" type="HMAXT" uom="degC">7.7</Extreme>
            <Extreme locId="03005" locationName="Lerwick" type="LMAXT" uom="degC">6.0</Extreme>
            <Extreme locId="03002" locationName="Baltasound" type="LMINT" uom="degC">0.2</Extreme>
            <Extreme locId="03017" locationName="Kirkwall" type="HRAIN" uom="mm">5.6</Extreme>
            <Extreme locId="03005" locationName="Lerwick" type="HSUN" uom="hours">0.2</Extreme>
         </Extremes>
      </Region>
      <Region id="em" name="East Midlands">
         <Extremes>
            <Extreme locId="03354" locationName="Nottingham" type="HMAXT" uom="degC">9.8</Extreme>
            <Extreme locId="03392" locationName="Wainfleet" type="LMAXT" uom="degC">7.1</Extreme>
            <Extreme locId="99149" locationName="Coton-In-The-Elms" type="LMINT" uom="degC">-3.6</Extreme>
            <Extreme locId="99158" locationName="Market Bosworth" type="HRAIN" uom="mm">0.2</Extreme>
            <Extreme locId="03354" locationName="Nottingham" type="HSUN" uom="hours">8.5</Extreme>
         </Extremes>
      </Region>
      <Region id="wm" name="West Midlands">
         <Extremes>
            <Extreme locId="03522" locationName="Hereford" type="HMAXT" uom="degC">11.8</Extreme>
            <Extreme locId="03330" locationName="Leek" type="LMAXT" uom="degC">7.9</Extreme>
            <Extreme locId="03529" locationName="Pershore" type="LMINT" uom="degC">-3.7</Extreme>
            <Extreme locId="99146" locationName="Astwood Bank" type="HRAIN" uom="mm">0.2</Extreme>
            <Extreme locId="03414" locationName="Shawbury" type="HSUN" uom="hours">7.6</Extreme>
         </Extremes>
      </Region>
      <Region id="nw" name="North West England">
         <Extremes>
            <Extreme locId="03316" locationName="Crosby" type="HMAXT" uom="degC">10.8</Extreme>
            <Extreme locId="03225" locationName="Shap" type="LMAXT" uom="degC">6.8</Extreme>
            <Extreme locId="03225" locationName="Shap" type="LMINT" uom="degC">-4.1</Extreme>
            <Extreme locId="03210" locationName="St Bees Head" type="HRAIN" uom="mm">3.4</Extreme>
            <Extreme locId="99187" locationName="Morecambe" type="HSUN" uom="hours">4.3</Extreme>
         </Extremes>
      </Region>
      <Region id="ee" name="East of England">
         <Extremes>
            <Extreme locId="99078" locationName="Monks Wood" type="HMAXT" uom="degC">9.8</Extreme>
            <Extreme locId="99136" locationName="Houghton Hall" type="LMAXT" uom="degC">6.1</Extreme>
            <Extreme locId="99057" locationName="Woburn" type="LMINT" uom="degC">-1.1</Extreme>
            <Extreme locId="03482" locationName="Marham" type="HRAIN" uom="mm">5.8</Extreme>
            <Extreme locId="03462" locationName="Wittering" type="HSUN" uom="hours">5.2</Extreme>
         </Extremes>
      </Region>
      <Region id="he" name="Highland &amp; Eilean Siar">
         <Extremes>
            <Extreme locId="99092" locationName="Kinlochewe" type="HMAXT" uom="degC">11.6</Extreme>
            <Extreme locId="99005" locationName="Dalwhinnie" type="LMAXT" uom="degC">6.2</Extreme>
            <Extreme locId="03063" locationName="Aviemore" type="LMINT" uom="degC">-4.4</Extreme>
            <Extreme locId="03023" locationName="South Uist" type="HRAIN" uom="mm">11.4</Extreme>
            <Extreme locId="03063" locationName="Aviemore" type="HSUN" uom="hours">0.7</Extreme>
         </Extremes>
      </Region>
      <Region id="yh" name="Yorkshire &amp; Humber">
         <Extremes>
            <Extreme locId="03257" locationName="Leeming" type="HMAXT" uom="degC">10.4</Extreme>
            <Extreme locId="99177" locationName="Pateley Bridge Ravens Nest" type="LMAXT" uom="degC">8.3</Extreme>
            <Extreme locId="03265" locationName="Topcliffe" type="LMINT" uom="degC">-5.2</Extreme>
            <Extreme locId="99116" locationName="High Mowthorpe" type="HRAIN" uom="mm">0.2</Extreme>
            <Extreme locId="03355" locationName="Church Fenton" type="HSUN" uom="hours">7.4</Extreme>
         </Extremes>
      </Region>
   </Regions>
</UkExtremes>
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/txt/wxobs/ukextremes/json/latest?key=<APIkey>

{
    "UkExtremes": {
        "extremeDate": "2012-03-06",
        "issuedAt": "2012-03-06T23:02:07Z",
        "Regions": {
            "Region": [{
                "id": "sw",
                "name": "South West England",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03827",
                        "locationName": "Plymouth",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "11.9"
                    }, {
                        "locId": "99094",
                        "locationName": "Okehampton",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "8.9"
                    }, {
                        "locId": "03839",
                        "locationName": "Exeter Airport",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-3.3"
                    }, {
                        "locId": "99094",
                        "locationName": "Okehampton",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "0.2"
                    }, {
                        "locId": "03740",
                        "locationName": "Lyneham",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "10.0"
                    }]
                }
            }, {
                "id": "uk",
                "name": "UK",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03321",
                        "locationName": "Hawarden",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "11.9"
                    }, {
                        "locId": "03781",
                        "locationName": "Kenley",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "5.4"
                    }, {
                        "locId": "03080",
                        "locationName": "Aboyne",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-6.6"
                    }, {
                        "locId": "03132",
                        "locationName": "West Freugh",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "13.6"
                    }, {
                        "locId": "03649",
                        "locationName": "Brize Norton",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "10.2"
                    }]
                }
            }, {
                "id": "ni",
                "name": "Northern Ireland",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03907",
                        "locationName": "Magilligan",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "11.4"
                    }, {
                        "locId": "99121",
                        "locationName": "Altnahinch Filters",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "7.8"
                    }, {
                        "locId": "99014",
                        "locationName": "Katesbridge",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-2.8"
                    }, {
                        "locId": "03911",
                        "locationName": "Lough Fea",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "4.6"
                    }, {
                        "locId": "03907",
                        "locationName": "Magilligan",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "0.0"
                    }]
                }
            }, {
                "id": "wl",
                "name": "Wales",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03321",
                        "locationName": "Hawarden",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "11.9"
                    }, {
                        "locId": "03410",
                        "locationName": "Lake Vyrnwy",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "7.1"
                    }, {
                        "locId": "99170",
                        "locationName": "Llysdinam",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-3.7"
                    }, {
                        "locId": "99163",
                        "locationName": "Porthmadog",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "1.0"
                    }, {
                        "locId": "03716",
                        "locationName": "St Athan",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "7.5"
                    }]
                }
            }, {
                "id": "se",
                "name": "London & South East England",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03874",
                        "locationName": "Solent",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "11.7"
                    }, {
                        "locId": "03781",
                        "locationName": "Kenley",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "5.4"
                    }, {
                        "locId": "03658",
                        "locationName": "Benson",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-4.7"
                    }, {
                        "locId": "03797",
                        "locationName": "Manston",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "5.4"
                    }, {
                        "locId": "03649",
                        "locationName": "Brize Norton",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "10.2"
                    }]
                }
            }, {
                "id": "st",
                "name": "Strathclyde",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03100",
                        "locationName": "Tiree",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "9.5"
                    }, {
                        "locId": "99024",
                        "locationName": "Salsburgh",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "6.4"
                    }, {
                        "locId": "99134",
                        "locationName": "Saughall",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-2.3"
                    }, {
                        "locId": "99006",
                        "locationName": "Dunstaffnage",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "12.6"
                    }, {
                        "locId": "03136",
                        "locationName": "Prestwick",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "0.9"
                    }]
                }
            }, {
                "id": "ne",
                "name": "North East England",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03238",
                        "locationName": "Albemarle",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "10.2"
                    }, {
                        "locId": "03230",
                        "locationName": "Redesdale Camp",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "8.3"
                    }, {
                        "locId": "03230",
                        "locationName": "Redesdale Camp",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-5.5"
                    }, {
                        "locId": "03238",
                        "locationName": "Albemarle",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "1.4"
                    }, {
                        "locId": "03240",
                        "locationName": "Boulmer",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "5.4"
                    }]
                }
            }, {
                "id": "dg",
                "name": "Dumfries,Galloway,Lothian & Borders",
                "Extremes": {
                    "Extreme": [{
                        "locId": "99180",
                        "locationName": "Edinburgh Botanic Gardens",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "9.0"
                    }, {
                        "locId": "03162",
                        "locationName": "Eskdalemuir",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "7.0"
                    }, {
                        "locId": "03162",
                        "locationName": "Eskdalemuir",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-3.9"
                    }, {
                        "locId": "03132",
                        "locationName": "West Freugh",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "13.6"
                    }, {
                        "locId": "03162",
                        "locationName": "Eskdalemuir",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "1.9"
                    }]
                }
            }, {
                "id": "ta",
                "name": "Central Tayside & Fife",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03171",
                        "locationName": "Leuchars",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "8.5"
                    }, {
                        "locId": "99020",
                        "locationName": "Tyndrum",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "7.5"
                    }, {
                        "locId": "03171",
                        "locationName": "Leuchars",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-3.4"
                    }, {
                        "locId": "99020",
                        "locationName": "Tyndrum",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "8.6"
                    }, {
                        "locId": "03171",
                        "locationName": "Leuchars",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "2.2"
                    }]
                }
            }, {
                "id": "gr",
                "name": "Grampian",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03066",
                        "locationName": "Kinloss",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "10.1"
                    }, {
                        "locId": "99089",
                        "locationName": "Braemar",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "5.7"
                    }, {
                        "locId": "03080",
                        "locationName": "Aboyne",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-6.6"
                    }, {
                        "locId": "99010",
                        "locationName": "Fyvie Castle",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "4.0"
                    }, {
                        "locId": "03091",
                        "locationName": "Dyce",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "3.3"
                    }]
                }
            }, {
                "id": "os",
                "name": "Orkney & Shetland",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03002",
                        "locationName": "Baltasound",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "7.7"
                    }, {
                        "locId": "03005",
                        "locationName": "Lerwick",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "6.0"
                    }, {
                        "locId": "03002",
                        "locationName": "Baltasound",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "0.2"
                    }, {
                        "locId": "03017",
                        "locationName": "Kirkwall",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "5.6"
                    }, {
                        "locId": "03005",
                        "locationName": "Lerwick",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "0.2"
                    }]
                }
            }, {
                "id": "em",
                "name": "East Midlands",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03354",
                        "locationName": "Nottingham",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "9.8"
                    }, {
                        "locId": "03392",
                        "locationName": "Wainfleet",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "7.1"
                    }, {
                        "locId": "99149",
                        "locationName": "Coton-In-The-Elms",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-3.6"
                    }, {
                        "locId": "99158",
                        "locationName": "Market Bosworth",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "0.2"
                    }, {
                        "locId": "03354",
                        "locationName": "Nottingham",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "8.5"
                    }]
                }
            }, {
                "id": "wm",
                "name": "West Midlands",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03522",
                        "locationName": "Hereford",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "11.8"
                    }, {
                        "locId": "03330",
                        "locationName": "Leek",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "7.9"
                    }, {
                        "locId": "03529",
                        "locationName": "Pershore",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-3.7"
                    }, {
                        "locId": "99146",
                        "locationName": "Astwood Bank",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "0.2"
                    }, {
                        "locId": "03414",
                        "locationName": "Shawbury",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "7.6"
                    }]
                }
            }, {
                "id": "nw",
                "name": "North West England",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03316",
                        "locationName": "Crosby",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "10.8"
                    }, {
                        "locId": "03225",
                        "locationName": "Shap",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "6.8"
                    }, {
                        "locId": "03225",
                        "locationName": "Shap",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-4.1"
                    }, {
                        "locId": "03210",
                        "locationName": "St Bees Head",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "3.4"
                    }, {
                        "locId": "99187",
                        "locationName": "Morecambe",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "4.3"
                    }]
                }
            }, {
                "id": "ee",
                "name": "East of England",
                "Extremes": {
                    "Extreme": [{
                        "locId": "99078",
                        "locationName": "Monks Wood",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "9.8"
                    }, {
                        "locId": "99136",
                        "locationName": "Houghton Hall",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "6.1"
                    }, {
                        "locId": "99057",
                        "locationName": "Woburn",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-1.1"
                    }, {
                        "locId": "03482",
                        "locationName": "Marham",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "5.8"
                    }, {
                        "locId": "03462",
                        "locationName": "Wittering",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "5.2"
                    }]
                }
            }, {
                "id": "he",
                "name": "Highland & Eilean Siar",
                "Extremes": {
                    "Extreme": [{
                        "locId": "99092",
                        "locationName": "Kinlochewe",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "11.6"
                    }, {
                        "locId": "99005",
                        "locationName": "Dalwhinnie",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "6.2"
                    }, {
                        "locId": "03063",
                        "locationName": "Aviemore",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-4.4"
                    }, {
                        "locId": "03023",
                        "locationName": "South Uist",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "11.4"
                    }, {
                        "locId": "03063",
                        "locationName": "Aviemore",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "0.7"
                    }]
                }
            }, {
                "id": "yh",
                "name": "Yorkshire & Humber",
                "Extremes": {
                    "Extreme": [{
                        "locId": "03257",
                        "locationName": "Leeming",
                        "type": "HMAXT",
                        "uom": "degC",
                        "$": "10.4"
                    }, {
                        "locId": "99177",
                        "locationName": "Pateley Bridge Ravens Nest",
                        "type": "LMAXT",
                        "uom": "degC",
                        "$": "8.3"
                    }, {
                        "locId": "03265",
                        "locationName": "Topcliffe",
                        "type": "LMINT",
                        "uom": "degC",
                        "$": "-5.2"
                    }, {
                        "locId": "99116",
                        "locationName": "High Mowthorpe",
                        "type": "HRAIN",
                        "uom": "mm",
                        "$": "0.2"
                    }, {
                        "locId": "03355",
                        "locationName": "Church Fenton",
                        "type": "HSUN",
                        "uom": "hours",
                        "$": "7.4"
                    }]
                }
            }]
        }
    }
}

Anatomy of responses

The XML and JSON responses produced by this web service are identical in terms of their high level structure and the information they represent. Each contains a single UkExtremes object (or node in XML), defined as follows:

UkExtremes

The UkExtremes object comprises contains the following attributes:

  • extremeDate: This describes the date of the observation
  • in page HL to anchor: This describes the date at which the observation was issued, in ISO8601 format

It also contains a single Regions element.

Regions

The Regions object comprises contains a number of Region elements.

Region

Each Region object comprises contains the following attributes:

id: This gives the short name of the region

name: This gives the full name of the region

It also contains a single Extremes element.

Extremes

Each Extremes object comprises contains a number of Extreme elements.

Extreme

The Extreme object comprises contains the following attributes:

locId: This gives the location ID of the location where the extreme was observed

locationName: This gives the full name of the location where the extreme was observed

type  This gives the type of the extreme. For example 'HMAXT' would represent the highest maximum temperature, and 'LMINT' would represent the lowest minimum temperature

uom This gives the unit of measurement for the extreme

The value of the Extreme object($ in the JSON representation) gives the value of the observed extreme, in units specified in the uom attribute.

Last Updated: 24 March 2014

Your account

Our products

Related products

Support

Need more help? Visit our support pages