Grondwatermonitoringput

Een GroundwaterMonitoringWell vertegenwoordigt een fysieke put waarin één of meerdere grondwatermonitoringbuizen aanwezig kunnen zijn.

De Engelse term binnen het publieke API-contract is:

Groundwater Monitoring Well

In de Nederlandse documentatie gebruiken we hiervoor grondwatermonitoringput of kortweg put.

De collection resource is:

groundwater-monitoring-wells

Discovery-resource

Beschikbare monitoringputten worden opgehaald via:

GET /v1/groundwater-monitoring-wells

Het endpoint retourneert een collectie van monitoringputten en de peilbuizen die voor de gebruikte API-key beschikbaar zijn.

Voorbeeld:

[
  {
    "name": "B00A0000",
    "tubes": [
      {
        "identifier": "ada37574-9e0e-462e-85a1-97a2c7b53fdf",
        "number": "1"
      }
    ]
  }
]

Geen publieke putidentifier

Een monitoringput heeft in de huidige publieke API nog geen zelfstandige technische identifier, in de toekomst komt deze er nog bij.

Het veld:

name

is de herkenbare naam van de monitoringput. Deze naam wordt gebruikt voor discovery en context, maar wordt niet gebruikt om het measurements-endpoint te adresseren.

Deze keuze voorkomt dat een bestaande putnaam als kunstmatige stabiele identifier in het publieke contract wordt vastgelegd.

Relatie met peilbuizen

Een monitoringput bevat één of meerdere GroundwaterMonitoringTube-resources:

Groundwater Monitoring Well
└── Groundwater Monitoring Tube
    └── Groundwater Level Measurements

Grondwaterstanden horen bij de peilbuis, niet bij de put als geheel.

Daarom wordt een meetreeks rechtstreeks via de peilbuisidentifier opgehaald:

GET /v1/groundwater-monitoring-tubes/{tubeIdentifier}/measurements

Toegang per peilbuis

Autorisatie wordt op peilbuisniveau toegepast.

Stel dat een monitoringput vier peilbuizen bevat en de API-client toegang heeft tot één daarvan. Het discovery-endpoint retourneert dan de put, maar uitsluitend met die ene toegankelijke peilbuis:

[
  {
    "name": "B00A0000",
    "tubes": [
      {
        "identifier": "ada37574-9e0e-462e-85a1-97a2c7b53fdf",
        "number": "1"
      }
    ]
  }
]

De overige peilbuizen worden niet vermeld. Ook hun identifiers en nummers worden niet blootgesteld.

Een monitoringput waarvoor geen enkele peilbuis toegankelijk is, wordt niet geretourneerd.

Betekenis van de put

De monitoringput vormt de fysieke en administratieve context waarin peilbuizen zijn aangebracht. De put zelf bevat geen grondwatermetingen.

Verschillende peilbuizen binnen dezelfde put kunnen verschillende delen van de ondergrond ontsluiten en daardoor verschillende grondwaterstanden hebben.

Een wijziging van sensor of logger verandert niet automatisch de identiteit van de put of peilbuis.

Huidige API-ondersteuning

De huidige API gebruikt de monitoringput als discovery- en contextresource.

Beschikbaar zijn:

GET /groundwater-monitoring-wells
GET /groundwater-monitoring-tubes/{tubeIdentifier}/measurements