API-register: Overzicht

Overzicht ondergrondse infrastructuur

Overzicht van de ligging van de kadastrale percelen in Nederland. Fungeert als schakel tussen terrein en registratie, vervult voor externe gebruiker vaak een referentiefunctie, een ondergrond ten opzichte waarvan de gebruiker eigen informatie kan vastleggen en presenteren. Een kadastrale kaart geeft slechts een indicatie van de ligging van de kadastrale grenzen. Er kunnen geen maten aan worden ontleend.

Overzicht van de ligging van de kadastrale percelen in Nederland. Fungeert als schakel tussen terrein en registratie, vervult voor externe gebruiker vaak een referentiefunctie, een ondergrond ten opzichte waarvan de gebruiker eigen informatie kan vastleggen en presenteren.

Met deze API is het mogelijk om gegevens uit de Kadastralekaart dataset te downloaden.

Dit document bevat alleen informatie m.b.t. het gebruik van deze API. De Kadastralekaart-modeldocumentatie met bijbehorend schema(xsd) kun je vinden op https://zakelijk.kadaster.nl/schemas.

Een stappenplan voor het downloaden via deze API staat hier beschreven.

Hieronder worden eerst een aantal algemene begrippen en concepten uitgelegd. Vervolgens wordt elk endpoint individueel beschreven.

Met de full endpoints Predefined en Custom kan de meest actuele stand gedownload worden. Op basis van deze endpoints kunnen geen mutaties opgehaald worden.

Een full predefined download is direct beschikbaar om te downloaden, is niet gefilterd op gebied en is niet gefilterd op featuretype.

Bij een custom download wordt een aanvraag gedaan waarin specifieke filters worden opgegeven m.b.t. de gewenste inhoud van de bestanden. De aanvraag wordt asynchroon behandeld op de server en de status van de aanvraag kan opgevraagd worden. Nadat de aanvraag voorbereid is op de server, kan het bestand gedownload worden.

In het request voor een Custom download kan (optioneel) een geofilter meegegeven worden. De waarde van dit geofilter moet voldoen aan het Well-known text (WKT) formaat. Alleen Polygon en MultiPolygon objecten zijn hierbij toegestaan, bovendien worden inner rings niet ondersteund. De coördinaten worden geïnterpreteerd volgens EPSG:28992.

Dit geofilter limiteert het gebied waarvoor gegevens in de download wordt opgenomen, maar het filter is niet exact. Dat betekent dat de download een overshoot aan objecten buiten de selectie kan bevatten.

In het request voor een Custom download moet (verplicht) opgegeven worden welke featuretypes in de download opgenomen moeten worden.

Delta endpoints zijn ervoor om eenmalig je eigen administratie op te bouwen (initiële levering) en deze periodiek bij te werken met de beschikbare wijzigingen.

Delta downloads bevatten alleen informatie over de featuretypes perceel en kadastralegrens, in tegenstelling tot de Full Downloads bevatten ze geen informatie m.b.t. de featuretypes pand en openbareruimtelabel.

1. Een beginstand wordt gedownload met het Delta Custom of Delta Predefined endpoint, door deze aan te roepen zonder parameter delta-id. De download bevat informatie over welke delta-id het betreft.
2. Periodiek (bij voorkeur dagelijks) wordt het Delta endpoint aangeroepen om de delta-id's op te halen welke sinds de bij stap 1 bepaalde delta-id zijn ontstaan.
3. Voor elke delta-id die in stap 2 gevonden wordt, wordt het Delta Custom of Delta Predefined endpoint aangeroepen met parameter delta-id. De inhoud van deze downloads bevat alleen de mutaties die hebben plaatsgevonden in die betreffende delta.

De opzet is hier gelijk aan de full predefined downloads. Echter kan aan het delta endpoint in het request optioneel de parameter delta-id worden opgegeven, zie stap 1 en 3 onder werkwijze.

De opzet is hier gelijk aan de full custom downloads. Echter kan aan het delta endpoint in het request optioneel de parameter delta-id worden opgegeven, zie stap 1 en 3 onder werkwijze.

Deze datasetserie bevat voor Nederland de toepassingsgebieden voor de KRM en het monitoringsprogramma Mariene strategie deel II. Voor deze gebieden voert Nederland in het kader van de artikel 8, 9 en 10 van de KRM assessments uit.

De OGC API Features service Kaderrichtlijn Mariene Strategie bevat het toepassingsgebied, de rapportage-eenheden en de bevroren monitoringsdata voor de Kaderrichtlijn Mariene Strategie.

Landelijke Voorziening Basisregistratie Ondergrond (BRO), weergave en extractie boorprofiel (Soil Assesment Data, SAD).

De PDOK Locatieserver is een open en gratis geocodeerservice waarmee gezocht kan worden op gegevens uit verschillende overheidsregistraties (bijvoorbeeld adressen, percelen en rijkswegen) om vervolgens doorgestuurd te worden naar de locatie van de zoekopdracht.

De Locatieserver bestaat uit meerdere RESTful API's die eenvoudig geïntegreerd kunnen worden in viewers en/of applicaties. De API's zijn open, gratis en bevatten gegevens uit verschillende overheidsregistraties zoals adressen (postcodes, straten, huisnummer), kadastrale percelen, wegen en hectometerpalen maar ook woonplaatsen, wijken, buurten en waterschappen. De onderliggende gegevens worden zeer frequent bijgewerkt.

De Locatieserver bestaat totaal uit vier RESTful API's die gepubliceerd worden volgens de Open API Specificatie https://api.pdok.nl/bzk/locatieserver/search/v3_1/ui/. Hiermee zijn de mogelijkheden van de Locatieserver API's (input en output) gedocumenteerd.

Het zoeken op gegevens wordt vereenvoudigd met behulp van de Suggest API die de mogelijkheid biedt om een (gedeelte van een) zoekopdracht op te voeren, waarnaar er suggesties teruggegeven worden. Dankzij slimme technieken als auto-aanvullen en ondersteuning van alternatieve schrijfwijzen en synoniemen vinden gebruikers snel waar ze naar op zoek zijn. Het is ook mogelijk om bij zoekopdrachten een locatie van de gebruiker mee te geven zodat suggesties op basis van die locatie worden gesorteerd.

Zodra er op basis van suggesties van de Suggest API een keuze is gemaakt, wordt de Lookup API aangeroepen, welke o.a. een (versimpelde) geometrie van de zoekopdracht teruggeeft. Hiermee kan een gebruiker naar de locatie van de zoekopdracht worden gestuurd op de kaart. Dankzij de highlight functie kan het betreffende gegeven (object) vervolgens worden opgelicht op de kaart.

De suggest- en de lookup API werken dus als een tweetrapsraket. Er is ook een mogelijkheid om vrij te zoeken (klassiek geocoderen) met de Free API waar zonder tussenkomst van suggesties de API direct resultaten teruggeeft op basis van de zoekopdracht.

De Reverse API biedt de mogelijkheid om een locatie (punt geometrie) op te geven om vervolgens verschillende gegevens in een range rondom deze locatie te ontvangen. Bijvoorbeeld het ophalen van alle adressen of wegen in de buurt (op basis van de opgegeven locatie). Dit wordt ook wel Reverse Geocoderen genoemd. Met de Reverse API kan je op basis van een coördinaat en een range (bijvoorbeeld 1 kilometer) de gewenste gegevens binnen die range opvragen en visualiseren.

De Locatieserver is primair een geocodeerservice. Voor andere doeleinden zoals het rechtstreeks opvragen van bepaalde gegevens of het downloaden van bulk data biedt PDOK andere mogelijkheden via webservices en/of downloads.

Meer informatie over de Locatieserver is ook te vinden op de Locatieserver Wiki op Github of volg discussies op het PDOK forum.

SIA (Signalen Informatievoorziening Amsterdam) meldingen

SIA (Signalen Informatievoorziening Amsterdam) meldingen