API-register: Overzicht

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.

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.

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

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.

Dit betreft een bestandsopname van het areaal mossel en oesterbanken op de droogvallende platen in de Waddenzee. Dit geschiedt jaarlijks. De opdrachtgever is de Directie Dierlijke Agroketens en Dierenwelzijn / Cluster Duurzame Visserijketens. De bestandsopname zelf wordt uitgevoerd door IMARES.

Percelen, in rijkseigendom, waarop mosselzaadinvanginstallaties zijn toegestaan. Een mosselzaadinvanginstallatie (MZI) is een in de bodem verankerde constructie bestaande uit touwen en netwerk, waarmee mosselbroed wordt ingevangen in de waterkolom. Dit mosselbroed (ook wel mosselzaad genoemd) wordt geoogst van de constructie en verder opgekweekt tot consumptiemosselen op schelpdierpercelen.

In deze dataset is de zogeheten common database of designated areas (cdda) weergegeven. Deze database is onderdeel van de jaarlijkse rapportage vanuit Nederland aan de EEA. De cdda bestaat uit de natura2000 gebieden, de nationale parken en het natuur netwerk nederland.

Nationaal Hydrologisch Instrumentarium (NHI) - netwerkschematisatie

Dit bestand geeft de grenzen van de Nationale Parken weer, zoals die door de Secretarissen van de Parken zijn aangegeven in de periode augustus 2005 - november 2005, met een update in januari 2007 en in augustus 2007. Op de grenzen van NP Drents-Friese Wold volgt nog een correctie. Het bestand bevat in totaal 21 Nationale Parken: 18 door de Minister van LNV vastgestelde Parken (waarvan 1 in oprichting), 2 Particuliere Parken en 1 grensoverschrijdend Park, vastgesteld door het Commité van Ministers van de Benelux. Daarnaast komen in het GIS-bestand 'uitwerkingsgebieden' voor. Dit zijn gebieden die bij voorkeur op termijn onderdeel moeten gaan uitmaken van een Nationaal Park, maar nu nog niet zijn aangewezen. Ze maken dan ook GEEN deel uit van het betreffende Park en hebben geen enkele status! De grenzen in het GIS-bestand kunnen afwijken van de grenzen in het BIP (Beheers- en Inrichtingsplan). Elk Nationaal Park heeft een BIP, dat ter goedkeuring wordt voorgelegd aan de Minister van LNV. Elk BIP bevat een kaart met de begrenzing van het Park. Die grens is een momentopname. In de loop der tijd kunnen de grenzen van een Park licht wijzigen door kleine aankopen of uitruil van gronden. Die wijzigingen worden bij periodieke updates doorgevoerd in het BIP. Een BIP kan daardoor achter- of juist vooruitlopen op de grenzen in dit bestand.

In deze dataset zijn de voor Nederland als INSPIRE aangemerkte bestanden in het thema Beschermde gebieden opgenomen. De dataset bevat de beschermde gebieden: Nationale Parken, (data eigenaar het Ministerie van Economische Zaken). De beschermde gebieden datasets Natura2000 en Rijksmonumenten worden separaat aangeboden.