EDR API: nieuwe 10-minute-in-situ-meteorological-observations collectie
Het KNMI verzamelt meteorologische oppervlaktewaarnemingen van automatische weerstations (in-situ) in Nederland en de BES-eilanden. Deze data wordt verspreid via de Open Data API en de Open Geo Consortium (OGC) Environmental Data Retrieval (EDR) API.
In dit nieuwsbericht geven we u de belangrijkste aanpassingen in de collectie van de 10-minute-in-situ-meteorological-observations collectie in onze EDR API. Deze nieuwe collectie vervangt de bestaande collectie `observations`.
De EDR API stelt gebruikers in staat om datasets op specifieke parameters te bevragen op een spatiotemporele manier, waardoor het niet meer nodig is om volledige datasets te downloaden. Raadpleeg onze EDR API-documentatie voor meer informatie hierover.
Verbeteringen aan variabelen
De nieuwe collectie `10-minute-in-situ-meteorological-observations` is nu gelijk aan de bijbehorende Open Data API-dataset. Dit betekent dat alle variabelen (parameters) in de dataset nu dezelfde name, metadata en data bevatten. Dit betekent ook dat de namen van variabelen nu verschillen van de oude collectie `observations`. Zie hiervoor het overzicht onderaan deze pagina. Verdere verbeteringen zijn de nieuwe velden in de parametermetadata (`description`, `duration`, `method` en `level`) en verbetering van parametermetadata volgens CF conventions en QUDT-ontologie.
Door de verbeteringen in de parametermetadata zijn er nu meer query-opties in de EDR. Het is nu mogelijk om parameters te filteren op CF standaardnaam, level, aggregatiemethode, of tijdsduur.
Voor een overzicht van alle variabelen, zie de technische documentatie. Voor een overzicht van alle filteropties, zie de Swagger specificatie.
Verbeteringen in functionaliteit
We hebben twee nieuwe methoden toegevoegd om data op te vragen van meerdere stations. Ten eerste is het nu mogelijk om een WKT-polygoon te gebruiken met behulp van het endpoint '/area'. Ten tweede is het mogelijk om meerdere afzonderlijke stations te bevragen met behulp van de methode`/locations/{locationId},{locationId}`. Voorheen werd er een Coverage voor een station geven en een CoverageColleciton voor meerdere stations. Nu wordt altijd een CoverageCollectie teruggeven voor consistentie. We gebruiken nu de WIGOS Station Identifier (WSI) in onze responses en queryparameters. De oude WMO-ID's zijn nog steeds zichtbaar in de output van het endpoint `/locations`. De WSI is nu opgenomen in de CoverageJSON output als ‘eumetnet:locationId’.
Daarnaast hebben we het derde positie-element (`station elevation`, of `z-coordinate`) verwijderd uit de GeoJSON resultaten van het endpoint `/locations` . Voorheen was de z-coördinaat, in de verzameling `observations` een waarde uit een set parameters die de hoogte boven zeeniveau meten. Omdat de z-coördinaat in GeoJSON omschreven wordt als de waarde,als hoogte van de WGS84-ellipsoïde. De hoogte wordt nu apart gerapporteerd in de GeoJSON eigenschappen.
Veranderingen en verbeteringen in data beschikbaarheid
De nieuwe collectie bevat nu de geschiedenis sinds 1 januari 2012. Dit is later dan de vorige collectie. Deze collectie had een geschiedenis vanaf 2003, maar door de collectiemethode van voor 2012 kunnen we niet de validiteit van de data garanderen en is daarom uit de collectie gelaten.
Net als de file-based Open Data API dataset, kan de nieuwe collectie tot 7 dagen later worden geupdated met missende data. We raden aan om de MQTT Notification Service te gebruiken om op de hoogte te worden gesteld van updates van oudere waarnemingen.
Stopzetten`observaties` collectie
Door de introductie van de nieuwe `10-minute-in-situ-meteorological-observations` collectie is de uitfasering van de oude`observaties` collectie gestart. Vanaf 1 juli 2025 wordt deze oudere collectie als verouderd beschouwd. Op 29 september 2025 stopt de dataset volledig met het ontvangen van updates.
Het stopzetten van de `observaties` collectie is tegelijkertijd met het stopzetten van `Actuele10mindataKNMIstations` dataset.
Meer informatie
Voor meer uitgebreide en technische documentatie over de stations, variabelen, tijdsaanduidingen en beschikbaarheid, raadpleeg de nieuwe documentatiepagina over 10-minute-in-situ-meteorological-observations.
Overzicht overlappende parameters
Deze tabel geeft een overzicht tussen parameters die overlappen tussen de oude `observations` en nieuwe `10-minute-in-situ-meteorological-observations` collection. Zie de technische documentatie voor een overzicht van alle parameters in de `10-minute-in-situ-meteorological-observations` collection.
| `observations` collection | `10-minute-in-situ-meteorological-observations` collection |
|---|---|
| dd_10 | dd |
| ff_10m_10 | ff |
| fx_10m_10 | gff |
| t_dryb_10 | ta |
| u_10 | rh |
| p_nap_msl_10 | pp |
| mor_10 | zm |
| dr_regenm_10 | dr |
| h_ceilom_10 | hc |
| h1_ceilom_10 | hc1 |
| h2_ceilom_10 | hc2 |
| h3_ceilom_10 | hc3 |
| n_ceilom_10 | nc |
| n1_ceilom_10 | nc1 |
| n2_ceilom_10 | nc2 |
| n3_ceilom_10 | nc3 |
| ri_pws_10 | pg |
| dr_pws_10 | pr |
| q_glob_10 | qg |
| ri_regenm_10 | rg |
| sq_10 | ss |
| t_dewp_10 | td |
| tn_10cm_past_6h_10 | tgn |
| tn_dryb_10 | tn |
| tx_dryb_10 | tx |
| ww_curr_10 | ww |
| ww_cor_10 | pwc |
| ww_past_10 | ww-10 |