Table of contents:






Overall structure 

The DMI climate data API is an OGC Standard compliant service as specified in OGC API - Features - Part 1: Core.

Data is returned in a FeatureCollection that describes the returned data set. Data points are in Features - each feature type is described below.

FeatureCollection

Features are wrapped in a GeoJSON FeatureCollection, which includes:

Key

Not null

Data Type

Description

typeyesStringAlways contain FeatureCollection
timeStampyesStringTimestamp when the response was generated. In RFC3339 5.6 format.
numberReturnedyesNumberNumber of features returned
linksyesList of Link objects

Links to pages;

  • the link with rel="self" is a link to the page itself. 
  • the link with rel="next" is a link to the next page of results


Generic fields for every Feature

Key

Not null

Type

Description

id

yes

String

Internal database ID

type

yes

String

Always contain Feature

geometry.coordinates.0yesfloatlongitude
geometry.coordinates.1yesfloatlatitude

stationValue

This is a GeoJSON feature and the table below describes the returned data:

Key

Not null

Data Type

Description

properties.parameterId

yes

String

Parameter ID identifiying the parameter by a name

properties.stationId

yes

String

Station ID of the station that collected the underlying observations

properties.created

yes

String

An RFC3339 5.6 formatted string with the timestamp at which the value was created in the API. In case of duplicate station values (station values with the same station ID, from, to, parameterId and time resolution) the station value with the most recent created timestamp is the most up-to-date station value.

properties.value

yes

Number

Calculated or aggregated value

properties.fromyesStringAn  RFC3339 5.6 formatted string with the start time of the time spanned by the station value
properties.toyesStringAn  RFC3339 5.6 formatted string with the end time of the time spanned by the station value

geometry

yes

Object

Position of the observation in GeoJSON format. Derived from the stations location

properties.cloudCoverMethodnoStringOnly applicable to the "mean_cloud_cover" value of GRL data: whether the value has been observed manually or measured automatically
properties.noValuesInCalculationno Number

The number of values used to calculate the value of a station value. E.g. the number of hourly values used to calculate the corresponding daily value, or number of daily values used to calculate the corresponding monthly value.

Will not be present for station values with timeResolution=hour, because they are not based on station values of a lower resolution.

properties.qcStatusyesStringWhether a value has been quality controlled. Can assume values 'manual', when the value has been manually quality controlled by DMI's climatologists, or 'none' when no quality control has been performed (see also About Climate Data).
properties.timeResolutionyesStringThe type of timespan the station value represents. Will be one of "hour", "day", "month", "year"
properties.validityyesBooleanWhether or not the value is considered valid by the climatologists. Invalid data is generally not correct
properties.calculatedAtyesStringAn  RFC3339 5.6 formatted string with the timestamp at which the value was calculated by DMI

Station

This is a GeoJSON feature and the table below describes the returned data:

Key

Not null

Data Type

Description

properties.nameyesStringName of the station. See station list for a list of names
properties.owneryesStringOwner of the station
properties.typeyesStringStation type. See here for available types
properties.countryyesStringCountry code
properties.regionIdnoStringRegion id
properties.stationIdyesStringStation id
properties.parameterIdyesList<String>List of parameterId's as defined in Parameters schema, which the station observes
properties.statusyesStringIndicated whether the station is active or inactive
properties.wmoContryCodenoStringWMO country code
properties.wmoStationIdnoStringWMO station id
properties.createdyesStringCreation time in database (in RFC3339 5.6 format, e.g. "2020-07-10T07:59:38Z")
properties.operationTonoStringLast date the station is operational in RFC3339 5.6 format. If station is currently operational this field is null
properties.operationFromyesStringFirst date the station is operational in RFC3339 5.6 format
properties.updatednoStringLast station update in RFC3339 5.6 format. Update may be new location, changes to instrument parameters etc
properties.validTonoStringLast date the station sends valid data in RFC3339 5.6 format. For now this is the same as timeOperationEnd, but may change in future versions
properties.validFromyesStringFirst date the station sends valid data in RFC3339 5.6 format. For now this is the same as timeOperationStart, but may change in future versions
geometryyesObjectPosition of the station in GeoJSON format
properties.barometerHeightnoNumberThe barometer's height above sea level in meters
properties.stationHeightnoNumberThe station's height above sea level in meters

countryValue

This is a GeoJSON feature and the table below describes the returned data:

properties.parameterId

yes

String

Same as for stationValue - please see schema description for stationValue.

properties.created

yes

String

Same as for stationValue - please see schema description for stationValue.

properties.value

yes

Number

Same as for stationValue - please see schema description for stationValue.

properties.fromyesStringSame as for stationValue - please see schema description for stationValue.
properties.toyesStringSame as for stationValue - please see schema description for stationValue.

geometry

yes

Object

A point representing the area.

properties.qcStatusyesStringSame as for stationValue - please see schema description for stationValue.
properties.timeResolutionyesStringSame as for stationValue - please see schema description for stationValue.
properties.calculatedAtyesStringSame as for stationValue - please see schema description for stationValue.

municipalityValue

This is a GeoJSON feature and the table below describes the returned data:

properties.parameterId

yes

String

Same as for stationValue - please see schema description for stationValue.

properties.created

yes

String

Same as for stationValue - please see schema description for stationValue.

properties.value

yes

Number

Same as for stationValue - please see schema description for stationValue.

properties.fromyesStringSame as for stationValue - please see schema description for stationValue.
properties.toyesStringSame as for stationValue - please see schema description for stationValue.

geometry

yes

Object

A point representing the area.

properties.qcStatusyesStringSame as for stationValue - please see schema description for stationValue.
properties.timeResolutionyesStringSame as for stationValue - please see schema description for stationValue.
properties.calculatedAtyesStringSame as for stationValue - please see schema description for stationValue.
properties.municipalityIdyesStringId of the municipality that this value is for - see list of municipalities at https://danmarksadresser.dk/adressedata/kodelister/kommunekodeliste
properties.municipalityNameyesStringName of the municipality that this value is for - see list of municipalities at https://danmarksadresser.dk/adressedata/kodelister/kommunekodeliste

10kmGridValue

This is a GeoJSON feature and the table below describes the returned data:

properties.parameterId

yes

String

Same as for stationValue - please see schema description for stationValue.

properties.created

yes

String

Same as for stationValue - please see schema description for stationValue.

properties.value

yes

Number

Same as for stationValue - please see schema description for stationValue.

properties.fromyesStringSame as for stationValue - please see schema description for stationValue.
properties.toyesStringSame as for stationValue - please see schema description for stationValue.

geometry

yes

Object

A polygon for the covered area.

properties.qcStatusyesStringSame as for stationValue - please see schema description for stationValue.
properties.timeResolutionyesStringSame as for stationValue - please see schema description for stationValue.
properties.calculatedAtyesStringSame as for stationValue - please see schema description for stationValue.
properties.cellIdyesStringId of the grid cell. The naming follows the Danish "kvadratnet" system (https://da.wikipedia.org/wiki/Det_danske_Kvadratnet). Example: 10km_367_81.

20kmGridValue

This is a GeoJSON feature and the table below describes the returned data:

properties.parameterId

yes

String

Same as for stationValue - please see schema description for stationValue.

properties.created

yes

String

Same as for stationValue - please see schema description for stationValue.

properties.value

yes

Number

Same as for stationValue - please see schema description for stationValue.

properties.fromyesStringSame as for stationValue - please see schema description for stationValue.
properties.toyesStringSame as for stationValue - please see schema description for stationValue.

geometry

yes

Object

A polygon for the covered area.

properties.qcStatusyesStringSame as for stationValue - please see schema description for stationValue.
properties.timeResolutionyesStringSame as for stationValue - please see schema description for stationValue.
properties.calculatedAtyesStringSame as for stationValue - please see schema description for stationValue.
properties.cellIdyesStringId of the grid cell. Because there is no 20km grid cell definition in the Danish "kvadratnet" system (https://da.wikipedia.org/wiki/Det_danske_Kvadratnet) it is not defined in this system. However the naming is in the same format. Example: 20km_612_66.


  • No labels