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=grunnkretshttps://api.met.no./weatherapi/airqualityforecast/0.1/?station=NO0057Ahttps://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-11-20T12%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)