Deze pagina geeft een beschrijving van de XML-inhoud van objecten uit het grondwater- en het bodemdomein. Enerzijds wordt ter illustratie een minimaal XML-bestand meegegeven, anderzijds een beschrijving van de belangrijkste attributen per object. Waar relevant, wordt een link gegeven naar de bijhorende codelijsten (die kunnen ook uit de XSD-gehaald worden).

XML-bestanden: algemene info

In het XML-bestand maak je een XML-object aan. Dit XML-object start met een specifieke tag (bv. <grondwaterlocatie> voor put-objecten, en <filter> voor filter-objecten). Tussen de start- en eindtag van het object (bv. <filter> en </filter>) worden de andere eigenschappen van het object toegevoegd met hun eigen tags. Enkele aandachtspunten:

Het formaat van het XML-bestand luistert redelijk nauw: zo moet elke begintag ook afgesloten worden met een eindtag. Indien er geen geneste tags voorkomen, kan ook gebruikt worden gemaakt van de verkorte notatie (bv. <filter />).
Je kan een apart XML-bestand aanmaken voor elke apart object, of alle XML-objecten samenvoegen in één bestand. Putten, Filters en peilmetingen worden als aparte objecten toegevoegd (dus een filter is geen genest object van een put, een peilmeting is geen genest object van een filter).
De tags zijn specifiek voor DOV en worden gecontrolleerd via een XSD-bestand, waarin gedocumenteerd wordt welke tags toegelaten zijn, en wat ze precies betekenen. Er is een apart XSD-bestand voor objecten van het grondwatermeetnet. Meer informatie over validatie van XML-bestanden en het XML-formaat van DOV is te vinden op de pagina over het xml-import-uitwisselingsformaat.
De XML-validatietool laat u toe om na te gaan of een XML-bestand een geldig bestand is dat door de DOV-toepassing correct kan verwerkt worden. Deze tool vind je op de XML-validatie webpagina van DOV. Meer informatie hierover vind je in Handleiding voor validatie aan XML-schema. Hierbij wordt enkel nagekeken of de data voldoet aan de XML-schema specificaties. Er gebeurt geen inhoudelijke controle van de data. Deze tool is enkel een validatie-tool. Er worden met deze tool geen bestanden opgeladen naar DOV.

Elke fiche in DOV heeft ook een XML-variant. Die kan je opvragen door achter de url van de fiche "?format=xml" toe te voegen. Bv. https://www.dov.vlaanderen.be/data/put/2022-101201 wordt dan https://www.dov.vlaanderen.be/data/put/2022-101201?format=xml.

XML van grondwaterlocaties

Onderstaande codeblok geeft een voorbeeld van één put met één filter en een voorbeeld van vier manuele peilmetingen.

XML-voorbeeld (één put met één filter)

<ns0:dov-schema xmlns:ns0="http://kern.schemas.dov.vlaanderen.be" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://kern.schemas.dov.vlaanderen.be https://www.dov.vlaanderen.be/xdov/schema/latest/xsd/kern/dov.xsd">
	<grondwaterlocatie>
		<identificatie>BPA_001</identificatie>
		<grondwaterlocatieType>PUT</grondwaterlocatieType>
		<puntligging>
			<xy>
				<x>108430.61</x>
				<y>193370.1</y>
				<betrouwbaarheid>goed</betrouwbaarheid>
				<methode_opmeten>gedigitaliseerd op orthofoto</methode_opmeten>
				<origine_opmeten>
					<naam>ILVO</naam>
				</origine_opmeten>
			</xy>
			<gemeente>44021</gemeente>
			<oorspronkelijk_maaiveld>
				<waarde>5.7</waarde>
				<betrouwbaarheid>goed</betrouwbaarheid>
				<methode_opmeten>methode onbekend</methode_opmeten>
				<origine_opmeten>
					<naam>ILVO</naam>
				</origine_opmeten>
			</oorspronkelijk_maaiveld>
			<start_tov_maaiveld>
				<gestart_op>MAAIVELD</gestart_op>
			</start_tov_maaiveld>
		</puntligging>
		<diepte>4.0</diepte>
		<datum_ingebruikname>2022-06-14</datum_ingebruikname>
		<putsoort>verbuisde boorput</putsoort>
		<beheer>
			<vanaf>2022-06-14</vanaf>
			<beheerder>
				<naam>ILVO</naam>
			</beheerder>
		</beheer>
		<afwerking>
			<beschermbuis />
			<annulaireruimte>
				<van>0.00</van>
				<tot>4.0</tot>
				<materiaal>filterzand</materiaal>
			</annulaireruimte>
		</afwerking>
		<status>publiek</status>
	</grondwaterlocatie>
	<filter>
		<identificatie>1</identificatie>
		<filtertype>peilfilter</filtertype>
		<grondwaterlocatie>BPA_001</grondwaterlocatie>
		<meetnet>9</meetnet>
		<datum_ingebruikname>2022-06-14</datum_ingebruikname>
		<monsternameMogelijk>false</monsternameMogelijk>
		<ligging>
			<aquifer>0100</aquifer>
			<grondwatersysteem>Centraal Vlaams Systeem</grondwatersysteem>
			<regime>freatisch</regime>
		</ligging>
		<meetfrequentie />
		<opbouw />
		<status>publiek</status>
	</filter>
</ns0:dov-schema>

XML-voorbeeld van vier peilmetingen

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns3:dov-schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns3="http://kern.schemas.dov.vlaanderen.be" xsi:schemaLocation="http://kern.schemas.dov.vlaanderen.be https://www.dov.vlaanderen.be/xdov/schema/latest/xsd/kern/dov.xsd">
    <filtermeting>
        <grondwaterlocatie>BPA_003</grondwaterlocatie>
        <filter>
            <identificatie>1</identificatie>
            <filtertype>peilfilter</filtertype>
        </filter>
        <peilmeting>
            <datum>2022-07-12</datum>
            <tijdstip>11:55:00</tijdstip>
            <peil_mtaw>3.69</peil_mtaw>
            <methode>peillint</methode>
            <filtertoestand>1</filtertoestand>
            <filterstatus>in rust</filterstatus>
            <opmeter>
                <naam>Bart</naam>
                <voornaam>Pannemans</voornaam>
            </opmeter>
            <zoet>N</zoet>
            <betrouwbaarheid>goed</betrouwbaarheid>
        </peilmeting>
        <peilmeting>
            <datum>2022-07-12</datum>
            <tijdstip>12:55:00</tijdstip>
            <peil_mtaw>3.50</peil_mtaw>
            <methode>peillint</methode>
            <filtertoestand>1</filtertoestand>
            <filterstatus>in rust</filterstatus>
            <opmeter>
                <naam>Bart</naam>
                <voornaam>Pannemans</voornaam>
            </opmeter>
            <zoet>N</zoet>
            <betrouwbaarheid>goed</betrouwbaarheid>
        </peilmeting>
        <peilmeting>
            <datum>2022-07-11</datum>
            <tijdstip>13:55:00</tijdstip>
            <peil_mtaw>3.33</peil_mtaw>
            <methode>peillint</methode>
            <filtertoestand>1</filtertoestand>
            <filterstatus>in rust</filterstatus>
            <opmeter>
                <naam>Bart</naam>
                <voornaam>Pannemans</voornaam>
            </opmeter>
            <zoet>N</zoet>
            <betrouwbaarheid>goed</betrouwbaarheid>
        </peilmeting>
        <peilmeting>
            <datum>2022-07-06</datum>
            <tijdstip>11:55:00</tijdstip>
            <peil_mtaw>3.20</peil_mtaw>
            <methode>peillint</methode>
            <filtertoestand>1</filtertoestand>
            <filterstatus>in rust</filterstatus>
            <opmeter>
                <naam>Bart</naam>
                <voornaam>Pannemans</voornaam>
            </opmeter>
            <zoet>N</zoet>
            <betrouwbaarheid>goed</betrouwbaarheid>
        </peilmeting>
    </filtermeting>
</ns3:dov-schema>

XML-tags van een PUT

Klik op onderstaande links, om een overzicht te krijgen van de XML-tags van alle objecten.

XML-tags voor een PUT

tag	verplicht	opmerkingen	waardes
<grondwaterlocatie>	ja	root-tag voor een PUT-object
<grondwaterlocatie><identificatie>	ja	code of id waarmee de put uniek geïdentificeerd wordt
<grondwaterlocatie><grondwaterlocatieType>	ja	voor peilputten is de waarde meestal 'put'.
<grondwaterlocatie><puntligging>	ja	container voor info over xy en maaiveld
<grondwaterlocatie><puntligging><xy>	ja	container voor info over xy
<grondwaterlocatie><puntligging><xy><x> en <y>	ja	Lambert coordinaten
<grondwaterlocatie><puntligging><xy><methode_opmeten>	ja	hoe werd de xy-locatie ingemeten	codelijst
<grondwaterlocatie><puntligging><xy><betrouwbaarheid>	neen	hoe betrouwbaar is de xy-locatie	codelijst
<grondwaterlocatie><puntligging><gemeente>	neen	nis-code van de gemeente waarin de put gelegen is	codelijst
<grondwaterlocatie><puntligging><oorspronkelijk_maaiveld>	ja	referentiehoogte
<grondwaterlocatie><puntligging><oorspronkelijk_maaiveld><waarde>		Z-waarde van maaiveld	getal
<grondwaterlocatie><puntligging><oorspronkelijk_maaiveld><methode_opmeten>		hoe werd de hoogte van het maaiveld opgemeten	codelijst
<grondwaterlocatie><puntligging><start_tov_maaiveld>
<grondwaterlocatie><puntligging><start_tov_maaiveld><gestart_op>		??
<grondwaterlocatie><diepte>		diepte van de put tov maaiveld	getal
<grondwaterlocatie><datum_ingebruikname>		datum van ingebruikname (formaat is yyyy-mm-dd)	datum
<grondwaterlocatie><putsoort>		type 'put'. Voor peilputten is dit meestal code 1 (='verbuisde boorput')	codelijst
<grondwaterlocatie><beheer>
<grondwaterlocatie><beheer><vanaf>		datum dat put in beheer werd genomen door de opgegeven beheerder. Meerdere opeenvolgende beheerders voor dezelfde put is mogelijk. (formaat is yyyy-mm-dd)	datum
<grondwaterlocatie><beheer><beheerder><naam> of <code>		naam van beheerder (je kan naam gebruiken of de bijhorende code)	codelijst
<grondwaterlocatie><beheer><afwerking>	neen
<grondwaterlocatie><beheer><status>		intern te houden of mag dit ook publiek enzo. Voor publieke data is de aanbevolen id 4 (='publiek')	codelijst
betrouwbaarheid		deze betrouwbaarheid wordt zowel gebruikt bij de xy-methode als bij z (hoogte_maaiveld)	codelijst
nabestemming	neen	??	codelijst
meetcampagne	neen	??	codelijst
bijlagetypes	neen	mogelijke bijlages die aan een putfiche kunnen toegevoegd worden (hier enkel ter referentie gegeven, maar wordt meestal niet gebruikt)	codelijst

XML-tags van een FILTER

XML-tags voor een FILTER

tag	verplicht	opmerkingen	waardes
<filter>	ja	root-tag voor een FILTER-object
<filter><identificatie>	ja	nummer van de filter (1, 2, ...)	getal
<filter><filtertype>	ja	altijd peilfilter
<filter><grondwaterlocatie>	ja	code of permkey van de bijhorende put
<filter><meetnet>	ja	code/id van het meetnet	codelijst
<filter><datum_ingebruikname>	ja	formaat yyyy-mm-dd	datum
<filter><ligging>	neen	relatie met de hydrogeologie van de ondergrond
<filter><ligging><aquifer>	neen	HCOV-code	codelijst (codelijst voor HCOV2)
<filter><ligging><grondwatersysteem>	neen	wordt automatisch ingevuld vanuit gekozen HCOV	codelijst
<filter><ligging><regime>	neen	regime (verschil met volgende??)	codelijst
<filter><ligging><hydrologisch regime>	neen	hydrologisch regime (verschil met vorige??)	codelijst
<filter><status>	ja	intern te houden of mag dit ook publiek enzo	codelijst
betrouwbaarheid		deze betrouwbaarheid wordt zowel gebruikt bij de xy-methode als bij z (hoogte_maaiveld)	codelijst
grondwaterlichaam			codelijst
meetnettype	neen		codelijst
oxidatiereductie	neen	wordt dit echt gebruikt in filterfiche??	codelijst

XML-tags van een PEILMETING

XML-tags voor een PEILMETING

tag	verplicht	opmerkingen	waardes
<peilmeting>	ja	root-tag voor een FILTER-object
<peilmeting><datum>	ja	datum van de observatie (formaat yyyy-mm-dd)	datum
<peilmeting><tijdstip>	neen	tijdstip van de observatie (formaat uu:hh:ss)	tijd
<peilmeting><diepte_mtaw>	neen	berekende waterhoogte in mTAW (dus niet waterdiepte tov bovenkant peilbuis)	getal
<peilmeting><methode>	neen	methode van de peilmeting	codelijst
<peilmeting><opmeter>	neen	naam van de opmeter	datum
<peilmeting><opmeter><voornaam>	neen	voornaam	tekst
<peilmeting><opmeter><naam>	neen	achternaam	tekst
filtertoestand	neen	vaststellingen tijdens de gerapporteerde peilopmeting (bv. bevroren, droog, koeien). Merk op dat, hoewel filtertoestand veel waardes gemeen heeft met filterwaarnemingstype, maar dat er toch een nuanceverschil is. Bij filterwaarnemingstype is er geen peilmeting gebeurd (behalve als filterwaarnemingstype = Normaal)	codelijst
filterwaarnemingstype	neen	soort observatie: die kan een effectieve peilmeting zijn, maar ook een andere vaststelling die tussendoor gebeurde, of een reden waarom een peilmeting niet kon gebeuren	codelijst

XML van bodemlocaties

nog aan te vullen

Pagina-navigatiestructuur

Data toevoegen via XML-bestanden