Lightning Data API
Click here for Swagger - Interactive API explorer (external site)
To execute calls the service input your api-key by clicking the "Authorize" button in Swagger
Quick start examples:
Example: https://dmigw.govcloud.dk/v2/lightningdata/collections/observation/items?api-key=<api-key>
Description: Will return up to 1000 (the default limit) lightning triangulations
Example: https://dmigw.govcloud.dk/v2/lightningdata/collections/station/items?api-key=<api-key>
Description: Will return up to 1000 (the default limit) stations
Example: https://dmigw.govcloud.dk/v2/lightningdata/collections/sensordata/items?api-key=<api-key>
Description: Will return up to 1000 (the default limit) sensor observations
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": [
{
"geometry": {
"coordinates": [
-0.0195,
51.764
],
"type": "Point"
},
"id": "gcpyrx16261112394200001-39",
"type": "Feature",
"properties": {
"amp": -3.9,
"created": "2022-03-29T07:39:11.126140Z",
"observed": "2021-07-12T17:33:59.420000Z",
"sensors": "1,20,21,42,60",
"strokes": 1.0,
"type": 0.0
}
}
],
"timeStamp": "2023-10-26T09:26:30Z",
"numberReturned": 1,
"links": [
{
"href": "https://dmigw.govcloud.dk/v2/lightningdata/collections/observation/items?limit=1",
"rel": "self",
"type": "application/geo+json",
"title": "This document"
},
{
"href": "https://dmigw.govcloud.dk/v2/lightningdata/collections/observation/items?limit=1&offset=1",
"rel": "next",
"type": "application/geo+json",
"title": "Next set of results"
}
]
}
API
/collections
Example: https://dmigw.govcloud.dk/v2/lightningdata/collections
Description: Will return all available collections in the API. Available collections:
- station
- observation
- sensordata
/collections/<collection name>/items
Query parameters:
Query examples
Examples:
Returns observations within the dates UTC 2018-02-12 at midnight and UTC 2018-03-18 at midnight (both dates are inclusive), and within the bounding box having the Southwesterly point of 7.0, 54.0 and northeasterly point of 16.0, 58.0 (which basically covers the area of Denmark), returning a maximum of 100 objects skipping the first 1000.
Returns observations within the dates UTC 2018-02-12 at midnight and UTC 2018-03-18 at midnight (both dates are inclusive), returning a maximum of 20000 objects in total sorted by the "observed" time in descending order
Response schema
Overall Structure
The API is an OGC API - Features API and follows this standard as documented here: http://docs.opengeospatial.org/is/17-069r3/17-069r3.html (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 GeoJSON FeatureCollection (external site) object, which includes:
Generic fields for every Feature object
Observation (Triangulated Lightning Data)
This is a GeoJSON Feature (external site) and the table below describes the returned data:
Sensordata (Data each Lightning Sensor has Detected)
The table below describes how you should interpret the properties returned when requesting data from the sensordata schema:
Station
The table below describes how you should interpret the properties returned when requesting data from the station schema.
