Algemeen

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.

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.

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.

Hoogfrequente meetreeksen uploaden in het DOV-Portaal

Hoogfrequente meetreeksen beheren via de DOV-webservices

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

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'.

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