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'.

Data van Liander over Standaard Jaarverbruik (SJV) en aantal aansluitingen per postcode-range in de MRA. Het standaard jaarverbruik is het verwachte jaarverbruik voor gas op een aansluiting in een jaar met gemiddelde klimaatomstandigheden (standaardjaar). O&S heeft statistieken over deze data gegenereerd. Het aardgasverbruik van (delen van) enkele gemeentes in de MRA zit niet opgenomen in de gegevens van Liander, aangezien Stedin daar de regionale netbeheerder is van het aardgasnetwerk (Aalsmeer, Amstelveen, Beverwijk, Bloemendaal, Heemskerk, Heemstede, Ouder-Amstel, Uitgeest, Uithoorn en Zandvoort).

(Deels) gerealiseerde of geplande aardgasvrije buurten, en buurtinitiatieven voor aardgasvrij in Amsterdam

Alle locaties van afvalcontainers (ondergrondse afvalcontainers, bovengrondse afvalcontainers en rolcontainers) en betonputten van de Gemeente Amsterdam. De locaties worden dagelijks bijgewerkt en bevatten de fracties Rest, Papier, Glas en Textiel. Naast de objectinformatie zijn ook de weeggegevens beschikbaar.

Overzicht van informatie voor het aanbieden van afval per fractie per adres.

API van het API-register van developer.overheid.nl.

Untrusted clients hebben geen schrijfrechten maar wel leesrechten. Requests kunnen, ook vanuit de browser, eenvoudig gedaan worden door de verkregen API-key aan elke request mee te geven met de X-Api-Key header:

X-Api-Key: {API_KEY} (vervang {API_KEY} met de verkregen API-key)

Trusted clientst hebben zowel schrijfrechten als leesrechten. Bij elke request moet er een access_token meegestuurd worden. Deze token is 5 minuten geldig en kan verkregen worden door een POST request te doen naar https://auth.developer.overheid.nl/realms/don/protocol/openid-connect/token met de volgende Form URL Encoded body:

• grant_type: client_credentials
• scope: apis:write apis:read organisations:read
• client_id: {CLIENT_ID} (vervang {CLIENT_ID} met de client id die je van ons hebt ontvangen
• client_secret: {CLIENT_SECRET} (vervang {CLIENT_SECRET} met de client secret die je van ons hebt ontvangen

De verkregen access_token stuur je vervolgens op de volgende manier met de Authorization header naar een request mee:

Authorization: Bearer {ACCESS_TOKEN} (vervang {ACCESS_TOKEN} met de verkregen access_token)

Paginering bij collecties vindt plaats door middel van de Link header. Er zijn verschillende libraries beschikbaar (zoals parse-link-header voor Javascript) die deze header kan parsen. Verder geven de volgende headers extra houvast om paginering in de client te implementeren: X-Current-Page, X-Per-Page, X-Total-Count en X-Total-Pages.

Een API om een autorisatiecomponent (AC) te benaderen.

De AUTORISATIE is het kernobject in deze API. Autorisaties worden toegekend aan applicaties. Een applicatie is een representatie van een (web) app die communiceert met de API van (andere) componenten, zoals het ZRC, DRC, ZTC en BRC.

Deze API laat toe om autorisaties van een (taak)applicatie te beheren en uit te lezen.

Afhankelijkheden

Deze API is afhankelijk van:

• Notificaties API

Autorisatie

Deze API vereist autorisatie. Je kan de token-tool gebruiken om JWT-tokens te genereren.

Deze API publiceert notificaties op het kanaal autorisaties.

Main resource

applicatie

Kenmerken

Resources en acties

• applicatie: create, update, destroy

Handige links

• Documentatie
• Zaakgericht werken

De Basisregistratie adressen en gebouwen (BAG) bevat gegevens over panden, verblijfsobjecten, standplaatsen en ligplaatsen en de bijbehorende adressen (openbare ruimte, nummeraanduiding en woonplaats).