Airqualityforecast

NAME

Airqualityforecast - Forecast of air-quality for locations in Norway

DESCRIPTION

This API implements a forecast of air-quality for a location in Norway, i.e. the forecast of several parameters relevant for air-quality. Besides a general air-quality index, the main parameters for air-quality like PM10, PM2.5 and O3 are given under the /aqi-description endpoint.

A location in Norway is defined by the statistical units area-class which are a municipality (kommune), a part of a municipality (delområde) and grunnkrets, the smallest area unit for statistics in Norway. Air-quality and concentrations in the finest resolution are available as maps under https://uemep-wms.met.no.

METHODS

/

The main request for air-quality data

Parameters

reftime

reference-time of the model as returned by /reftimes, usually the newest one

lat

geographical latitude

lon

geographical longitude

areaclass

geographical areaclass for which the data is valid, one of delomrade, fylke, grunnkrets, kommune

station

model data can also retrieved at predefined measurement station-id (eio) rather than for a area-class. A list of stations can be found under https://api.met.no/weatherapi/airqualityforecast/0.1/stations . If station is given, (lat, lon, areaclass) are ignored.

show

control which data to display, currently one of all, metadata. Only relevant for search by lat/lon, not station

filter_vars

restrict output to only specified variable. List of legal values:

  • AQI
  • no2_concentration
  • o3_concentration
  • pm10_concentration
  • pm25_concentration
  • so2_concentration

Sample request URLs

  https://api.met.no/weatherapi/airqualityforecast/0.1/?lat=60&lon=10&areaclass=grunnkrets
  https://api.met.no/weatherapi/airqualityforecast/0.1/?station=NO0057A
  https://api.met.no/weatherapi/airqualityforecast/0.1/?lat=60&lon=10&areaclass=grunnkrets&show=metadata

The reftime parameter is not deterministic; you must replace it with a legal value read from /reftimes. The following URLs are for illustration only:

  https://api.met.no/weatherapi/airqualityforecast/0.1/?station=NO0057A&reftime=2024-10-06T12%3A00%3A00Z

Return structure

The return structure is defined as the #/definitions/AQLocationDataModel in the Data Model. A very short example:

    {
      "meta": {
        "reftime": "2018-09-01T00:00:00Z",
        "superlocation": {
          "longitude": 9.883918904721757,
          "name": "Drolsum og snarum",
          "path": "Buskerud/Modum/Drolsum og snarum",
          "areaclass": "delomrade",
          "latitude": 60.05512104383864,
          "areacode": "06230400"
        },
        "location": {
          "longitude": 10,
          "name": "Flattum",
          "path": "Buskerud/Modum/Drolsum og snarum/Flattum",
          "areaclass": "grunnkrets",
          "latitude": 60,
          "areacode": "06230401"
        },
        "sublocations": []
      }
      "data": {
        "time": [
          {
            "from": "2018-09-01T01:00:00Z",
            "to": "2018-09-01T02:00:00Z",
            "variables": {
              "no2_local_fraction_traffic_exhaust": {
                "units": "%",
                "value": 7
                }
                // ... many more variables
              }
              {
              "reason": {
                "variables": ["pm10_concentration", "o3_concentration"],
                "sources": ["o3_nonlocal_fraction", "pm25_local_fraction_heating", "pm10_local_fraction_traffic_exhaust"]
            }
            // ...many more times
        }
    }

/met

Get meteorological forecast for selected air-quality stations.

A request to this parameters gives a full description of all meteorological parameters with their norwegian translation, their units and data-ranges.

Note: We are currently developing a new, common JSON format for meteorological forecasts which is somewhat different from the one used here. This method is to be considered beta for the time being.

Parameters

reftime

reference-time of the model as returned by /reftimes, usually the newest one

station

forecast at location of a predefined measurement station-id (eio). A list of stations can be found under https://api.met.no/weatherapi/airqualityforecast/0.1/stations .

Sample request URLs

  https://api.met.no/weatherapi/airqualityforecast/0.1/met?station=NO0057A

/met_description

A request to this parameters gives a full description of all meteorological parameters with their norwegian translation, their units and data-ranges

Parameters

None

Request URL

    https://api.met.no/weatherapi/airqualityforecast/0.1/aqi_description

/reftimes

Air quality forecast data are updated daily and the timestamp of latest measurements used in the forecast model are used as reference-time, reftimes called in this API. All available model runs are available under:

Parameters

None

Request URL

    https://api.met.no/weatherapi/airqualityforecast/0.1/reftimes

The return structure is:

    {
      "reftimes": [
        "2018-09-03T00:00:00Z",
        "2018-09-02T00:00:00Z",
        "2018-09-01T00:00:00Z"
      ]
    }

/stations

List of all stations with data.

Parameters

None

Request URLs

    https://api.met.no/weatherapi/airqualityforecast/0.1/stations

Return structure

The return structure is defined as a list of the #/definitions/StationModel in the [Data Model]. An example:

    [
      {
        "grunnkrets": {
          "name": "Alfaset",
          "areacode": "03013701"
        },
        "height": 3,
        "eoi": "NO0057A",
        "latitude": 59.927672,
        "name": "Alnabru",
        "delomrade": {
          "name": "Alfaset",
          "areacode": "03013700"
        },
        "longitude": 10.846553,
        "kommune": {
          "name": "Oslo",
          "areacode": "0301"
        }
      }
    ]

/aqi_description

A request to this parameters gives a full description of all components together with their norwegian translation, their aqi-limits, their sources as well as their preferred scales and color palettes.

Parameters

None

Request URL

    https://api.met.no/weatherapi/airqualityforecast/0.1/aqi_description

Return structure

The return structure is defined as the #/definitions/AQIDescriptionModel in the Data Model. A short example:

    {
      "variables": {
        "pm10_concentration": {
          "nameNO": "PM10",
          "sources": [
            {
              "source": "pm10_local_fraction_traffic_nonexhaust",
              "units": "%",
              "nameNO": "veistøv"
            },
            {
              "source": "pm10_local_fraction_traffic_exhaust",
              "units": "%",
              "nameNO": "eksos"
            },
            // ... further sources
          ],
          "aqis": [
            {
              "short_description_NO": "liten helserisiko",
              "description_NO": "",
              "description_EN": "",
              "class": 1,
              "to": 50,
              "color": "#3F9F41",
              "text": "low",
              "text_NO": "lite"
            },
            {
              "short_description_NO": "moderat helserisiko",
              "description_NO": "",
              "description_EN": "",
              "class": 2,
              "from": 50,
              "to": 80,
              "color": "#FFCB00",
              "text": "medium",
              "text_NO": "moderat"
            },
            // ... further aqis
          ]
        },
        //... further componentes
      }
    }

/areas

List all available areas for a areaclass. This is a local copy of the data provided by: https://www.ssb.no/klass/klassifikasjoner/1

Parameters

areaclass

geographical areaclass for which the data is valid, one of kommune, grunnkrets, delomrade

Sample request URLs

    https://api.met.no/weatherapi/airqualityforecast/0.1/areas?areaclass=grunnkrets

Return structure

The return structure is defined as a list of the #/definitions/LocationModel in the [Data Model]. An example:

    [
      {
        "longitude": 11.538393355859073,
        "areaclass": "kommune",
        "areacode": "0101",
        "latitude": 59.07004268027018,
        "name": "Halden"
      },
      // ... more areas
    ]

schema

The schema for the request-parameters for this product is available from https://api.met.no/weatherapi/airqualityforecast/0.1/swagger.json .

Restrictions

The availability and content of this product may change without further notice.

CHANGELOG

All changes are available as an RSS feed at the following URL: https://api.met.no/weatherapi/airqualityforecast/0.1/changelog

Version 0.1: 2018-12-17

Added show=metadata parameter

Version 0.1: 2018-10-02

New product available for air quality forecasts (beta version)

 

Changelog