Handreiking Afname BRO Gegevens
BRO Uitgiftekanalen
Handreiking voor afname van BRO-gegevens
(juli 2022)
Colofon
Uitgegeven door | Ministerie van Volkshuisvesting en Ruimtelijke Ordening – Programmabureau BRO |
Datum | juli 2022 |
Versiebeheer | 3.1 - release Q2 2021 |
3.2 - toevoegen REST service verwijzingen en tekstuele aanpassingen | |
3.3 - toevoegen release Q4 2021 3.4 - toevoegen release Q2 2022 | |
Website | www.basisregistratieondergrond.nl |
Contact | Support@broservicedesk.nl |
1. Inleiding
1.1. Voorwoord
Betrouwbare en toegankelijke informatie over de samenstelling en opbouw van de ondergrond is van groot belang voor een dichtbevolkt land als het onze. Het helpt overheden, bedrijven en burgers om op feiten gebaseerde beslissingen te nemen over het gebruik van de ondergrond, bijvoorbeeld in verband met bereikbaarheid, waterveiligheid, warmte- en koudeopslag, aardgasproductie en de winning van aardwarmte. Ook voorkomen we zo dat informatie dubbel worden ingewonnen omdat het niet centraal is geregistreerd. Het verzamelen, beschikbaar stellen, en gebruiken van al deze informatie is sinds september 2015 wettelijk vastgelegd in de Basisregistratie Ondergrond (BRO). Op 1 januari 2018 is het eerste deel van de Wet BRO in werking getreden, op 1 januari 2020 het tweede deel. Omdat de BRO onderdeel is van het Stelsel van Basisregistraties, is het verplicht gebruik van BRO-gegevens in werkprocessen van overheidsorganisaties opgenomen in de Wet BRO.
1.2. Doelstelling
Veel partijen hebben te maken met de BRO: bestuursorganen (overheden, Rijksdiensten), maar ook burgers en bedrijven. Uit gebruikersonderzoek is gebleken dat niet iedereen op de hoogte is van de verschillende uitgiftekanalen van BRO-gegevens en de functionele en technische mogelijkheden die deze kanalen bieden. Deze handreiking biedt daarom een laagdrempelige overzichtsbeschrijving van de BRO-uitgiftekanalen en geeft uitleg over het gebruik daarvan. Het ondersteunt daarmee overheden en bedrijfsleven in het maken van keuzes t.b.v. het gebruik (verplicht voor overheidsorganisaties) van BRO-gegevens in de dagelijkse praktijk. Vanuit dit document wordt verwezen naar meer gedetailleerdere informatie en documentatie over de individuele BRO-uitgiftekanalen.
1.3. Doelgroepen
Doelgroepen voor dit document zijn organisaties en personen die aan de afnamekant van de BRO opereren, waaronder bestuursorganen (bestuurders, beleidsmakers, BRO-coördinatoren) en bedrijven (ingenieurs, software-leveranciers).
1.4. Leeswijzer
In hoofdstuk 2 wordt een overzicht gegeven van de verschillende uitgiftekanalen van de BRO. In de daaropvolgende hoofdstukken volgt een meer gedetailleerde beschrijving van ieder uitgiftekanaal.
2. Overzicht van BRO Uitgiftekanalen
2.1. Inleiding
Dit hoofdstuk beschrijft de verschillende type afnemers en bijbehorende BRO-uitgiftekanalen
2.2. Afnemers
De afnemers van BRO-gegevens en modellen zijn onder te verdelen in 5 gebruikersgroepen:
Overheden (bestuursorganen, zowel uit oogpunt van gegevensbeheer als uit hergebruik)
Bedrijven vanuit de inhoud (landbouw, industrie, adviesbureaus, commercieel)
Bedrijven vanuit de ICT (softwareleveranciers, geo-informatie adviesbureaus)
Kennisinstellingen (lager-, middelbaar-, hoger onderwijs, onderzoeksinstellingen)
Burgers
Daarnaast zijn afnemers ook in te delen in gebruikers- "communities" (niet-limitatief):
Beleidsmakers (inhoudelijk experts die BRO-gegevens gebruiken t.b.v. voor beleidsvorming)
Planvormers (inhoudelijk experts die BRO-gegevens gebruiken t.b.v. het maken van omgevings-plannen en voor het uitvoeren van MER studies
Vergunningverleners (inhoudelijk experts die BRO-gegevens gebruiken t.b.v. vergunningverlening)
Ingenieurs bij bouwbedrijven en ingenieursbureaus (inhoudelijk experts die BRO-gegevens gebruiken bij het ontwerpen en realiseren van infrastructurele werken zoals wegen, bruggen, dijken)
Agrariërs (inhoudelijk experts die gebruik maken van de bodeminformatie in de BRO)
Hydrologen (inhoudelijk experts die BRO-gegevens gebruiken voor watermanagement en -winning)
Geologen (inhoudelijk experts die in het kader van olie- en gaswinning BRO-gegevens gebruiken)
Bodem(sanering)onderzoekers (inhoudelijk experts op het gebied van bodemsanering)
Beheerders van kabels en leidingen (inhoudelijk experts die kabels en leidingen beheren)
Archeologen (inhoudelijk experts die BRO-gegevens gebruiken t.b.v. archeologisch onderzoek)
Gegevensproducenten (inhoudelijk experts die BRO-gegevens produceren)
Softwareontwikkelaars (maken specifieke software t.b.v. gebruik door inhoudelijk experts)
Overige belangstellenden (burgers, wetenschappers, bedrijven)
2.3. Overzicht van uitgiftekanalen, behorend tot de Wet Bro
Er zijn vijf mogelijkheden om gegevens die in de Landelijke Voorziening BRO geregistreerd zijn op te vragen.
# | Uitgiftekanalen | Omschrijving | Doelgroep |
---|---|---|---|
1 | BROloket | Via het BROloket is het mogelijk de door de Wet BRO authentiek verklaarde gegevens en modellen m.b.t. de ondergrond te zoeken, te selecteren, te bekijken en te downloaden. | Het BROloket is vooral geschikt voor gebruikers die interactief BRO-gegevens willen zoeken, bekijken en downloaden. |
2a | BRO uitgifte Soap services | Via de BRO uitgifte Soap services is het mogelijk om volledig geautomatiseerd gegevens op te vragen uit de Landelijke Voorziening BRO. Via dit kanaal worden ook een aantal extra attributen uitgeleverd die specifiek bedoeld zijn voor de bronhouder, inwinner en leverancier van het betreffende object. De BRO uitgifte Soap services kunnen gebruikt worden om zowel "kenset" gegevens (basis attributen) als ook een "volledige set" (alle attributen) van registratieobjecten op te halen. | Vooral bedoeld voor softwareontwikkelaars, die via de BRO uitgifte Soap services gegevens afnemen en vervolgens beschikbaar stellen in systemen waarin deze BRO-gegevens nodig zijn. |
2b | BRO uitgifte REST services | Voor alle registratieobjecten die in de BRO zitten, zijn REST uitgifteservices ontwikkeld. Hiermee zijn de publieke data van de BRO te bekijken. Het grote voordeel van de REST services is dat geen PKI-certificaat nodig is, zoals bij de Soap services. Verder zijn de REST services zelf-beschrijvend via de zogenaamde OPEN API standaard. De uitgifte REST services zijn bedoeld voor "incidenteel" gebruik; niet geschikt voor uitgifte in bulk. | Het gebruik van de REST services is extra toegankelijk voor softwareontwikkelaars. De swagger-ui pagina geeft de mogelijkheid om de REST services uit te proberen en direct registratieobjecten te bekijken. |
3 | PDOK en Nationaal Georegister | Via Publieke Dienstverlening op de Kaart (PDOK) worden BRO-gegevens geleverd via OGC webservices voor direct gebruik in GIS systemen. Daarnaast worden datasets ook als één geheel (gehele Nederlandse grondgebied) uitgeleverd via bulk download services (ATOM feeds). | PDOK OGC services zijn met name bedoeld voor experts die Geografische Informatie Systemen (GIS) gebruiken. Deze GIS systemen kunnen direct gekoppeld worden met de OGC compliant BRO webservices van PDOK. |
4 | GDI Knooppunten | Afname via GDI (Generieke Digitale Infrastructuur) knooppunt van de overheid (o.a. Centraal Aansluitpunt, DSO Landelijke Voorziening) | Omgevingswet |
Belangrijkste kenmerken per kanaal.
# | Kanaal | Toegang | Update frequentie | Aanmelding nodig? | URL |
1 | BROloket | Open, gratis | Dagelijks ('s nachts) | Nee | |
2a | BRO uitgifte Soap services | Secure (PKI Overheid), gratis | Direct (instantaan) | Ja | https://basisregistratieondergrond.nl/inhoud-bro/aanleveren-opvragen/tools-tips/bro/ |
2b | BRO uitgifte REST services | Open, gratis | Direct (instantaan) | Nee | |
3 | PDOK en Nationaal Georegister | Open, gratis | Dagelijks ('s nachts) | Nee | |
4 | GDI Knooppunten | Secure (PKI Overheid, gratis | Direct (instantaan) | Ja | www.digitaleoverheid.nl (knooppunten en het stelsel van basisregistraties) |
2.4. Overige uitgiftekanalen, niet behorend tot de Wet Bro
De uitgiftekanalen benoemd in paragraaf 2.3 vallen onder de Wet Bro. Dat betekent dat het Ministerie van Volkshuisvesting en Ruimtelijke Ordening verantwoordelijk is voor de werking en kwaliteit van de uitgiftekanalen. Het ministerie is niet verantwoordelijk voor de kwaliteit van de gegevens, Dat zijn de bronhouders. Naast die uitgiftekanalen zijn er voorzieningen die BRO gegevens aanbieden. Het ministerie is niet verantwoordelijk voor deze voorzieningen.
# | Uitgiftekanalen | Omschrijving |
---|---|---|
1 | DINOloket | Het DINOloket bestaat uit een viewer waarmee BRO en NIET-BRO (DINO) gegevens c.q. modellen in samenhang bekeken en gedownload kunnen worden m.b.v. geografische en administratieve filters https://www.dinoloket.nl/over-ons |
2 | Bodemdata Loket | Het Bodemdata Loket (opvolger van het BISNL Loket) bestaat uit een viewer waarmee BRO en NIET-BRO (BISNL) gegevens c.q. modellen in samenhang bekeken en gedownload kunnen worden m.b.v. geografische en administratieve filters. |
3 | GIS pakketten | Dit zijn voorzieningen/pakketten waarin BRO gegevens worden aangeboden, gecombineerd met andere gegevens over de boven- en/of ondergrond, |
3. BROloket
3.1. Inleiding
Dit hoofdstuk beschrijft het uitgiftekanaal BROloket.
3.2. Algemene beschrijving
Dit loket bestaat uit een viewer waarmee BRO-gegevens c.q. modellen bekeken en gedownload kunnen worden m.b.v. geografische en administratieve filters. Het BROloket biedt ook specifieke functionaliteit op modellen voor het maken van bijvoorbeeld dwarsdoorsnedes en appelboringen.
3.2.1.1. BROloket versus DINOloket
Het BROloket stelt uitsluitend BRO gegevens en modellen beschikbaar. Gedurende het programma BRO zullen steeds meer gegevens, die op dit moment nog in DINO zijn opgeslagen, gemigreerd worden naar de BRO. Echter, niet alle gegevens kunnen gemigreerd worden naar de BRO in verband met de kwaliteitseisen die de BRO stelt. Gegevens in DINO die niet geconverteerd kunnen worden naar de BRO en dus in DINO achterblijven, zullen i.c.m. BRO-gegevens via het DINOloket ontsloten blijven worden.
3.2.1. Gebruik in de praktijk
3.2.2. Toegang tot het kanaal
Het BROloket is een webapplicatie en bereikbaar via de URL www.broloket.nl.
3.2.3. Primaire doelgroep
Inhoudelijk deskundigen uit het werkveld ondergrond.
3.2.4. Gegevens en Formaten
De volgende gegevens en formaten worden via dit kanaal verstrekt. Individuele onderzoeken kunnen worden gedownload via de knop 'download grafiek'. Een selectie van onderzoeken kunnen worden aangevraagd en gedownload via een link in het ontvangen mailbericht. Bij selectie van onderzoeken worden de gegevens in XML formaat geleverd.
RO of Deel-RO | Mnemonic (afkorting) | Formaat |
---|---|---|
Geotechnisch sondeeronderzoek | CPT | Individueel onderzoek: |
Grondwatermonitoringput | GMW | Individuele put: |
Grondwatermonitoringnet Zichtbaar via een grondwatermonitoringput | GMN | Individueel onderzoek: |
Grondwaterstandonderzoek Zichtbaar via een grondwatermonitoringput | GLD | Individueel onderzoek: |
Grondwatersamenstellingsonderzoek Zichtbaar via een grondwatermonitoringput | GAR | Individueel onderzoek: |
Formatieweerstandonderzoek Zichtbaar via een grondwatermonitoringput | FRD | Individueel onderzoek: |
Bodemkundig Booronderzoek | BHR-P | Individueel onderzoek: |
Geotechnische booronderzoek (Boormonsterbeschrijving en Boormonsteranalyse) | BHR-GT | Individueel onderzoek: |
Geologisch booronderzoek Inwerkingtreding 1 juli 2021 | BHR-G | Nog in ontwikkeling |
Bodemkundig Wandonderzoek | SFR | Individueel onderzoek: |
Bodemkaart | SGM | ZIP (Geopackage) (download) |
Geomorfologische kaart | GMM | ZIP (Geopackage) (download) |
GeoTOP (Model) | GTM | ZIP (Modelgegevens in ArcGIS formaat (MXD, IMG, XLS)) |
Digitaal Geologisch Model | DGM | ZIP (Modelgegevens in ArcGIS formaat (MXD, IMG, XLS)) |
REGIS II (Model) | HGM | ZIP (Modelgegevens in ArcGIS formaat (MXD, IMG, XLS)) |
Grondwatergebruiksysteem | GUF | Individueel onderzoek |
Grondwaterproductiedossier | GPD | Individueel onderzoek |
Mijnbouwwetvergunning | EPL | Individueel onderzoek |
Mijnbouwconstructie | EPC | Individueel onderzoek |
3.2.5. Functionaliteit
BROloket biedt de volgende functionaliteit
# | Applicatie Onderdeel | Functionaliteit | Toelichting |
---|---|---|---|
1a | Loket voor Gegevens | Selecteren | Geografisch en/of inhoudelijk selectie |
1b | Loket voor Gegevens | Viewen | Bekijken van BRO-gegevens |
1c | Loket voor Gegevens | Download | Download na filter (attribuut of geografisch) |
2a | Loket voor Modellen | Selecteren | Geografisch en/of inhoudelijk selectie |
2b | Loket voor Modellen | Viewen | Bekijken van BRO modellen |
2c | Loket voor Modellen | Download | Download na filter (attribuut of geografisch) |
2d | Loket voor Modellen | Appelboor | Model voorspellingen op een bepaalde locatie |
2e | Loket voor Modellen | Dwarsdoorsnede | Model voorspellingen op een transect |
3.3. Meer informatie
Meer informatie over dit kanaal is beschikbaar op https://basisregistratieondergrond.nl/werken-bro/producten-diensten/broloket/ en https://www.broloket.nl/snelstart-ondergrondgegevens .
4. BRO uitgifte Soap services
4.1. Inleiding
Dit hoofdstuk beschrijft het uitgiftekanaal BRO uitgifte Soap services. Er zijn twee typen Soap services:
Soap services die wij niet publiekelijk beschikbaar stellen, alleen via een PKI overheid certificaat, zie paragraaf 4.3;
Soap services die wij wel publiekelijk beschikbaar stellen , in de vorm van REST services, zie paragraaf 4.4.
4.2. Algemene beschrijving
Via de BRO uitgifte Soap services kunnen volledig geautomatiseerd BRO-gegevens worden opgevraagd. Zodra gegevens in de BRO worden geregistreerd, zijn deze direct (instantaan) via de BRO uitgifte Soap services beschikbaar. Via dit kanaal worden ook een aantal extra attributen (KvK-nummers van de inwinner en de leverancier) uitgeleverd die specifiek bedoeld zijn voor de bronhouder en/of de leverancier van het betreffende object. De BRO uitgifte Soap services zijn vooral geschikt voor "machine-to-machine" gegevensuitwisseling met afnemende softwaresystemen.
4.3. Gebruik van niet publiekelijk beschikbare Soap services
Deze paragraaf beschrijft hoe deze Soap services in de praktijk kunnen worden gebruikt.
4.3.1. Toegang tot het kanaal
De BRO uitgifte Soap services zijn bereikbaar via de URL Gegevens opvragen via de SOAP webservices - Basisregistratieondergrond. Voor het gebruik van deze services is een PKI overheid certificaat benodigd.
4.3.2. Primaire doelgroep
Leveranciers van softwaresystemen die gebruikt worden in het werkveld ondergrond.
4.3.3. Gegevens en Formaten
De volgende gegevens en formaten worden via dit kanaal verstrekt.
Mnemonic (afkorting) | Formaat | Verkrijging | |
Geotechnisch sondeeronderzoek | CPT | IMBRO XML | Secure SOAP Service* |
Grondwatermonitoringput | GMW | IMBRO XML | Secure SOAP Service* |
Bodemkundig Booronderzoek | BHR-P | IMBRO XML | Secure SOAP Service* |
Geotechnisch booronderzoek (boormonsterbeschrijving + boormonsteranalyse) | BHR-GT | IMBRO XML | Secure SOAP Service* |
Bodemkundig Wandonderzoek | SFR | IMBRO XML | Secure SOAP Service* |
Geologisch booronderzoek | BHR-G | IMBRO XML | Nog in ontwikkeling |
Grondwaterstandonderzoek | GLD | IMBRO XML | Secure SOAP Service* |
Grondwatermonitoringnet | GMN | IMBRO XML | Secure SOAP Service* |
Grondwatersamenstellingsonderzoek | GAR | IMBRO XML | Secure SOAP Service* |
Formatieweerstandonderzoek | FRD | IMBRO XML | Secure SOAP Service* |
Grondwatergebruiksysteem | GUF | IMBRO XML | Secure SOAP Service* |
Grondwaterproductiedossier | GPD | IMBRO XML | Secure SOAP Service* |
* Aanmelden bij de BRO is hiervoor noodzakelijk. Ook heeft u een PKI Overheid certificaat nodig.
BRO Modellen: gezien de aard van BRO Modellen worden deze niet via de BRO uitgifte Soap services beschikbaar gesteld.
4.3.4. Functionaliteit
Op basis van query's (filters) op de SOAP service kunnen de benodigde gegevens worden gedownload.
4.3.5. Replace with actual URL
In de voorbeeldberichten van de SOAP uitgiftewebservice vind je onderaan de notitie “replace with actual URL”. Een voorbeeld van zo’n URL is:
https://www.broservices.nl/wus/dsgmw-v1.1
Dit is het endpoint voor de SOAP uitgiftewebservice van geotechnisch booronderzoek (BHR-GT). Alle URLs zijn op dezelfde manier opgebouwd. Met behulp van de schema locaties kun je de URL van de andere registratieobjecten zelf afleiden. Hieronder zie je hoe de URL opgebouwd is:
4.3.6. Meer informatie
Meer informatie over dit kanaal is beschikbaar op https://basisregistratieondergrond.nl/werken-bro/producten-diensten/bro/ .
4.4. BRO uitgifte via REST services (publiekelijk beschikbaar)
Voor alle registratieobjecten die in de BRO zitten, zijn REST uitgifteservices ontwikkeld. Hiermee kunt u de publieke data van de BRO bekijken. Voor toegang tot deze Soap services is geen PKI overheid certificaat nodig.
Het grote voordeel van de REST services(verwijst naar een andere website) is dat geen PKI-certificaat nodig is, zoals bij de SOAP webservices van de BRO(verwijst naar een andere website) . Verder zijn de REST services zelf-beschrijvend via de zogenaamde OPEN API standaard. Dat maakt het gebruik van de REST services extra toegankelijk voor softwareontwikkelaars. De swagger-ui pagina geeft de mogelijkheid om de REST services uit te proberen en direct registratieobjecten te bekijken.
Met de REST services kunt u de publieke data van de BRO bekijken. Op dit moment zijn het allemaal uitgifteservices. De uitgifte REST services zijn bedoeld voor ‘incidenteel’ gebruik, bijvoorbeeld voor het opvragen van een kleine set van registratieobjecten is deze service geschikt. Een kleine set is bijvoorbeeld de start registratie van objecten met materiële geschiedenis (zoals bij grondwatermonitoringput of grondwatermonitoringnet) of de registraties van objecten zonder materiële geschiedenis. Voor het opvragen van grote sets van registratieobjecten van de BRO is een Atom feed beschikbaar bij PDOK.
Op de pagina URL's publieke REST services zijn alle beschikbare REST uitgifteservices die beschikbaar zijn aangegeven.
5. PDOK
5.1. Inleiding
Dit hoofdstuk beschrijft het uitgiftekanaal PDOK.
5.2. Algemene beschrijving
Publieke Dienstverlening Op de Kaart (PDOK) is een centrale voorziening voor het ontsluiten van geo-datasets van de overheid. PDOK biedt een ruime keuze aan actuele, betrouwbare en altijd beschikbare digitale geo-informatie van de overheid, waaronder sinds 2018 ook BRO-gegevens c.q. modellen. Deze zijn opvraagbaar via Open Geospatial Consortium (OGC) compliant webservices (zie APPENDIX 1 en APPENDIX 2) en ATOM feeds (bulk downloads in de vorm van gezipte bestanden), in lijn met overige geo-basisregistraties zoals BRT, BGT, BAG en BRK. Naast webservices biedt PDOK ook een eenvoudige viewer applicatie waarmee een gebruiker snel een beeld kan krijgen van het gegevensaanbod van PDOK. PDOK BRO webservices zijn open en kosteloos te gebruiken door overheden, bedrijven en burgers.
5.3. Gebruik in de praktijk
Deze paragraaf beschrijft hoe PDOK in de praktijk gebruikt kan worden.
5.3.1. Toegang tot het kanaal
De algemene website van PDOK is bereikbaar via www.pdok.nl. De PDOK OGC en ATOM webservices zijn bereikbaar via de pdok datasets www.pdok.nl/basisregistratie-ondergrond en vindbaar via nationaalgeoregister.nl/BRO.
De PDOK Viewer is bereikbaar via PDOK Viewer.
5.3.2. Primaire doelgroep
Personen binnen overheid of bedrijfsleven die gebruik maken van GIS systemen. Ook burgers kunnen de PDOK services en PDOK viewer gebruiken. Systemen in de BRO-keten (m.n. het Bronhouderportaal BRO) maken ook gebruik van PDOK webservices.
5.3.3. Gegevens en Formaten
Op dit moment worden onderstaande BRO registratieobjecten via PDOK ontsloten.
Mnemonic (afkorting) | Formaat | Verkrijging | |
Geotechnisch sondeeronderzoek | CPT | ZIP (Geopackage) | ATOM feed |
Grondwatermonitoringput | GMW | ZIP (Geopackage) | ATOM feed |
Grondwaterstandonderzoek De datasets GLD, GMN en GAR worden niet per WMS ontsloten, omdat de datasets geen locatiegegevens bevatten. De gegevens horen bij de grondwatermonitoringputten die via de GMW beschikbaar zijn. | GLD | ZIP (Geopackage) | ATOM feed |
Grondwatermonitoringnet | GMN | ZIP (Geopackage) | ATOM feed |
Grondwatersamenstellingsonderzoek | GAR | ZIP (Geopackage) | ATOM feed |
Formatieweerstandonderzoek | FRD | ZIP (Geopackage) | ATOM feed |
Bodemkundig Booronderzoek | BHR-P | ZIP (Geopackage) | ATOM feed |
Geotechnisch Booronderzoek | BHR-GT | ZIP (Geopackage) | ATOM feed |
Bodemkundig Wandonderzoek v1 | SFR | ZIP (Geopackage) | ATOM feed |
Geologisch booronderzoek | BHR-G | Nog in ontwikkeling | Nog in ontwikkeling |
Bodemkaart | SGM | ZIP (Geopackage) | ATOM feed |
Geomorfologische kaart | GMM | ZIP (Geopackage) | ATOM feed |
GeoTOP (Model) | GTM | ZIP (Modelgegevens in ArcGIS formaat (MXD, IMG, XLS | ATOM feed |
Digitaal Geologisch Model | DGM | ZIP (Modelgegevens in ArcGIS formaat (MXD, IMG, XLS)) | ATOM feed |
REGIS II (Model) | HGM | ZIP (Modelgegevens in ArcGIS formaat (MXD, IMG, XLS)) | ATOM feed |
INSPIRE dataset Environmental monitoring facilities | EF | ZIP (Geopackage) GML | ATOM feed |
INSPIRE dataset Hydrogeology | HG | ZIP (Geopackage) GML | ATOM feed |
Grondwatergebruiksysteem | GUF | ZIP (Geopackage) GML | - |
Grondwaterproductiedossier | GPD | ZIP (Geopackage) GML | - |
5.3.4. Gebruik van de PDOK viewer
De PDOK Viewer (PDOK Viewer) toont het beeld van zeer veel PDOK webservices die u kunt gebruiken. U krijgt daarmee vooraf een indruk van het kaartbeeld en de inhoud van de webservices. Doel van deze viewer is om u te laten zien welke webservices door PDOK worden aangeboden en om zo uw keus voor een bepaalde webservice makkelijker te maken. In de viewer wordt getoond welke geo-informatie beschikbaar is. Deze webservices kunt u vervolgens binnenhalen in uw eigen GIS-applicatie. U kunt dit doen door de gewenste services op te zoeken in het overzicht op de website van PDOK. U kopieert vervolgens de link van de betreffende WMS service naar uw GIS-applicatie. In tegenstelling tot het BRO-loket is de PDOK-viewer dus geen maatwerk viewer die allerlei detailinformatie toont.
5.3.5. Gebruik van OGC Webservices en ATOM feeds in GIS
Het gebruik van OGC webservices in GIS pakketten is nader beschreven op https://pdok-ngr.readthedocs.io/services.html en https://www.pdok.nl/how-to-faq1.
Door ondergrondgegevens via OGC webservices op te nemen in GIS pakketten kunnen de gegevens gecombineerd worden met andere gegevens. De gegevens kunnen worden bekeken, maar niet verwerkt. Door ondergrondgegevens via een ATOM feed in te lezen in een GIS pakket, kunnen de ondergrondgegevens gecombineerd worden met andere gegevens en vooral ook worden geanalyseerd.
5.3.6. Nationaal Georegister en PDOK
Het Nationaal Georegister (onderdeel van PDOK) bevat metadata beschrijvingen van geografische datasets en webservices in Nederland. Ook de PDOK datasets en webservices, waaronder de BRO datasets en webservices, zijn beschreven in het NGR (www.nationaalgeoregister.nl). Het NGR stelt metadata beschikbaar via een OGC:CSW webservice en via een user interface (zie Appendix 3).
5.4. Meer informatie
Meer informatie over dit kanaal is beschikbaar op https://basisregistratieondergrond.nl/werken-bro/producten-diensten/pdok/
6. Appendix 1 Open Geospatial Consortium (OGC) Webservices
De Nederlandse geo-infrastructuur PDOK ontsluit gegevens middels een aantal Open Geospatial Consortium (OGC) standaarden. De Open Geospatial Consortium (OGC) is een internationale organisatie die de leiding heeft in de ontwikkeling van interoperabele standaarden voor geografische diensten. De belangrijkste OGC standaarden in gebruik in Nederland zijn:
Web Map Service (WMS) NB Alleen de Web Map Service is op dit moment voor de datasets van de BRO van toepassing. – deze zogenaamde viewservice genereert een statische kaartuitsnede van geo-informatie in een image formaat zoals PNG, GIF of JPEG
Web Feature Service (WFS) – deze zogenaamde download service is een protocol voor het opvragen van geografische VECTOR data en de daarbij behorende attributen, al dan niet via een ruimtelijk filter. Gegevens worden uitgeleverd in GML formaat
Web Coverage Service (WCS) – deze zogenaamde download service is een protocol voor het opvragen van geografische RASTER data en de daarbij behorende attributen, al dan niet via een ruimtelijk filter (vooral voor BRO modellen van belang). Gegevens worden uitgeleverd in GeoTIFF of JPEG2000 (lossless compression) formaat
Zie https://pdok-ngr.readthedocs.io/services.html voor een uitgebreide uitleg van OGC services. Voor het gebruik van OCG services in GIS pakketten zie https://pdok-ngr.readthedocs.io/services.html en https://www.pdok.nl/how-to-faq1
7. Appendix 2 ATOM feed Webservices
BRO datasets worden als één geheel (landsdekkend) als downloadbare bestanden aangeboden via ATOM Feeds. ATOM Feeds zijn webfeeds die, net zoals RSS, geabonneerde gebruikers automatisch op de hoogte brengen van nieuwe releases en updates.
Een ATOM Feed bestaat uit een XML-bestand met een doorverwijzing (hyperlink) naar een download bestand (ZIP-file met gegevens), zie onderstaand voorbeeld. In de XML is beperkt metadata opgenomen over het ZIP-bestand. BRO-gegevens zijn ook beschikbaar als ATOM Feeds via pdok.nl/basisregistratie-ondergrond (voor elke dataset, zie tabblad ATOM downloadservice).
De ATOM's hebben ook een gebruiksvriendelijke weergave in HTML gekregen waardoor ze bijvoorbeeld onderstaand scherm tonen:
De andere mogelijkheid is om de ATOM Feed te openen in een feed reader (bijv. Feedly) of Firefox om de bijgesloten ZIP-bestanden te downloaden. Indien deze niet beschikbaar zijn, is het bestand ook via de entry link element te downloaden, zie regels 9-10 in onderstaand voorbeeld.
<?xml version='1.0' encoding='UTF-8'?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:georss="http://www.georss.org/georss">
...
<entry>
<id>inspireadressen.zip</id>
<title type="text" xml:lang="nl">inspireadressen.zip</title>
<content type="text">Downloadgrootte: 1.4 GB</content>
<updated>2015-07-07T22:00:00.000Z</updated>
<link href=" http://geodata.nationaalgeoregister.nl/inspireadressen/extract/inspireadressen.zip "
rel="alternate" type="application/x-compressed" hreflang="nl" length="1517044532"/>
<link href=" http://geodata.nationaalgeoregister.nl/inspireadressen/extract/inspireadressen.zip "
hreflang="nl"/>
<rights type="text">Copyright (c) 2012, Kadaster en Openbare Registers</rights>
<category term="http://www.opengis.net/def/crs/EPSG/0/28992" label="Amersfoort / RD
New"/>
<georss:polygon>50.6 3.1 50.6 7.3 53.7 7.3 53.7 3.1 50.6 3.1</georss:polygon>
</entry>
</feed>
8. Appendix 3 Stappenplan opzoeken BRO gegevens in NGR
Stap 1: Zoek een service via zoekwoord:
Resultaat is een lijst van zoekresultaten wordt getoond:
Stap 2: Selecteer één zoekresultaat voor een bepaald BRO gegeven (WMS service of ATOM feed). Een uitgebreide servicebeschrijving wordt vervolgens getoond, inclusief de webservice URL:
Stap 3: Voeg de webservice URL vervolgens toe in een GIS pakket (copy-paste). De door de webservice gepubliceerde gegevens worden vervolgens zichtbaar in het GIS pakket.