SOAP webservices

Er zijn meerdere mogelijkheden om gegevens die in de Landelijke Voorziening BRO geregistreerd zijn op te vragen. Een daarvan is via de SOAP webservices van de Landelijke Voorziening BRO.

Als u uw systeem aansluit op de SOAP webservices van de Landelijke Voorziening BRO, dan kunt u volledig geautomatiseerd BRO-gegevens opvragen. Zodra gegevens in de BRO zijn geregistreerd, zijn ze direct beschikbaar. Aanmelden bij de BRO is daarvoor noodzakelijk. Ook heeft u een PKIoverheid certificaat nodig. Lees meer daarover bij de instructie  voor het aansluiten op de SOAP webservice.

Een alternatief waarvoor geen PKI-certificaat nodig is, zijn de REST uitgifteservices.

SOAP webservices voor wie?

De SOAP webservices zijn met name geschikt voor organisaties die frequent en volledig geautomatiseerd bepaalde BRO-gegevens van een registratieobject willen opvragen. De SOAP webservices geven direct toegang tot de informatie zoals die in de Basisregistratie Ondergrond is opgeslagen.

Ook zijn de SOAP webservices handig voor bronhouders en dataleveranciers, die hun eigen BRO-gegevens willen opvragen. Bepaalde gegevens uit een brondocument zijn bovendien alleen voor de bronhouder en dataleverancier zichtbaar, zoals KvK-nummers en de eigen referentie die de leverancier of bronhouder aan een registratieobject meegegeven heeft. Dit geldt ook voor gegevens die uit registratie zijn genomen. Dat is ook de reden dat eenmalige authenticatie van de gebruiker (client) met het PKIoverheid-certificaat nodig is.

De modellen zijn nog niet op te vragen via de SOAP webservices.

Verschil met REST uitgifteservice

Organisaties die snel en alleen publieke data willen bekijken, kunnen gebruikmaken van REST uitgifteservices. Hiervoor is geen (PKI-)certificaat nodig. Voor het opvragen van een kleine set van registratieobjecten is deze service geschikt. Ook andere ontwikkelaars kunnen deze interface gebruiken en krijgen hiermee direct toegang tot de publieke data van de BRO. Verder is het op termijn mogelijk om publieke data met deze service te valideren.

Verschil met BROloket

Wilt u van een specifiek gebied alle metingen of onderzoeksgegevens direct bekijken? Ga dan naar het BROloket. U kunt daar alle informatie van de BRO-gegevens en BRO-modellen direct op de kaart raadplegen. BROloket biedt in die viewer bovendien praktische selectie- en filtermogelijkheden. U kunt interactief BRO-gegevens zoeken en in detail bekijken. Ook kunt u op BROloket de BRO-modellen interactief bekijken. Op BROloket kunt dus heel gericht zoeken. Ook is het downloaden van gegevens en modellen bij het BROloket mogelijk. In die downloads zit dan de volledige dataset van uw selectie op de kaart om in uw eigen applicatie verder te gebruiken.

Verschil met PDOK

Bij PDOK krijgt u landsdekkende datasets (bulkdownload) of kensets (kaartweergave via WMS). Die kensets zijn vooral geschikt om landsdekkend inzicht te krijgen in de beschikbare informatie, bijvoorbeeld: tot welke diepte gaan de sonderingen, hoeveel filters zitten er in grondwatermonitoringputten en op welke diepte. U kunt deze data in uw eigen GIS-applicatie verder gebruiken bekijken en aanvullen met andere data. Met de PDOK Viewer krijgt u een preview van de kensets. De bulkdownload bevat alle gegevens per geregistreerd object in de BRO (als Geopackage). Deze dataset is vooral geschikt voor periodieke download naar een eigen systeem om diepgaandere analyses op de data uit te voeren.


Doe een terugmelding

Twijfelt u over de juistheid van gegevens of de modellen? Doe een terugmelding.