Beta WaterWebservices

In het programma Beschikbaar maken Waterdata (BmW) wordt gewerkt aan de nieuwe back-end voor waterdata, genaamd WADAR (WaterData Rijkswaterstaat). Hierin worden ook een aantal verbeteringen doorgevoerd aan de WaterWebservices. Deze WaterWebservices zijn nu gepubliceerd als bèta-versie.

De onderstaande pagina laat zien wat de veranderingen zijn tussen de huidige WaterWebservices en de Bèta WaterWebservices.

Vragen? developer.overheid.nl of Servicedesk Data.

Bèta-WaterWebservices

Deze Bèta-WaterWebservice biedt ontwikkelaars de ruimte om hun tooling voor te bereiden op de veranderingen in de API structuur.

Als ontwikkelaar wordt je aangemoedigd om de API te gebruiken, fouten te rapporteren, en suggesties te geven. Jouw feedback helpt ons om features te verfijnen en de API te optimaliseren voordat de stabiele release plaatsvindt.

De Bèta-WaterWebservices bestaan uit de volgende endpoints

  • MetadataService; Ophalen van een catalogus van beschikbare waarnemingen
  • OnlineWaarnemingenService; Ophalen van historische en actuele waarnemingen
    • OphalenWaarnemingen; Om waarnemingen binnen een opgegeven periode te halen
    • CheckWaarnemingenAanwezig
    • OphalenLaatsteWaarneming; Laatste valide waarneming

De volgende endpoints vallen buiten de scope van de bèta-versie. Deze endpoints worden later gepubliceerd.

  • WebMappingServices; WMS en WFS kaartdata met actuele waarnemingen
  • OnlineWaarnemingenService
    • OphalenAantalWaarnemingen; Telt het aantal waarnemingen in een tijdsperiode
    • OphalenBulkWaarnemingen; De functionaliteit achter Waterinfo 'Download historische Data'.

Deze bèta versie richt zich op dit moment alleen op de wijzigingen in de structuur. De performance van deze service is daarmee nog geen onderdeel van de scope. Een responstijd tot een minuut is daarmee normaal. Ook de volledigheid, actualiteit en correctheid van de data wordt niet gegarandeerd.

Kort overzicht van de wijzigingen

Met deze bèta versie 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'.
  • Geen onderscheid meer tussen actuele en historische locaties. Actuele metingen schrijven direct naar het archiefsysteem. Met dezelfde bevraging haal je data op van het jaar 1700 tot nu.
  • 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

Werkwijze ophalen gegevens

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 bèta-WaterWebservices is gewijzigd, maar dezelfde body kan gebruikt blijven worden.

Body voor https://waterwebservices.beta.rijkswaterstaat.nl/test/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. In deze bèta-versie wordt er nog niet volledig gecontroleerd op ongeldige termen in de request-body. We helpen jou als bèta-tester graag op weg, om foutmeldingen beter aan te laten sluiten op de wensen van eindgebruikers.
* 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 diffrentiatie, 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. We horen ook graag wat de wensen van jou als gebruiker hierin zijn.

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 tijdelijke 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). Dit maakt het gebruik van coordinaten minder foutgevoelig en bereid ons voor ook buitenlandse locaties te geven. ETRS89 lat/lon (EPSG:4258) is erg vergelijkbaar met de wereldwijde standaard WGS84, maar is daarbij ook gebonden aan de Europesche aardplaat waardoor het beter geschikt is voor archiefdoeleinden. Voor weergave-doeleinden is het verschil tussen ETRS89 lat/lon en WGS84 verwaarloosbaar.

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

{"LocatieLijst": [{"Code":"ameland.nes"}],
  "AquoMetadataLijst": [{"Compartiment":{"Code":"OW"}, "Grootheid":{"Code":"WATHTE"}}],
  "Periode":{
     "Begindatumtijd":"2024-06-01T00:00:00.000+01:00",
     "Einddatumtijd":"2025-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.

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://waterwebservices.beta.rijkswaterstaat.nl/test/ONLINEWAARNEMINGENSERVICES/OphalenWaarnemingen

{"Locatie":{"Code":"ameland.nes"},
  "AquoPlusWaarnemingMetadata":{
    "AquoMetadata":{"Compartiment":{"Code":"OW"}, "Grootheid":{"Code":"WATHTE"}}},
  "Periode":{
    "Begindatumtijd":"2024-06-01T00:00:00.000+01:00",
    "Einddatumtijd":"2025-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 middels 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 toevoegen 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. Hier kun je een was-wordt lijst vinden. 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://waterwebservices.beta.rijkswaterstaat.nl/test/ONLINEWAARNEMINGENSERVICES/OphalenWaarnemingen

{"Locatie":{"Code":"ameland.nes"},
  "AquoPlusWaarnemingMetadata":{
    "AquoMetadata":{"Grootheid":{"Code":"WATHTE"}, "ProcesType": "meting"},
    "WaarnemingMetadata":{"OpdrachtgevendeInstantieLijst": ["RIKZ_GOLVEN"]}},
  "Periode":{
    "Begindatumtijd":"2024-06-01T00:00:00.000+01:00",
    "Einddatumtijd":"2025-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://waterwebservices.beta.rijkswaterstaat.nl/test/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://waterwebservices.beta.rijkswaterstaat.nl/test/ONLINEWAARNEMINGENSERVICES/OphalenWaarnemingen

{"Locatie":{"Code":"ameland.nes"},
  "AquoPlusWaarnemingMetadata":{
    "AquoMetadata":{"Grootheid":{"Code":"WATHTE"}, "ProcesType":"verwachting"}},
  "Periode":{
    "Begindatumtijd":"2024-06-01T00:00:00.000+01:00",
    "Einddatumtijd":"2025-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. 
* Voorheen was alleen de meest actuele verwachting is beschikbaar, daarmee was is het geen probleem om een ruimere periode op te vragen. Dit is in de bèta versie niet het geval, maar dit zal hersteld gaan worden. 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, wel zullen er in de toekomst meer muxen gedeeld worden. Zoals golfhoogtespectra.

Body voor https://waterwebservices.beta.rijkswaterstaat.nl/test/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://waterwebservices.beta.rijkswaterstaat.nl/test/ONLINEWAARNEMINGENSERVICES/OphalenWaarnemingen

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

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 temperatuur (T) van zowel het Oppervlaktewater (OW) als de lucht (LT) op.

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

{"LocatieLijst":[
    {"Code":"vlissingen.boeissvh"},
    {"Code":"hoekvanholland.badstrand"}],
  "AquoPlusWaarnemingMetadataLijst":[
    {"AquoMetadata":{"Compartiment":{"Code":"OW"}, "Grootheid":{"Code":"T"}}},
    {"AquoMetadata":{"Compartiment":{"Code":"LT"},"Grootheid":{"Code":"T"}}}]}
*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
*De exacte werking van dit endpoint bij meerdere reeksen dient nog verder getest te worden. Feedback is dus welkom!

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://waterwebservices.beta.rijkswaterstaat.nl/test/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://waterwebservices.beta.rijkswaterstaat.nl/test/ONLINEWAARNEMINGENSERVICES/OphalenWaarnemingen

{"Locatie":{"Code":"lobith.ponton"},
  "AquoPlusWaarnemingMetadata":{
    "AquoMetadata":{
      "Compartiment":{"Code":"OW"}, "Grootheid":{"Code":"CONCTTE"}, "Parameter":{"Code":"Cd"}}},
  "Periode":{
    "Begindatumtijd":"2020-01-01T00:00:00.000+01:00",
    "Einddatumtijd":"2025-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 creeren 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://waterwebservices.beta.rijkswaterstaat.nl/test/ONLINEWAARNEMINGENSERVICES/OphalenWaarnemingen

{"Locatie":{"Code":"ameland.nes"},
  "AquoPlusWaarnemingMetadata":{
    "AquoMetadata":{"Compartiment":{"Code":"OW"},"Grootheid":{"Code":"WATHTE"}},
    "WaarnemingMetadata": {"KwaliteitswaardecodeLijst":["00","10","20","25","30","40"]}},
  "Periode":{
   "Begindatumtijd":"2024-06-01T00:00:00.000+01:00",
   "Einddatumtijd":"2025-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://waterwebservices.beta.rijkswaterstaat.nl/test/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.

FAQ

  • Q: Vervangt dit systeem ook het Landelijk Meetnet Water (LMW), Landelijke opslag Lodingen (LOL), Matroos, MKKDL of SIP?
    A: Nee.
  • Q: Is er overlap tussen de huidige WaterWebservices en niet-beta-WADAR waterwebservices?
    A: Ja, na release van deze bèta WaterWebservices zullen de oude WaterWebservices nog even beschikbaar blijfen. De periode en de details van deze overlap zullen tegen die tijd nader worden toegelicht.
  • Q: Welke Service Level Agreements (SLA's) worden gegarandeerd als het volledige systeem in productie is? Hoe lang kunnen we als eindgebruiker bijvoorbeeld zonder data zitten?
    A: Dit is gelijk aan de huidige WaterWebservices.
  • Q: We maken gebruik van meerdere aanbieders voor waterdata. Heeft Rijkswaterstaat plannen om meer meetlocaties op te nemen zodat we van minder aanbieders gebruik hoeven te maken?
    A: Data buiten ons areaal vallen buiten de missie van Rijkswaterstaat. We streven liever naar standaardisatie, zodat bronnen makkelijk gecombineerd kunnen worden.
  • Q: De data voldoen aan de AQUO standaard, is ook rekening gehouden met internationale standaarden?
    A: Vooralsnog confirmeren we ons in onze webservices aan de Nederlandse standaard: AQUO.
  • Q: Wordt het bij het OphalenWaarnemingen ook mogelijk om meerdere locaties in een keer te bevragen?
    A: Hier is nog niet aan gedacht. Wensen zoals deze zijn voor ons erg waardevol, ze geven een goede inkijk in hoe de WaterWebservices gebruikt worden. We nemen dit mee als gebruikerswens op de backlog.
  • 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. In een komende update delen we ook het OGC:WFS-endpoint, waarbij je coördinaten on-the-fly om kunt laten omrekenen. We zullen daar dan een voorbeeld van geven.
  • Q: Wat doe je met meetpalen die in verleden op een andere plaats hebben gestaan? Krijgen deze dan steeds nieuwe namen?
    A: Als de meetlocatie niet significant gewijzigd is, blijft deze dezelfde locatiecode houden. Als je data opvraagt op basis van die locatiecode, zul je in de respons zien dat de data opgeknipt is in twee reeksen met de twee verschillende coordinaten. Deze eigenschappen worden door WADAR opgehaald uit het Waterstaat Register Data (WRD), op basis van de begin- en eind geldigheid.

Known issues

  • De meeste gegevensreeksen lopen tot mei 2024. Een enkele lopen door tot actuele gegevens. Voor fyische metingen (waterstanden, debieten, golfhoogten) zullen deze reeksen in de toekomst aangevuld worden tot acutele gegevens.
  • Reeksen worden soms opgeknipt, waardoor gegevens met dezelfde metadata over meerdere MetingenLijsten verdeeld worden.
  • Er is data beschikbaar met grootheid WATHTE met een tijdsinterval van 5 minuten. Metingen met tijdsintervallen kleiner dan 5 minuten zullen niet gepubliceerd worden via de definitieve WaterWebservices.
  • De parameter is soms NVT en soms null. Dit zal in de toekomst altijd NVT zijn.
  • De grootheid WATHTBRKD zal vervangen worden door WATHTE

Contact

We zijn actief op developer.overheid.nl! 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 gebruik maakt van de bèta-WaterWebservices, en stuur als het mogelijk is ook het gebruikte request-body mee. Onze experts staan voor je klaar!

Updates

10 oktober 2024 - FAQ

We zijn blij met al jullie vragen! De meestgestelde vragen uit het Webinar zijn opgenomen in de FAQ. Andere vragen? developer.overheid.nl of Servicedesk Data.

9 oktober 2024 - Kijk het webinar hier terug

Heb je het webinar gemist, of zou je hem graag nog eens terug willen kijken? Dan is hij hier terug te zien.

6 oktober 2024 - Aanpassing richting Webinar

Documentatie is aangepast op de inhoud van het Webinar dat plaats zal vinden op 7 oktober. Dit webinar zal daarna in verkorte vorm hier gedeeld worden.

5 april 2024 - Aanscherping teksten

1 januari 2024 - Welkom

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

Downloads