API-register: Overzicht

De 3D Basisvoorziening is een verzameling van ruimtelijke bestanden die hoogte informatie bevatten. Deze bestanden (collecties) worden op verschillende manieren gegenereerd. Er zijn acht collecties beschikbaar. De 3D Basisvoorziening kan gebruikt worden op schaalniveaus tussen 1:500 en 1:10.000. De bestanden zijn o.a. gebaseerd op topografie uit de Basisregistratie Grootschalige Topografie (BGT), de gebouwen uit de Basisregistratie Adressen en Gebouwen (BAG), en hoogtes uit luchtfotobeelden en het Actueel Hoogtebestand Nederland (AHN4). Meer informatie over deze dataset en overige producten zoals het downloaden van deze dataset voor analysedoeleinden of een 3D Viewer zijn te vinden op de website van PDOK en in de productbeschrijving.

Berekening aan geluid vanwege weg- en railverkeer en industrie vereisen een 3D omgevingsmodel. Op deze pagina vindt u datasets om u te ondersteunen met het opstellen van het model. De dataset is in opdracht van het Ministerie van Infrastructuur en Waterstaat opgezet door een samenwerking tussen het Kadaster, RIVM en de TU Delft. Bij het samenstellen is gebruik gemaakt van de BAG, BGT en het AHN. Hierbij is grote zorg besteed om de databestanden zoveel als mogelijk aan te laten sluiten bij de fysieke werkelijkheid, maar er kunnen geen rechten aan ontleend worden. Zie voor meer informatie de uitgebreide productbeschrijving. Er zijn een drie soorten bestanden: hoogte, bodemvlakken en gebouwen. Deze zijn terug te vinden onder 'collections'.

De gegevens bestaan uit BAG-panden inclusief panden met de status 'gesloopt' en een deel van BAG-gegevens van deze panden met de zich daarin bevindende verblijfsobjecten en adresinformatie. Ook de ligplaatsen en standplaatsen zijn in de Vector Tiles opgenomen. Lees meer over de BAG en bekijk de BAG vector tiles in de Vectortile Viewer.

De gegevens bestaan uit BAG-panden inclusief panden met de status 'gesloopt' en een deelselectie van BAG-gegevens van deze panden en de zich daarin bevindende verblijfsobjecten. Ook de ligplaatsen en standplaatsen zijn hierin opgenomen met een deelselectie van BAG-gegevens. Lees meer over de BAG en bekijk de BAG vector tiles in de Vectortile Viewer.

BRP - Gewaspercelen bestaat uit de locatie van landbouwpercelen met daaraan gekoppeld het geteelde gewas. Het bestand is een selectie van informatie uit de Basisregistratie Percelen (BRP) van de Rijksdienst voor Ondernemend Nederland. De omgrenzingen van de landbouwpercelen zijn gebaseerd op het Agrarisch Areaal Nederland (AAN). De gebruiker van het perceel dient jaarlijks zijn gewaspercelen in te tekenen en aan te geven welk gewas wordt geteeld op het betreffende perceel. Van elk jaar wordt een dataset gegenereerd van peildatum 15 mei. Van de meest recente BRP gewaspercelen is een viewservices en een downloadservice beschikbaar.

De Basisregistratie Grootschalige Topografie (BGT) is de gedetailleerde grootschalige basiskaart (digitaal) van Nederland, waarin de ligging van alle fysieke objecten zoals gebouwen, wegen, water, spoorlijnen en (landbouw)terreinen is geregistreerd. Lees meer over de BGT en bekijk de BGT vector tiles in de Vectortile Viewer.

Deze API toont de Rijksmonumenten, Stads- en Dorpsgezichten en het Nederlandse UNESCO cultureel Werelderfgoed. De gegevens zijn conform INSPIRE geharmoniseerd en afkomstig van de Rijksdienst voor het Cultureel Erfgoed.

Overzicht van de bestuurlijke indeling van Nederland in gemeenten en provincies alsmede de rijksgrens. Gegevens zijn afgeleid uit de Basisregistratie Kadaster (BRK). Lees meer over de Bestuurlijke gebieden en bekijk de vector tiles in de Vectortile Viewer.

Met deze API is het mogelijk om gegevens uit de BGT dataset te downloaden. Deze BGT-gegevens zijn te downloaden voor gebruik in eigen GIS-software. De BGT-gegevens zijn als extract in GML of GML-light of Stuf-geo formaat te downloaden.

Dit document bevat alleen informatie m.b.t. het gebruik van deze API. De BGT-modeldocumentatie (IMGEO) met bijbehorend schema(xsd) en beschrijvingen van de download formaten kun je vinden op: https://www.geonovum.nl/geo-standaarden/bgt-imgeo.

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.

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.

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.

INSPIRE thema Bodemgebruik, gevuld met relevante objecten uit top10nl, beheerd door het Kadaster.