Data Rijkswaterstaat

Beta WaterWebservices

In het programma Beschikbaar maken Waterdata (BmW) is gewerkt aan het nieuwe archiefsysteem voor waterdata, genaamd WADAR (WaterData Rijkswaterstaat). Hierin zijn een aantal verbeteringen doorgevoerd aan de WaterWebservices.

De klassieke WaterWebservices (waterwebservices.rijkswaterstaat.nl/...) zullen eind april opgeheven worden. Schakel daarom nu over.

De onderstaande pagina laat zien wat de veranderingen zijn tussen de klassieke WaterWebservices en de nieuwe WaterWebservices.

Vragen? Github Discussions of Servicedesk Data.

Waarom zijn er wijzigingen?

Met het archiefsysteem Wadar hebben we nodige verbeteringen doorgevoerd aan de achterkant van de applicatie. Er is daarbij geprobeerd zo min mogelijk wijzigingen voor jou als afnemer door te voeren. In het kort zijn de volgende verbeteringen doorgevoerd;

  • Meer en eerder; Metingen en correcties zijn eerder beschikbaar doordat we een directe verbinding hebben met het archief. Daarnaast is het archief verder opengesteld onder het principe 'open, tenzij'. In de loop van 2026 zullen we ook steeds meer data gaan delen.
  • Geen gedoe met locaties. Actuele metingen schrijven direct naar het archiefsysteem. Met dezelfde bevraging haal je data op van de eerste meting in het jaar 1737 tot aan de berekende waterstanden van 2027.
  • Uitwisselen met andere systemen is makkelijker, doordat we ons aan de AQUO-standaard houden; Rijkswaterstaat-eigen termen zoals WATHTBRKD zijn genormaliseerd óf beschreven in een aanvullend register, het Waterstaat Register Data.
  • Het opstellen van requests wordt vereenvoudigd;
    • Betere foutmeldingen bij onvolledige request-body's, volgens best practices met bijbehorende statuscodes.
    • Onnodige nestingen in responses zijn aangepast. Ongebruikte velden zijn verwijderd.
    • Bevragingen zijn minder hoofdlettergevoelig

Wijzigingen in de WaterWebservices

De verbeteringen hebben de volgende effecten op de werkwijze van onze webservices. In grote lijnen is de werkwijze hetzelfde gebleven, maar om wegwijs te raken in de groeiende bak met data is stap 5 toegevoegd.

1. Haal de catalogus met beschikbare gegevens op

De url van de WaterWebservices is gewijzigd, maar dezelfde body kan gebruikt blijven worden.

Body voor https://ddapi20-waterwebservices.rijkswaterstaat.nl/METADATASERVICES/OphalenCatalogus

{"CatalogusFilter": {"Compartimenten":true, "Grootheden":true}}

*Ontvang je de foutcode ‘400 Bad Request’? Controleer of je een geldige body meegestuurd hebt. Controleer bijvoorbeeld op juist gebruik van haakjes en aanhalingstekens. 
* Ontvang je de foutcode ‘404 Not Found’? Ondanks deze 404-foutcode heb je een respons-body met daarin verdere informatie. Afhankelijk van het platform kan het zijn dat de respons-body bij een 404 niet direct getoond wordt.
*Ontvang je de foutcode ‘405 Method Not Allowed’? Controleer of je de POST methode gebruikt in plaats van een GET of PUT
*Ontvang je de foutcode ‘415 Unsupported Media Type’? Definieer dan dat de body die je meestuurt van het type ‘application/json’ is door een HTTP-aanvraagheader toe te voegen ‘Content-Type: application/json’
*Om in de toekomst voldoende bereikbaarheid van de service te kunnen blijven garanderen, denken we aan gebruikers niveau differentiatie, bijvoorbeeld met een API-key. Om je code hier alvast op voor te bereiden kun je een dummy-tekst plaatsen in de HTTP-aanvraagheader ‘X-API-KEY’. Dit is niet verplicht, maar het helpt ons wel met debugging en gebruikersondersteuning.

2. Kies de gewenste gegevens

Koppel zoals voorheen de eerste drie lijsten aan elkaar met behulp van de MessageID’s. Je hebt nu een overzicht van wat waar gemeten wordt. Kies een combinatie van locatie, compartiment en grootheid.

*De meta-velden BioTaxon_Compartiment, MonsterBewerkingsMethode en PlaatsBepalingsApparaat waren ongebruikt, en zijn nu verwijderd. 
*WaardeBepalingsmethoden, WaardeBepalingstechnieken en WaardeBewerkingsmethoden hebben andere hoofdletters gekregen; WaardeBewerkingsMethode.
*Het ProcesType is een technische implementatie om gemeten waterstanden van voorspelde waterstanden te onderscheiden. Deze implementatie is niet volgens de Aquo-standaard. Maar wel handig. 
*De spelling van AquoMetaData_MessageID is gelijkgetrokken in alle responses, dit is nu in de vorm;
  "AquoMetadataLocatieLijst" {[ "AquoMetaData_MessageID" ]};

3. Check of er waarnemingen tijdens de gewenste periode zijn (optioneel);

Op basis van een gekozen locatie, compartiment, grootheid en periode kan bekeken worden of er op te halen waarnemingen bestaan.

Locatiecodes zijn gewijzigd;

  • De datastromen van verschillende aanbieders gaf voorheen problemen met dubbele locaties. Zo was voor het gebied nabij 'Hoek van Holland' de locatiecode HOEK nodig voor actuele watermetingen vanuit het LMW (Landelijk Meetnet Water), de locatiecode HVH25 voor zoutmetingen, en HOEKVHLD voor historische metingen vanuit het Donar (archief). Deze locatiecodes zijn nu geüniformeerd onder 'hoekvanholland'. Voor een was/wordt lijst, zie het WRD of deze Excel met Fenomeenlocaties. Het meegeven van coordinaten is hierbij ook niet meer nodig. Om een specifieke bemonsteringshoogte op te vragen, zie stap 5. Scherp zoekopdracht aan.
  • Het gebuikte coordinatensysteem wijzigt; Van ETRS89 UTM zone 31N (EPSG:25831) naar ETRS89 lat/lon (EPSG:4258). Voor weergave-doeleinden is het verschil tussen ETRS89 lat/lon en WGS84 verwaarloosbaar.

Body voor https://ddapi20-waterwebservices.rijkswaterstaat.nl/ONLINEWAARNEMINGENSERVICES/CheckWaarnemingenAanwezig

{"LocatieLijst": [{"Code":"ameland.nes"}],
  "AquoMetadataLijst": [{"Compartiment":{"Code":"OW"}, "Grootheid":{"Code":"WATHTE"}}],
  "Periode":{
     "Begindatumtijd":"2025-12-01T00:00:00.000+01:00",
     "Einddatumtijd":"2026-01-01T00:00:00.000+01:00"}}

*Ontvang je de foutcode ‘400 Bad Request’? Controleer of je de body voorzien hebt van een LocatieLijst in plaats van een enkele locatie. Of op juist gebruik van haakjes en aanhalingstekens. Zie ook de teruggestuurde body voor nadere foutmelding.
*Definiëren van WaarnemingMetadata komt te vervallen.

4. Haal gekozen waarnemingen op

Op basis van de gekozen locatie, compartiment, grootheid en periode kunnen nu de waarnemingen opgehaald worden met de OphalenWaarnemingen url.

Body voor https://ddapi20-waterwebservices.rijkswaterstaat.nl/ONLINEWAARNEMINGENSERVICES/OphalenWaarnemingen

{"Locatie":{"Code":"ameland.nes"},
  "AquoPlusWaarnemingMetadata":{
    "AquoMetadata":{"Compartiment":{"Code":"OW"}, "Grootheid":{"Code":"WATHTE"}}},
  "Periode":{
    "Begindatumtijd":"2025-12-01T00:00:00.000+01:00",
    "Einddatumtijd":"2026-01-01T00:00:00.000+01:00"}}

*Ontvang je een 204 'No Content'? Dan zijn er geen gegevens gevonden die voldoen aan je vraag. In de vorige WaterWebservices werd dit medegedeeld met een succesvol=false in de JSON. Check of de gevraagde data wel in de catalogus voor komt, of verruim de periode van je aanvraag.

Er worden één of meerdere WaarnemingenLijsten geretourneerd met de gevraagde gegevens. Voor eventuele vragen over de duiding van de metadatavelden kun je terecht bij de Aquo welke aangevuld zijn met Rijkswaterstaat-termen in het WRD of kun je contact opnemen met de Servicedesk Data.

In de opbouw van de JSON-respons zijn de volgende onderdelen gewijzigd;

  • WaarnemingMetadata bevatte eerst een aantal lijsten met metadata van een specifieke meting, zoals KwaliteitswaardecodeLijst. Een specifieke meting kan maar één kwaliteitswaardecode hebben, dus deze lijst had altijd de lengte 1. Daarom zijn deze lijsten omgezet tot enkele waarde.
    • Was; WaarnemingenLijst[*].MetingenLijst[*].WaarnemingMetadata.KwaliteitswaardecodeLijst[0]
    • Wordt; WaarnemingenLijst[*].MetingenLijst[*].WaarnemingMetadata.Kwaliteitswaardecode
  • AquoMetaData_MessageID en Locatie_MessageID hadden geen betekenis in deze respons, en zijn daarom verwijderd
    • Was; WaarnemingenLijst[*].AquoMetaData. AquoMetadata_MessageID
    • Wordt; -
  • WaardeBepalingsmethoden, WaardeBepalingstechnieken en WaardeBewerkingsmethoden hebben andere hoofdletters gekregen; WaardeBewerkingsMethode.
  • BioTaxonType is nu een lijst met objecten, zoals de andere velden.
    • Was; WaarnemingenLijst[*].AquoMetaData.BioTaxonType
    • Wordt; WaarnemingenLijst[*].AquoMetaData.BioTaxonType.{Code, Omschrijving}
  • Het ProcesType is toegevoegd. Het ProcesType is extra attribuut om gemeten waterstanden van astronomische en voorspelde waterstanden te onderscheiden.
  • MonsterBewerkingsMethode was ongebruikt, en is nu uitgefaseerd. Biotaxontype en Biotaxon-compartimentcode zijn nu ongebruikt en zullen in een toekomsige versie uitgefaseerd worden. Het PlaatsBepalingsApparaat is vervallen en onderdeel geworden van het meetapparaat.

Data-inhoudelijk zijn de volgende punten gewijzigd;

  • Meetwaarde_alfanumeriek is altijd gevuld, ook als de meetwaarde numeriek geparst kan worden.
  • Opdrachtgevende instanties zijn transparanter, zie Stap 5. Scherp zoekopdracht aan
  • Meetapparaten zijn transparanter. In plaats van het soort apparaat, wordt het specifieke type gegeven.
  • Kwaliteitswaardecode 31 wordt niet meer gegeven. Deze wordt voortaan uitgegeven als 25.

5. Scherp zoekopdracht aan

Omdat het archief verder opengesteld is, kan het zijn dat er veel meer data terug komt dan voorheen. Door na een eerste aanroep je vraag aan te scherpen voorkom je dat data vertroebelt voor je toepassing. Een aantal goed toepasbare filteringen zijn;

  • Filter op procestype. Zoals meting, astronomisch of verwacht; Als je bij het opvragen van gegevens enkel metingen wil (en geen modelverwachtingen) kun je het volgende filter aan je request toevoegen;
    "AquoMetadata": {…,"ProcesType":"meting"}
    Als je noujuist enkel verwachtingen wil ontvangen, voeg het volgende toe;
    "AquoMetadata": {…,"ProcesType":"verwacht"}
  • Filter op bemonsteringshoogte; Bij verschillende grootheden wordt op verschillende hoogten bemonsterd. Bijvoorbeeld het zoutgehalte van water, dat over de diepte door verschillende dichtheden erg kan verschillen. Voorheen werd de bemonsteringshoogte gezien als onderdeel van de locatiecode. Bijvoorbeeld HVH25. Om deze specifieke bemonsteringshoogte op te vragen;
    "AquoPlusWaarnemingMetadata": {
        "AquoMetadata": {...}, "WaarnemingMetadata": {"BemonsteringshoogteLijst":["-250"]}  }
  • Filter op opdrachtgevende instantie. In het doel meer transparant te zijn worden er geen opdrachtgevende-instantie groepen meer gebruikt. Bij de Downloads kun je een was-wordt lijst vinden, en een lijst met omschrijvingen behorend bij de codes. Bijvoorbeeld waar u voorheen data ontving onder LMW_ZOUT;
    "AquoPlusWaarnemingMetadata": {
        "AquoMetadata": {...},     "WaarnemingMetadata": {"OpdrachtgevendeInstantieLijst":["RIKZ_GOLVEN"]}  }

Voor het eerdere voorbeeld waren we op zoek naar de gemeten waterstanden bij ameland.nes. Om te voorkomen dat we ook de voorspellingen terug krijgen, specificeren we "ProcesType": "meting". Om te voorkomen dat we ook data terug krijgen van andere aanbieders die eventueel in deze periode metingen hebben verricht, specificeren we "OpdrachtgevendeInstantieLijst": ["RIKZ_GOLVEN"]. 

Body voor https://ddapi20-waterwebservices.rijkswaterstaat.nl/ONLINEWAARNEMINGENSERVICES/OphalenWaarnemingen

{"Locatie":{"Code":"ameland.nes"},
  "AquoPlusWaarnemingMetadata":{
    "AquoMetadata":{
      "Grootheid":{"Code":"WATHTE"},
      "ProcesType": "meting"},
  "WaarnemingMetadata":{"OpdrachtgevendeInstantieLijst": ["RIKZ_GOLVEN"]}},
  "Periode":{
    "Begindatumtijd":"2025-12-01T00:00:00.000+01:00",
    "Einddatumtijd":"2026-01-01T00:00:00.000+01:00"}}

Voorbeelden

Een aantal specifieke gebruikerstoepassingen zijn ook gewijzigd door de veranderende inhoud van de responses.

Verwachte waterstand over een uur

Elke 6 uur worden er waterstanden voorspeld op basis van het weer. De speciale grootheden ‘WATHTEVERWACHT’ en 'QVERWACHT' komen niet meer voor. In plaats daarvan wordt de grootheid gebruikt (resp. WATHTE en Q) waarbij onderscheid gemaakt wordt in de waardebepalingsmethode en het procestype. Bereid de catalogusvraag eerst uit met verwachtingen;

Body voor https://ddapi20-waterwebservices.rijkswaterstaat.nl/METADATASERVICES/OphalenCatalogus

{"CatalogusFilter": {"Compartimenten":true, "Grootheden":true, "ProcesTypes": true}}

Op basis van de resultaten in de catalogus kun je specifiek verwachtingen opvragen;

Body voor https://ddapi20-waterwebservices.rijkswaterstaat.nl/ONLINEWAARNEMINGENSERVICES/OphalenWaarnemingen

{"Locatie":{"Code":"ameland.nes"},
  "AquoPlusWaarnemingMetadata":{
    "AquoMetadata":{"Grootheid":{"Code":"WATHTE"}, "ProcesType":"verwachting"}},
  "Periode":{
    "Begindatumtijd":"2025-12-01T00:00:00.000+01:00",
    "Einddatumtijd":"2026-01-01T00:00:00.000+01:00"} }

* Het "ProcesType":"verwachting" is een veld dat niet in de AQUO-standaard voor komt. Daarom is dit gegeven ook opgenomen in de waardebepalingsmethode. 
* Ook historische verwachtingen worden gearchiveerd. Daarom het advies om metingen op te halen in de periode tussen T-10min en T+2 dagen.

Wanneer keert het tij?

Naast waterstanden per 10 minuten zijn ook de hoog- en laag water extremen op te vragen. De getij-extremen zijn een voorbeeld waarbij er twee reeksen bij elkaar horen; Een waterstand en een getijextreemtype. Dit wordt ook wel een multiplex of 'mux' genoemd. Deze gegevens kunnen tegelijk opgevraagd worden door middel van een groepering. Deze werking hiervan blijft ongewijzigd.

Body voor https://ddapi20-waterwebservices.rijkswaterstaat.nl/METADATASERVICES/OphalenCatalogus

{"CatalogusFilter": {"Compartimenten":true, "Grootheden":true, "Groeperingen": true}}

De groepering code GETETBRKD2 staat voor 'Getijextreem berekend'. Om er zeker van te zijn dat je alle data onder deze groepering op haalt, is het niet nodig om daarnaast nog te filteren op bijvoorbeeld een grootheid.

Body voor https://ddapi20-waterwebservices.rijkswaterstaat.nl/ONLINEWAARNEMINGENSERVICES/OphalenWaarnemingen

{"Locatie":{"Code":"ameland.nes"},
  "AquoPlusWaarnemingMetadata":{
    "AquoMetadata":{"Groepering":{"Code":"GETETBRKD2"}}},
  "Periode":{
    "Begindatumtijd":"2025-12-01T00:00:00.000+01:00",
    "Einddatumtijd":"2026-01-01T00:00:00.000+01:00"}}

* De code GETET staat voor de groepering 'Getijextreemtype'. Deze zijn verkrijgbaar in de vorm GETETBRKD2 voor berekende getij-extremen zoals op getij.rws.nl en GETETM2 die de daadwerkelijk gemeten getij-extremen weergeeft. Op offshore-locaties wordt respectievelijk GETETBRKDMSL2 en GETETMSL2 ter beschikking gesteld omdat deze gemeten zijn ten opzichte van het referentievlak MSL in plaats van NAP. 
* In de toekomst zullen er meer muxen gedeeld worden onder andere groeperingscodes.

Actuele lucht- en watertemperatuur van Vlissingen en Hoek van Holland

Per AquoMetadata/locatie/kwaliteitswaardecode combinatie wordt de laatste meting beschikbaar gesteld de OphalenLaatsteWaarnemingen service. Met deze service is het mogelijk om een lijst met Locaties en een lijst met AquoMetadata op te geven. Onderstaand vraagt de grootheid temperatuur (T) van de compartimenten Oppervlaktewater (OW) en lucht (LT) op. Om te specificeren dat we actuele data op willen halen, specificeren we die betreffende opdrachtgevende instanties.

Body voor https://waterwebservices.beta.rijkswaterstaat.nl/test/ONLINEWAARNEMINGENSERVICES/OphalenLaatsteWaarnemingen

{"LocatieLijst":[
  {"Code":"vlissingen"},
  {"Code":"hoekvanholland"}],
"AquoPlusWaarnemingMetadataLijst":[
  {"AquoMetadata":{"Compartiment":{"Code":"OW"}, "Grootheid":{"Code":"T"}},
  "WaarnemingMetadata": {"OpdrachtgevendeInstantieLijst":["RIKZMON_TEMP"]} },
  {"AquoMetadata":{"Compartiment":{"Code":"LT"},"Grootheid":{"Code":"T"}},
  "WaarnemingMetadata": {"OpdrachtgevendeInstantieLijst":["RIKZ_METEO"]} }]}*Meetwaarde.Waarde_Alfanumeriek wordt voortaan meegegeven om ook minder gebruikte parameters via dit endpoint te ondersteunen. Zoals wiskundige notaties of klasses (LW/HW bij getij)
*Op dit endpoint zullen alleen gegevens met "ProcesType": "meting" gegeven worden.  Dus geen verwachtingen of astronomische gegevens. 
*De wijzigingen in de opbouw van de json-respons voor OphalenLaatsteWaarnemingen zijn gelijk aan die van OphalenWaarnemingen. Zie hst. 4

Concentraties Cadmium in de Maas

Naast fysische metingen (waterhoogte, golfhoogte) bieden de WaterWebservices ook een grote hoeveelheid chemische metingen aan. Belangrijke locaties zijn de meetpontons bij Eijsden (eijsden / eijsden.ponton) en Lobith (lobith.ponton). Omdat veel chemische metingen de grootheid 'MASSFTE' (massafractie) of 'CONCTTE' (concentratie) hebben, is het nuttig om het catalogusfilter uit te breiden met de Parameters;

Body voor https://ddapi20-waterwebservices.rijkswaterstaat.nl/METADATASERVICES/OphalenCatalogus

{"CatalogusFilter": {"Compartimenten":true, "Grootheden":true, "Parameters":true}}

Doordat het archief- en distributiesysteem nu één geheel is, kunnen meetgegevens eerder gedeeld worden. Eerder werd alleen data met de status 'Definitief' gedeeld op het moment van de publicatie van de bijbehorende rapportages. Nu wordt deze data eerder gedeeld onder de status 'ongecontroleerd', en worden correcties op metingen direct doorgevoerd. Let hier dus op voordat je conclusies trekt uit deze gegevens. Bij vragen kunt u bij de Servicedesk Data terecht.

Body voor https://ddapi20-waterwebservices.rijkswaterstaat.nl/ONLINEWAARNEMINGENSERVICES/OphalenWaarnemingen

{"Locatie":{"Code":"lobith.ponton"},
  "AquoPlusWaarnemingMetadata":{
    "AquoMetadata":{
      "Compartiment":{"Code":"OW"}, "Grootheid":{"Code":"CONCTTE"}, "Parameter":{"Code":"Cd"}}},
  "Periode":{
    "Begindatumtijd":"2023-01-01T00:00:00.000+01:00",
    "Einddatumtijd":"2024-01-01T00:00:00.000+01:00"}}

*Zie ‘Scherp zoekopdracht aan’ voor het verkleinen van de respons. In geval van chemische metingen kan een filtering op opdrachtgevende instantie van toepassing zijn. Langdurige meetreeksen worden bijvoorbeeld uitgegeven door RIZAMON_LAN en RIKZMON_CHEMIE, die meten voor het MWTL-programma.
*Door een minimale filtering met bijvoorbeeld enkel "AquoMetadata":{"Compartiment":{"Code":"OW"}} over een korte periode, kun je een snel overzicht creëren van de beschikbare gegevens op een specifieke locatie.

Filteren op kwaliteitswaarde

Elke individuele meting kent een kwaliteitswaardecode die aangeeft hoe betrouwbaar een waarde is. Zie Aquo voor de betekenis. Op waterinfo.rws.nl wordt enkel data getoond die kwaliteitswaardecode heeft in de lijst ["00","10","20","25","30","40"]. De code "99" wordt gebruikt om een hiaatwaarde aan te geven. Met de volgende body kun je voor online viewers specifiek de data opvragen die hieraan voldoet. Deze functionaliteit is ongewijzigd.

Body voor https://ddapi20-waterwebservices.rijkswaterstaat.nl/ONLINEWAARNEMINGENSERVICES/OphalenWaarnemingen

{"Locatie":{"Code":"ameland.nes"},
  "AquoPlusWaarnemingMetadata":{
    "AquoMetadata":{"Compartiment":{"Code":"OW"},"Grootheid":{"Code":"WATHTE"}},
    "WaarnemingMetadata": {"KwaliteitswaardecodeLijst":["00","10","20","25","30","40"]}},
  "Periode":{
   "Begindatumtijd":"2025-12-01T00:00:00.000+01:00",
   "Einddatumtijd":"2026-01-01T00:00:00.000+01:00"}}

* Voor onderzoekstoepassingen adviseren we niet te filteren op kwaliteitswaardecodes maar dit in je eigen omgeving te doen. Dit versnelt het ophalen van langere tijdreeksen, en geeft een betere indruk over de gehele meetreeks. 
* De kwaliteitswaardecode 31 (normale waarde, alternatief bepaald) wordt niet meer gegeven. Dit wordt voortaan uitgegeven als 25 (in de ruimte en in de tijd geinterpoleerde waarde).

Een uitgebreide catalogus met leesbare omschrijvingen

In voorgaande voorbeelden zag je een compacte versie van de OphalenCatalogus functie waarin slechts enkele eigenschappen opgevraagd werden (compartiment, grootheid en parameter). Deze eigenschappen samen beschrijven 'wat' er gemeten is. De geretourneerde parameter_wat_omschrijving is een voorbeeld van een meetreeks dat hieraan voldoet. Voor de meeste toepassingen is dit voldoende.
Voor toepassingen waarin het daarnaast van belang is om te onderscheiden 'hoe' er gemeten wordt, kunt u een uitgebreidere catalogus opvragen. De volledige parameter_wat_omschrijving is gebaseerd op de onderstaande 10 aquometadata-velden, en wordt onder andere gebruikt in Waterinfo.

Body voor https://ddapi20-waterwebservices.rijkswaterstaat.nl/METADATASERVICES/OphalenCatalogus

{"CatalogusFilter":{
  "Compartimenten":true, "Grootheden":true, "Parameters":true, "Eenheden":true,
  "Hoedanigheden":true, "Typeringen":true, "WaardeBewerkingsMethoden":true,
  "BioTaxon":true, "Organen":true,
  "ProcesTypes": true} }* De parameter_wat_omschrijving wordt opgebouwd door middel van;
[WaardeBewerkingsMethode] [Typering] [Grootheid] [Parameter] [ProcesType] ‘in’ [Compartiment] [Hoedanigheid] ‘in’ [Orgaan] [BioTaxon] [Eenheid]
Compartimenten, grootheden, parameters en eenheden geven vooral aan 'wat' er gemeten is.
Waar hoedanigheden, typeringen en waardebewerkingsmethoden vooral aangeven 'hoe' er gemeten is.
Biotaxon en Organen worden gebruikt om biologische metingen te onderscheiden.

Shapefile met laatst gemeten waterstanden

Om de mogelijkheden van deze OGC service op te vragen;

https://geo.rijkswaterstaat.nl/services/ogc/hws/DDAPI20/ows?SERVICE=WFS&VERSION=1.1.0&REQUEST=GetCapabilities

Deze service is te bevragen op een export van alle mogelijke watermanagementlocaties uit het WRD met de laag 'locaties'. Dit zijn dus álle mogelijke watermanagementlocaties, met of zonder data. Daarmee maken we deze ook beschikbaar voor toekomstige systemen die ook van deze watermanagementlocaties gebruik willen maken.

https://geo.rijkswaterstaat.nl/services/ogc/hws/DDAPI20/ows?SERVICE=WFS&VERSION=1.1.0&REQUEST=GetFeature&TYPENAME=locaties&outputFormat=SHAPE-ZIP

Met de laag ‘locatiesmetlaatstewaarneming’ vindt u alle actuele waarnemingen. Het kan nuttig zijn om een filter toe te passen op de 'parameter_wat_omschrijving', bijvoorbeeld op waterhoogten;
https://geo.rijkswaterstaat.nl/services/ogc/hws/DDAPI20/ows?SERVICE=WFS&VERSION=1.1.0&REQUEST=GetFeature&TYPENAME=locatiesmetlaatstewaarneming&FILTER=
<Filter>
  <PropertyIsLike escape="!" singleChar="." wildCard="*">
    <PropertyName>PARAMETER_WAT_OMSCHRIJVING</PropertyName>
    <Literal>*Waterhoogte*</Literal>
  </PropertyIsLike>
</Filter>
&outputFormat=SHAPE-ZIP

*We hebben nog wat werk aan deze service om te voorkomen dat de lat en lon omgedraaid worden bij het exporteren van data.

CSV-bestand met laatste waarneming

Via de OGC-service is het ook mogelijk om voor elke locatie de laatst gemeten waarneming op te halen als csv-bestand. Dit kan hiermee een handig alternatief zijn op de OphalenCatalogus.

https://geo.rijkswaterstaat.nl/services/ogc/hws/DDAPI20/ows?SERVICE=WFS&VERSION=1.1.0&REQUEST=GetFeature&TYPENAME=locatiesmetlaatstewaarneming&outputFormat=csv

FAQ overstap van de Webservices

  • Q: Blijven de klassieke WaterWebservices beschikbaar?
    A: Nee. Deze zullen eind april 2026 opgeheven worden.
  • Q: Waarom worden de locatie-coordinaten niet in RD gegeven? 
    A: Om ook metingen op zee of metingen van Rijkswaterstaat in het buitenland te kunnen delen, hebben we gekozen voor een brede standaard. Middels het WFS-endpoint is het mogelijk om coördinaten omgerekend op te vragen.

Known issues

  • De performance van het OphalenCatalogus endpoint is ondermaats.
  • Reeksen worden soms opgeknipt, waardoor gegevens met dezelfde metadata over meerdere MetingenLijsten verdeeld worden. Hierdoor worden er ook meerdere OphalenLaatsteWaarnemingen gegeven waar er één of enkele worden verwacht.
  • Het endpoint CheckWaarnemingenAanwezig heeft niet de functionaliteit om naast AquoMetadata ook WaarnemingMetadata te definiëren (zoals Statuswaarde of Bemonsteringshoogte). Als je de deze check wel nodig hebt, kun je OphalenWaarnemingen hiervoor gebruiken. Een http-statuscode '204 No Content' geeft dan aan dat er in deze periode met de betreffende filtering geen data is.

Contact

We zijn actief op Github Discussions! We nodigen je graag uit om daar vragen te stellen, aanvullingen te delen, of noujuist anderen te helpen.

Heb je een individuele vraag? Dan kun je bij de Servicedesk Data terecht. We streven ernaar je vraag binnen een week te beantwoorden. Meldt daarbij specifiek dat je overstapt van de klassieke WaterWebservices naar de nieuwe WaterWebservices, en stuur als het mogelijk is ook het gebruikte request-body mee. Onze experts staan voor je klaar!

Updates

5 december 2025 - We zijn Live!

Op 5 december zal Wadar live gaan, en haar data gaan delen via de nieuwe WaterWebservices.
Voor uw gemak zal de bèta url automatisch verwijzen naar deze nieuwe WaterWebservices.

9 oktober 2024 - Kijk het Webinar hier terug

In dit Webinar maken we de belangrijkste wijzigingen bekend. Heb je het Webinar gemist, of zou je hem graag nog eens terug willen kijken? Dan is hij hier terug te zien.

1 januari 2024 - Welkom

Deze documentatie-pagina is gelanceerd voor iedereen die deze link heeft.

Downloads