Samen Meten (RIVM)

Basisadres

https://api-samenmeten.rivm.nl/v1.0

Endpoints 9

• GET/ThingsSensorkastjes; properties met project, owner, gemeentecode en de dichtstbijzijnde officiële stations per stof (no2closecode, pm25regiocode …).
• GET/DatastreamsEén meetreeks per kastje en grootheid, naam <kastje>-<nr>-<grootheid> (SMC_20058-21-pm25_kal), met eenheid.
• GET/Datastreams({id})/ObservationsUurwaarden van één reeks (phenomenonTime, result).
• GET/ObservationsAlle waarnemingen; altijd filteren, de hele set is te groot om te tellen.
• GET/ObservedPropertiesDe 9 grootheden: pm10, pm25, pm10_kal, pm25_kal (gekalibreerd), no2, nh3, temp, rh, pres.
• GET/SensorsDe 52 sensoren op naam (Sensirion SEN5x, AirVisual …); het nummer in description komt terug in de datastreamnaam.
• GET/LocationsPlaatsen van de kastjes (GeoJSON-punt); zoek in de buurt met geo.distance.
• GET/HistoricalLocationsEerdere plaatsen van een kastje (verhuisd).
• GET/FeaturesOfInterestWaar een waarneming over gaat (meestal de locatie).

Filteren platform

OData-achtige expressies in $filter (SensorThings), ook op properties/… en met geo.distance(location, geography'SRID=4326;POINT(lon lat)') le <graden>.

Parameters 6

Velden in het antwoord (selectie) 8

Limieten en valkuilen

• $top hoogstens 200 per pagina; volg @iot.nextLink voor de rest. getest
• Tellen over alle Observations of alle actieve kastjes liep vast (HTTP 504). Tel per reeks of per project. ervaring
• Voor fijnstof bestaan twee reeksen per kastje: ruw (pm25, pm10) en gekalibreerd (pm25_kal, pm10_kal, 'fijnstof gekalibreerd' in ObservedProperties). Vergelijk met officiële metingen alleen de _kal-reeksen. getest
• geo.distance werkt alleen met geography'SRID=4326;POINT(lon lat)', afstand in graden (0,005 ≈ 350 m oost-west). ervaring
• Een fout in $filter geeft 400 met de ruwe databasefout ('pq: column "bogus" does not exist'): handig om veldnamen te controleren. getest
• Elk kastje noemt in properties de dichtstbijzijnde officiële Luchtmeetnet-stations per stof: zo vergelijk je direct met de referentiemeting. getest

Probeer het HTTP 200 · 387 ms · 16 okt

https://api-samenmeten.rivm.nl/v1.0/Datastreams?$filter=name eq 'SMC_20058-21-pm25_kal'&$expand=Observations($top=3;$orderby=phenomenonTime desc)

{
  "value": [
    {
      "@iot.id": 56399,
      "@iot.selfLink": "https://api-samenmeten.rivm.nl/v1.0/Datastreams(56399)",
      "name": "SMC_20058-21-pm25_kal",
      "description": "SMC_20058-21-pm25_kal",
      "unitOfMeasurement": {
        "definition": "https://qudt.org/vocab/unit/MicroGM-PER-M3",
        "symbol": "ug/m3"
      },
      "observationType": "http://www.opengis.net/def/observationType/OGC-OM/2.0/OM_Measurement",
      "Thing@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Datastreams(56399)/Thing",
      "Sensor@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Datastreams(56399)/Sensor",
      "ObservedProperty@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Datastreams(56399)/ObservedProperty",
      "Observations": [
        {
          "@iot.id": 733886641,
          "@iot.selfLink": "https://api-samenmeten.rivm.nl/v1.0/Observations(733886641)",
          "phenomenonTime": "2026-10-16T20:00:00.000Z",
          "result": 3.01,
          "Datastream@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Observations(733886641)/Datastream",
          "FeatureOfInterest@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Observations(733886641)/FeatureOfInterest",
          "resultTime": null
        },
        {
          "@iot.id": 733875902,
          "@iot.selfLink": "https://api-samenmeten.rivm.nl/v1.0/Observations(733875902)",
          "phenomenonTime": "2026-10-16T19:00:00.000Z",
          "result": 15.09,
          "Datastream@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Observations(733875902)/Datastream",
          "FeatureOfInterest@iot.navigationLink": "https://api-samenmeten.rivm.nl/v1.0/Observations(733875902)/FeatureOfInterest",
          "resultTime": null
        }
      ]
    }
  ]
}

Ingekort antwoord, opgeslagen bij het oogsten. Klik op het adres voor het echte, actuele antwoord.