hollandse luchten API

data opvragen

 

Voor het opvragen van data zijn de drie onderstaande API calls beschikbaar.

De API calls geven standaard JSON terug. Voor #2 en #3 hieronder kan je door “&format=csv” aan de url toe te voegen een csv-bestand downloaden. Voor de andere calls kan je eventueel gebruik maken een online tool als deze om het naar csv om te zetten.

NB: voor alle calls geeft “time” het startuur aan van de uurgemiddelden. Waarden met “time”: “2019-11-29T10:00:00.000Z” zijn dus het gemiddelden van de metingen tussen 10:00 en 11:00 (UTC).

1. Alle sensorkits en metadata

https://data.waag.org/api/holu/getStations

Geeft array alle geregistreerde sensorkits als object met de volgende metadata:

{
  "id": 52,
  "latitude": 52.495931,
  "longitude": 4.595755,
  "extended": false,
  "tag": "Wijk aan Zee",
  "name": "Stetweg"
}

 

2. Meest recente uurgemiddelden van alle sensorkits

https://data.waag.org/api/holu/holukit/calibrated/recent 

Geeft een array van alle sensorkits met de laatste uurgemiddelden (ruw en gekalibreerd) van elk van de gemeten parameters, bijvoorbeeld:

{
  "id": "100",
  "time": "2019-11-29T10:00:00.000Z",
  "pm25_fac": 1.53,
  "pm25_mean": 5.202,
  "pm25_raw": 3.4,
  "pm10_fac": 1.35909,
  "pm10_mean": 20.264,
  "pm10_raw": 14.91
}

 

3. Historische uurgemiddelden

https://data.waag.org/api/holu/holukit/calibrated/hourly?sensor_id=[SENSOR_ID]&start=[STARTTIJD]&end=[EINDTIJD] 

Bijvoorbeeld:

https://data.waag.org/api/holu/holukit/calibrated/hourly?sensor_id=79&start=2019-08-22T12:00:00.000Z&end=2019-11-20T13:14:00.000Z

Geeft een array van uurgemiddelden voor een specifieke sensorkit binnen opgegeven periode.

 

diagnostische API calls

 

Verstuurde metingen HoLu-sensorkit laatste 5 min

Om snel te kunnen zien wat de laatste metingen van de afgelopen 5 minuten zijn geweest die een sensorkit heeft verstuurd kan je de volgende API call gebruiken:

https://data.waag.org/api/holu/getLatestValueSensor?sensor_id=[SENSOR_ID]

Bijvoorbeeld:

https://data.waag.org/api/holu/getLatestValueSensor?sensor_id=200

 

Gebruikte LoRa Gateways

Om te kunnen zien via welke LoRa gateways een (of meerdere sensorkits) data verstuurd kan je de volgende API call gebruiken:

https://data.waag.org/api/holu/holukit/gateways/?time=[timestamp]&sensor_id=[sensor id(s)] 

time: ISO timestamp, of simpeler YYYY-MM-DD.
De opgevraagde info is 1 dag (vanaf de timestamp). Wanneer geen time is opgegeven wordt de laatste 24u opgevraagd.

sensor_id: één of meerdere (kommagescheiden) id’s.
Wanneer geen sensor_id niet wordt opgegeven worden gegevens van alle sensoren opgevraagd (voor 1u).

 

Voorbeeld voor 1 sensorkit op specifieke dag:

https://data.waag.org/api/holu/holukit/gateways/?sensor_id=20&time=2020-02-02

Voorbeeld voor 1 sensorkit, laatste 24 uur:

https://data.waag.org/api/holu/holukit/gateways/?sensor_id=5

Voorbeeld voor meerdere sensorkits, laatste 24 uur:

https://data.waag.org/api/holu/holukit/gateways/?sensor_id=20,21

 

Vervolgens is het via de API van The Things Network mogelijk meer informatie op te vragen voor een specifieke gateway:

https://account.thethingsnetwork.org/api/v2/gateways/[GATEWAY_ID]

Dus bv:

https://account.thethingsnetwork.org/api/v2/gateways/eui-1dee1a526d1f93ac