observations

Get observation data from the Frost API.

This is the core resource for retrieving the actual observation data from MET Norway's data storage systems. The query parameters act as a filter; if all were left blank (not allowed in practice), one would retrieve all of the observation data in the system. Restrict the data using the query parameters. For possible input parameters see /sources, /elements, and /observations/timeseries.

get/observations/v0.{format}

Request

  • Base URL: https://frost.met.no
  • URL: https://frost.met.no/observations/v0.{format}
  • Auth: none declared

Path parameters

format'jsonld' | 'csv' required

The output format of the result. Json is fully supported, while CSV is still in Beta!

Query parameters

sourcesstring required

The ID(s) of the data sources to get observations for as a comma-separated list of Frost API station IDs: SN<int>[:<int>|all] (e.g. SN18700, SN18700:0, or SN18700:all). 0 is the main sensor and x≥1 is a parallel sensor. Retrieve the complete station lists using the <a href=api.html#/sources>sources</a> resource.

referencetimestring required

The time range to get observations for in either extended ISO-8601 format or the single word 'latest'. See <a href=concepts2.html#time_specification>Time Specifications</a> for documentation and examples.

elementsstring required

The elements to get observations for as a comma-separated list of names that follow the Frost API naming convention. Available element names can be found <a href=api.html#/elements>here</a>.

maxagestring

The maximum observation age as an ISO-8601 period, like 'P1D'. Applicable only when referencetime=latest. In general, the lower the value of maxage, the shorter the request will take to complete. The default value is 'PT3H'.

limitstring

The maximum number of observation times to be returned for each source/element combination, counting from the most recent time. Applicable only when referencetime=latest. Specify either 'all' to get all available times, or a positive integer. The default value is 1.

timeoffsetsstring

The time offsets to get observations for as a comma-separated list of ISO-8601 periods, e.g. 'PT6H,PT18H' or <a href=concepts2.html#level-offset-filter>default</a>. If left out, the output is not filtered on time offset.

timeresolutionsstring

The time resolutions to get observations for as a comma-separated list of ISO-8601 periods, e.g. 'PT6H,PT18H'. If left out, the output is not filtered on time resolution.

timeseriesidsstring

The internal time series IDs to get observations for as a comma-separated list of integers, e.g. '0,1'. The default value is 0.

performancecategoriesstring

The performance categories to get observations for as a comma-separated list of letters, e.g. 'A,C'. Enter a comma-separated list to specify multiple performance categories. If left out, the output is not filtered on performance category.

exposurecategoriesstring

The exposure categories to get observations for as a comma-separated list of integers, e.g. '1,2'. If left out, the output is not filtered on exposure category.

qualitiesstring

The qualities to get observations for as a comma-separated list of integers, e.g. '1,2'. See <a href="https://frost.met.no/api.html#/observations/availableQualityCodes"> available qualities and their meaning. </a> If left out, the output is not filtered by quality.

levelsstring

The sensor levels to get observations for as a comma-separated list of numbers, e.g. '0.1,2,10,20' or <a href=concepts2.html#level-offset-filter>default</a>. If left out, the output is not filtered on sensor level.

includeextrastring

If this query parameter is set to 1 and extra data is available, this data is included in the response. Extra data currently consists of the original observation value and the 16-character control info.

fieldsstring

Fields to include in the output as a comma-separated list. If specified, only these fields are included in the output. If left out, all fields are included.

Response

successful operation

Changes

No recorded changes to this operation across all 1 revision of this API.