Introductie API Keys

Het Dataplatform van de gemeente Amsterdam gaat het gebruik van een identificatie key bij het aanroepen van haar API's vanaf 1 februari 2024 verplicht stellen. Vanaf 1 februari 2024 kun je de API's van het Dataplatform niet meer zonder een key gebruiken. Vraag tijdig een key aan via dit aanvraagformulier. Doe je dit niet, dan werkt je applicatie of website vanaf 1 februari 2024 niet meer. Dit geldt voor alle API's die op deze pagina gedocumenteerd zijn.

Door de API key kunnen we contact houden met de gebruikers van onze API's. Zo kunnen we gebruikers informeren over updates. Daarnaast krijgen we hiermee inzicht in het gebruik van de API's en in wie welke dataset via de API bevraagt. Ook voor dataeigenaren is dit waardevolle informatie.

Meer info:
Pagina API key aanvragen
Technische documentatie
Vragen? Mail naar dataplatform@amsterdam.nl

Geometrie projecties

De geometrie velden worden standaard teruggegeven in de projectie van de originele bron. Dit is veelal de rijksdriehoekscoördinaten (Amersfoort / RD New). Met de Accept-Crs header kan opgegeven worden met welke transformatie alle geometriewaarden teruggegeven moet worden. Bijvoorbeeld:

curl -H "Accept-Crs: EPSG:28992" https://api.data.amsterdam.nl/v1/gebieden/buurten/

Veelgebruikte projecties zijn:

Projectie Toelichting
EPSG:28992 Nederlandse rijksdriehoekscoördinaten (RD New).
EPSG:4258 ETRS89, Europese projectie.
EPSG:3857 Pseudo-Mercator (vergelijkbaar met Google Maps)
EPSG:4326 WGS 84 latitude-longitude, wereldwijd.

De andere notatievormen (zoals urn:ogc:def:crs:EPSG::4326 en www.opengis.net URI's) worden ook ondersteund.