Grondwatermonitoringbuis

Een GroundwaterMonitoringTube vertegenwoordigt een afzonderlijke peilbuis binnen een grondwatermonitoringput.

In de Nederlandse grondwaterpraktijk wordt meestal gesproken over een peilbuis. Informeel wordt soms de term filter gebruikt, maar een filter is strikt genomen slechts het doorlatende deel van een peilbuis.

Binnen het publieke API-contract gebruikt Avallo:

Groundwater Monitoring Tube

De bijbehorende resource is:

groundwater-monitoring-tubes

Identificatie

Een peilbuis bevat twee relevante waarden:

{
  "identifier": "ada37574-9e0e-462e-85a1-97a2c7b53fdf",
  "number": "1"
}

identifier is de stabiele technische identifier van de peilbuis en wordt gebruikt als tubeIdentifier in resourcepaden.

number is het herkenbare buis- of filternummer binnen de monitoringput. Dit nummer is contextinformatie en is niet de technische identifier van de publieke resource.

Identifier ophalen

Gebruik het discovery-endpoint:

GET /v1/groundwater-monitoring-wells

De response bevat uitsluitend peilbuizen die voor de gebruikte API-sleutel beschikbaar zijn.

Voorbeeld:

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

Metingen ophalen

Gebruik de ontvangen identifier als tubeIdentifier:

curl --request GET \
  --url "https://api.avallo.nl/v1/groundwater-monitoring-tubes/ada37574-9e0e-462e-85a1-97a2c7b53fdf/measurements?from=2026-09-01T00%3A00%3A00Z&to=2026-09-08T00%3A00%3A00Z" \
  --header "Accept: application/json" \
  --header "X-API-Key: {apiKey}"

Een succesvolle response bevat een GroundwaterLevelSeries:

{
  "tubeIdentifier": "ada37574-9e0e-462e-85a1-97a2c7b53fdf",
  "from": "2026-09-01T00:00:00Z",
  "to": "2026-09-08T00:00:00Z",
  "unit": "m",
  "verticalDatum": "NAP",
  "measurements": [
    {
      "observedAt": "2026-09-01T00:00:00Z",
      "value": 31.6799
    }
  ]
}

De voorbeeldidentificaties en meetwaarden zijn illustratief.

Betekenis van de meetreeks

Verschillende peilbuizen binnen dezelfde put kunnen verschillende delen van de ondergrond ontsluiten. Hun grondwaterstanden kunnen daardoor op hetzelfde tijdstip van elkaar verschillen.

Meetreeksen van verschillende peilbuizen mogen daarom niet uitsluitend op basis van geografische nabijheid of hetzelfde putnummer worden samengevoegd. De peilbuisidentifier moet onderdeel blijven van de gegevenscontext.

De peilbuis staat los van de sensor of logger die op een bepaald moment wordt gebruikt. Het vervangen van meetapparatuur verandert niet automatisch de identiteit van de peilbuis.

Toegang en 404

Wanneer een tubeIdentifier niet bestaat of niet toegankelijk is voor de API-client, retourneert de API in beide gevallen:

404 Not Found

Gebruik daarom de identifiers uit GET /groundwater-monitoring-wells en behandel een eerder opgeslagen identifier die 404 retourneert als niet beschikbaar voor de huidige API-client.