Radar Data API
Click here for Swagger - Interactive API explorer
To execute calls the service input your api-key by clicking the "Authorize" button in Swagger
Quick start examples:
Example: https://dmigw.govcloud.dk/v1/radardata/collections/composite/items?api-key=<api-key> (external site)
Description: Will return up to 1000 (the default limit) composite radar scans
Example: https://dmigw.govcloud.dk/v1/radardata/collections/volume/items?api-key=<api-key> (external site)
Description: Will return up to 1000 (the default limit) volume radar scans
The collection endpoints support a number of query parameters to filter or sort data. Make sure to read the query primer to make use of the below query parameters
Example Response
{
"type": "FeatureCollection",
"features": [
{
"stac_version": "1.0.0",
"bbox": [
4.379082700525593,
52.29427206432812,
20.735140174892805,
59.827708427801085
],
"geometry": {
"coordinates": [
[
[
4.379082700525593,
52.29427206432812
],
[
20.735140174892805,
52.29427206432812
],
[
20.735140174892805,
59.827708427801085
],
[
4.379082700525593,
59.827708427801085
],
[
4.379082700525593,
52.29427206432812
]
]
],
"type": "Polygon"
},
"collection": "composite",
"id": "dk.com.202310260915.500_max.h5",
"asset": {
"data": {
"href": "https://dmigw.govcloud.dk/v1/radardata/download/dk.com.202310260915.500_max.h5",
"title": "Radar file download resource",
"type": "application/x-hdf5",
"roles": [
"data"
]
}
},
"type": "Feature",
"properties": {
"created": "2023-10-26T09:27:09.383Z",
"datetime": "2023-10-26T09:15:00Z",
"scanType": "doppler"
}
}
],
"timeStamp": "2023-10-26T09:28:49Z",
"numberReturned": 1,
"links": [
{
"href": "https://dmigw.govcloud.dk/v1/radardata/collections/composite/items?sortorder=datetime,DESC&limit=1",
"rel": "self",
"type": "application/geo+json",
"title": "This document"
},
{
"href": "https://dmigw.govcloud.dk/v1/radardata/collections/composite/items?sortorder=datetime,DESC&limit=1&offset=1",
"rel": "next",
"type": "application/geo+json",
"title": "Next set of results"
}
]
}
API
/collections
Example: https://dmigw.govcloud.dk/v1/radardata/collections (external site).
Description: Will return all available collections in the API. Available collections:
- /v1/radardata/collections/composite (collection name: composite)
- /v1/radardata/collections/pseudoCappi (collection name: pseudoCappi)
- /v1/radardata/collections/volume (collection name: volume)
for composite, pseudo CAPPI and volume files respectively
/collections/<collection name>/items
Query parameters:
Query example
Example:
Returns radarfiles from station 06194 after 6. of august 2021 in a bbox covering Denmark in the CRS84 coordinate system in descending datetime order, with 0 offset and with only up to 10 occurences
/download/<filename>
Link to the file can be found by querying using the /collections/<collection name>/items documented above. Link will be in the asset section of the features.
Example:
Downloads the file. File is in HDF5 file format.
Response schema
Overall Structure
The API is a STAC API - Features service and follows this standard as documented here: https://api.stacspec.org/v1.0.0-beta.4/core/ (external site)
Data is returned in a FeatureCollection object that describes the returned data set. Data points are found in the features field which contains a number of Feature objects as described below.
FeatureCollection
Features are wrapped in a STAC Item FeatureCollection (external site) object, which includes:
Generic fields for every Feature object
These are STAC Items, as described by STAC Item Specification (external site) and the table below describes the returned data:
(Note that a STAC Item can be seen as an augmented GeoJson feature (external site))
