Je bekijkt een oude versie van deze pagina. Bekijk de huidige versie.

Vergelijk met huidige Toon pagina historie

« Vorige Versie 2 Volgende »

Inleiding

Basisprincipes

Hieronder enkel basisprincipes samengevat:

  • Data met hoge meetfrequentie is steeds gekoppeld aan een sensor van een instrument. Bijvoorbeeld een druksensor van een barologger of een druksensor van een diver die de hydrostatische druk meet.
  • Een instrument kan op een bepaald tijdstip aan maximaal 1 filter gekoppeld zijn. Doorheen de tijd kan een instrument wel aan meerdere filters gekoppeld worden.
  • Een meetreeks is de verzameling van data van een bepaald type sensor, aan een bepaalde filter, voor een bepaalde periode. Deze data kan afkomstig zijn van verschillende instrumenten die dat type sensor bevatten en in de tijd aan de filter gekoppeld zijn geweest.

  • Het type van sensor wordt bepaald aan de hand van de parameter en optioneel de sensoridentificatie.

De data wordt dus steeds gekoppeld aan een sensor van een instrument. Om deze data te koppelen moeten volgende gegevens gekend zijn:

  • DOV-permkey (de publieke ID) van het instrument.
  • DOV-id van de sensor.

Instrumenten en sensoren

Instrument

Een instrument is een fysiek meettoestel, en kan aan volgende objecten gekoppeld worden:

  • Filter
  • Bodemlocatie

Een instrument kan aan 1 of meerdere objecten (filter of bodemlocatie) gekoppeld worden, maar niet in dezelfde periode. Omgekeerd geldt hetzelfde: een filter of bodemlocatie kan aan meerdere instrumenten gekoppeld worden, maar niet in dezelfde periode.

Ten slotte kan een instrument voor meerdere periodes aan een object gekoppeld worden. Bijvoorbeeld in januari en in maart.

Sensor

Een instrument kan 1 of meerdere sensoren bevatten van een bepaald type.

  • Bijvoorbeeld een instrument kan 1 luchtdruksensor bevatten en een temperatuursensor.

  • Een instrument kan ook een afgeleide sensoren bevatten, bijvoorbeeld peilmetingen. Peilmetingen zijn namelijk een berekende waarde.

  • Aan een instrument kunnen verschillende sensoren hangen als ze maar telkens van een ander type zijn. De combinatie parameter en sensoridentificatie kan steeds maar 1 keer voorkomen aan het instrument (*)

  • Een sensoridentificatie is een codelijst die beheerbaar is bij DOV.

(*) Indien een instrument 2 sensoren bevat die bijvoorbeeld temperatuur opmeten: Voor beide sensoren is de parameter "Temperatuur" maar de sensoridentificatie kan bijvoorbeeld "Temperatuur" en "ReferentieTemperatuur" zijn.


Meetreeks

Concept

Een meetreeks is een verzameling van data afkomstig van alle sensoren van een bepaald type van de instrumenten gekoppeld aan de filter.

Indien 1 of meerdere instrumenten gekoppeld zijn met een filter, en de instrumenten bevatten 1 of meerdere sensoren met data, wordt voor elk type sensor een meetreeks gevormd.


Voorbeeld

Instrument 1 met 2 sensoren met data: temperatuur en peilmetingen

Instrument 2 met 2 sensoren met data: luchtdruk en peilmetingen

Instrument 1 gekoppeld met Filter 1 in 2021

Instrument 2 gekoppeld met Filter 1 in 2022

Resulteert in 3 meetreeksen:

  • Een meetreeks van het type "peilmetingen" die data zal bevatten van 2021 en 2022
  • Een meetreeks van het type "Temperatuur" die data zal bevatten van 2021
  • Een meetreeks van het type "Luchtdruk" die data zal bevatten van 2022

Dataformaat

DOV verwacht ook een specifiek formaat waaraan elk datapunt moet voldoen. Elk datapunt moet volgende gegevens bevatten:

  • Datum/tijd met tijdzone van het datapunt (yyyy-mm-ddThh:mm:ss.nnnnnn+|-hh:mm) bijvoorbeeld 2019-12-31T14:00:00.000+01:00
  • Sensorwaarde (in de eenheid die in DOV voor die sensor geregistreerd is). Bijvoorbeeld 1029.375. De eenheid wordt getoond in de sensor-tabel op de instrument-fiche in kolom "Meeteenheid".
  • Waarde die aangeeft of de waarde gevalideerd is of niet gevalideerd is. 1 = gevalideerd, 0 = niet gevalideerd.

Men kan 1 datapunt of meerdere datapunten tegelijkertijd opladen naar DOV. Meerdere punten kunnen in de request zelf doorgestuurd worden of via een CSV-bestand. Het CSV bestand is dan een kommagescheiden bestand met op elke lijn 1 meetpunt.

Voorbeeld
2022-12-31T14:00:00.000+01:00,1029.375,1
2022-12-31T13:00:00.000+01:00,1027.375,0

Data aanleveren en raadplegen

Instrumenten en diens sensoren en bijhorende meetreeksen kunnen worden beheerd via de DOV webservices.

Meetreeksen opladen

Synchroon vs asynchroon

Bij het opladen van 1 punt zal dat punt onmiddellijk toegevoegd worden aan DOV (synchroon). Bij het toevoegen van meerdere punten (zowel in de body van een POST-request als via een CSV-bestand) zal de import asynchroon verlopen.

De status van de asynchrone import kan te allen tijde opgevraagd worden.

Mogelijke waarden zijn

  • NIET_VERWERKT
  • IN_VERWERKING
  • VERWERKT_MET_FOUTEN
  • VERWERKT_ZONDER_FOUTEN
  • VERWERKT_MET_WAARSCHUWINGEN
  • VALIDATIE_MET_FOUTEN
  • VALIDATIE_ZONDER_FOUTEN
  • VALIDATIE_MET_WAARSCHUWINGEN

Fouten en waarschuwingen zullen ook verduidelijkt worden in de message.

Meetreeksen verwijderen

Gegevens kunnen ook verwijderd worden van een sensor door een tijdsinterval mee te geven waartussen alle meetwaarden verwijderd worden.

Indien de starttijd niet meegegeven is, zal alle data tot en met de eindtijd verwijderd worden. Indien de eindtijd niet meegegeven is, zal alle data vanaf de starttijd verwijderd worden. Indien geen tijd meegegeven is, zal alle data verwijderd worden. Indien zowel start- als eindtijd meegegeven wordt, zal alle data (incl. grenzen) binnen die periode verwijderd worden.

Meetreeksen updaten

Om gegevens te updaten, moeten de bestaande meetwaarden eerst worden verwijderd en vervolgens opnieuw worden toegevoegd.

Indien gegevens worden opgeladen die al waren toegevoegd, zal bij de upload een validatiefout als antwoord terug komen. Voorbeeld van dergelijke boodschap is 'Meetpunt "2022-09-16T01:00:00.000+02:00" bestaat reeds in de databank voor deze sensor'.

Meetreeksen downloaden

Er kan data aan een sensor of object (meetreeks) opgehaald worden. Het resultaat kan een JSON, CSV of ZIP zijn. Een ZIP zal steeds CSV-bestanden bevatten met data gegroepeerd per maand.

Meetreeks voor een sensor

Een meetreeks kan gedownload worden voor een sensor op een instrument voor een bepaalde tijdperiode. Indien het instrument in deze periode aan verschillende objecten gekoppeld was (bv. 2 verschillende bodemlocaties), dan zal de meetreeks resultaten bevatten van de verschillende objecten.

Meetreeks voor een object (filter of bodemlocatie)

Een meetreeks van een bepaalde parameter op een gekoppeld object kan ook gedownload worden voor een bepaalde tijdsperiode. In dit geval kan de data mogelijks afkomstig zijn van verschillende instrumenten. Dit wordt dus bijvoorbeeld gebruikt om de meetreeks voor temperatuur op een bepaalde bodemlocatie op te vragen voor een bepaalde periode.

Indien het instrument meerdere sensoren van dezelfde parameter bevat, moet er een sensoridentificatie toegevoegd worden. Als een gazondolk bijvoorbeeld de temperatuur 10cm boven het maaiveld, en 10cm onder het maaiveld meet, moet naast de parametercode voor temperatuur ook de sensoridentificatie meegegeven worden. Op die manier kan dan ofwel de temperatuur boven het maaiveld, ofwel de temperatuur onder het maaiveld opgevraagd worden.

API documentatie

Quick start

Op de github-pagina van DOV (https://github.com/DOV-Vlaanderen/dov-services-quickstart) staat een demoproject (in Java of Node) dat kan helpen om via eigen code instrumenten, sensoren en bijhorende hoog frequente metingen naar DOV te zenden.

De demo-applicatie toont de mogelijke situaties voor het beheer van instrumenten en hoog frequente metingen.

Documentatie

Een technische beschrijving van de webservices omtrent hoog frequente metingen vind je op:

https://dov.vlaanderen.be/portaal/secure.html?module=doc-api-instrument

  • Geen labels