Het Dataplatform van gemeente Amsterdam gaat het gebruik van een API key bij het gebruik van API's verplicht stellen. Hiermee wil het Dataplatform inzicht krijgen wie gebruik maakt van haar APIs, zodat het Dataplatform kan communiceren over updates en wijzigingen in de API's. Eventuele wijzigingen in de API's kunnen dan tijdig geïmplementeerd worden in uw systemen. Dit gaat gelden voor alle zogenaamde 'DSO API's' van het Dataplatform van gemeente Amsterdam.

Het gebruik van een API key bij de aanroep van een API van het Dataplatform van gemeente Amsterdam is vanaf half september optioneel. In overleg met de dataorganisatie wordt een deadline vastgesteld voor het moment vanaf wanneer de API keys verplicht worden. U kunt de API's van het Dataplatform dan niet meer gebruiken zonder een API key mee te geven.

Dit heeft gevolgen voor uw systemen!

Vraag tijdig een API key aan om uw systemen hierop aan te passen. U kunt met dit formulier een API key aanvragen.

NAP

ID:
nap
Versie:
default
Autorisatie:
Geen; dit is openbare data.
Licentie:
-
Eigenaar:
Basisinformatie
Uitgever:
Datateam Basis- en Kernregistraties
Productie:
Kadaster en Rijkswaterstaat
Bronhouder:
gebruik.basisinformatie@amsterdam.nl

Endpoints

REST OpenAPI:
/v1/nap
WFS kaartlaag:
/v1/wfs/nap
MVT kaartlaag:
/v1/mvt/nap

Tabellen

Peilmerken

Autorisatie:
Geen; dit is openbare data.
REST URI:
/v1/nap/peilmerken
CSV-export:
/v1/nap/peilmerken?_format=csv
GeoJSON-export:
/v1/nap/peilmerken?_format=geojson

De volgende velden zijn beschikbaar:

Veldnaam Type Identifier Omschrijving
identificatie String ☑ Unieke identificatie van het peilmerk
hoogteTovNap Number Gemeten hoogte van het peilmerk t.o.v. NAP (m)
jaar Integer Het jaar van waterpassing, behorende bij de hoogte
merkCode String Gebruikte peilmerk code
merkOmschrijving String Gebruikte peilmerk omschrijving
omschrijving String Beschrijving van het object waarin het peilmerk zich bevindt
windrichting String De windrichting van het muurvlak is die zijde waarheen het vlak van de muur, waarin het peilmerk zich bevindt, is gericht. Is er 'Z' aangegeven, dan ligt het betreffende muurvlak op het zuiden
xCoordinaatMuurvlak Number De muurvlakcoördinaten (in centimeters) geven de positie aan van het peilmerk op het betreffende muurvlak. De horizontale maat (x) is de maat ten opzichte van een van de uiteinden van het muurvlak
yCoordinaatMuurvlak Number De muurvlakcoördinaten (in centimeters) geven de positie aan van het peilmerk op het betreffende muurvlak. De verticale maat (y) is de maat ten opzichte van het ondereinde van het muurvlak (positief) of ten opzichte van het boveneinde van het muurvlak (negatief)
rwsNummer String Nummer dat Rijkswaterstaat hanteert voor een meetbout
geometrie Geometry Vorm en ligging van het object in het stelsel van de Rijksdriehoekmeting (RD)
statusCode Integer Status van het peilmerk code
statusOmschrijving String Status van het referentiepunt (1=actueel, 2=niet te meten, 3=vervallen) omschrijving
vervaldatum Date Vervaldatum van het peilmerk
ligtInBouwblok Object (relatie) Het bouwblok waarbinnen het peilmerk ligt
ligtInBouwblok.identificatie String (relatie) Het bouwblok waarbinnen het peilmerk ligt
ligtInBouwblok.volgnummer Integer (relatie) Het bouwblok waarbinnen het peilmerk ligt
publiceerbaar Boolean Indicatie die aangeeft of de informatie gepubliceerd mag worden

De volgende query-parameters zijn te gebruiken:

Parameter Autorisatie Mogelijke waarden Werking
geometrie GeoJSON of GEOMETRY(x y ...) Test op exacte waarde (==)
geometrie[intersects] GeoJSON of POLYGON(x y ...) Test of er een intersectie is met de waarde.
geometrie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
geometrie[not] Test of waarde niet overeenkomt (!=).
geometrie[contains] Kommagescheiden lijst Test of er een intersectie is met de waarde.
hoogteTovNap Getal Test op exacte waarde (==)
hoogteTovNap[lte] Test op kleiner dan of gelijk (<=).
hoogteTovNap[lt] Test op kleiner dan (<).
hoogteTovNap[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
hoogteTovNap[gt] Test op groter dan (>).
hoogteTovNap[gte] Test op groter dan of gelijk (>=).
hoogteTovNap[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
hoogteTovNap[not] Test of waarde niet overeenkomt (!=).
identificatie Tekst Test op exacte waarde (==)
identificatie[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
identificatie[isempty] true | false Test of de waarde leeg is (== '' / != '')
identificatie[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
identificatie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
identificatie[not] Test of waarde niet overeenkomt (!=).
jaar Geheel getal Test op exacte waarde (==)
jaar[lte] Test op kleiner dan of gelijk (<=).
jaar[lt] Test op kleiner dan (<).
jaar[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
jaar[gt] Test op groter dan (>).
jaar[gte] Test op groter dan of gelijk (>=).
jaar[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
jaar[not] Test of waarde niet overeenkomt (!=).
ligtInBouwblok.identificatie Tekst Test op exacte waarde (==)
ligtInBouwblok.identificatie[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
ligtInBouwblok.identificatie[isempty] true | false Test of de waarde leeg is (== '' / != '')
ligtInBouwblok.identificatie[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
ligtInBouwblok.identificatie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
ligtInBouwblok.identificatie[not] Test of waarde niet overeenkomt (!=).
ligtInBouwblok.volgnummer Geheel getal Test op exacte waarde (==)
ligtInBouwblok.volgnummer[lte] Test op kleiner dan of gelijk (<=).
ligtInBouwblok.volgnummer[lt] Test op kleiner dan (<).
ligtInBouwblok.volgnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
ligtInBouwblok.volgnummer[gt] Test op groter dan (>).
ligtInBouwblok.volgnummer[gte] Test op groter dan of gelijk (>=).
ligtInBouwblok.volgnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
ligtInBouwblok.volgnummer[not] Test of waarde niet overeenkomt (!=).
merkCode Tekst Test op exacte waarde (==)
merkCode[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
merkCode[isempty] true | false Test of de waarde leeg is (== '' / != '')
merkCode[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
merkCode[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
merkCode[not] Test of waarde niet overeenkomt (!=).
merkOmschrijving Tekst Test op exacte waarde (==)
merkOmschrijving[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
merkOmschrijving[isempty] true | false Test of de waarde leeg is (== '' / != '')
merkOmschrijving[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
merkOmschrijving[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
merkOmschrijving[not] Test of waarde niet overeenkomt (!=).
omschrijving Tekst Test op exacte waarde (==)
omschrijving[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
omschrijving[isempty] true | false Test of de waarde leeg is (== '' / != '')
omschrijving[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
omschrijving[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
omschrijving[not] Test of waarde niet overeenkomt (!=).
publiceerbaar true | false Test op exacte waarde (==)
publiceerbaar[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
rwsNummer Tekst Test op exacte waarde (==)
rwsNummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
rwsNummer[isempty] true | false Test of de waarde leeg is (== '' / != '')
rwsNummer[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
rwsNummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
rwsNummer[not] Test of waarde niet overeenkomt (!=).
statusCode Geheel getal Test op exacte waarde (==)
statusCode[lte] Test op kleiner dan of gelijk (<=).
statusCode[lt] Test op kleiner dan (<).
statusCode[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
statusCode[gt] Test op groter dan (>).
statusCode[gte] Test op groter dan of gelijk (>=).
statusCode[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
statusCode[not] Test of waarde niet overeenkomt (!=).
statusOmschrijving Tekst Test op exacte waarde (==)
statusOmschrijving[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
statusOmschrijving[isempty] true | false Test of de waarde leeg is (== '' / != '')
statusOmschrijving[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
statusOmschrijving[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
statusOmschrijving[not] Test of waarde niet overeenkomt (!=).
vervaldatum yyyy-mm-dd Test op exacte waarde (==)
vervaldatum[lte] Test op kleiner dan of gelijk (<=).
vervaldatum[lt] Test op kleiner dan (<).
vervaldatum[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
vervaldatum[gt] Test op groter dan (>).
vervaldatum[gte] Test op groter dan of gelijk (>=).
vervaldatum[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
vervaldatum[not] Test of waarde niet overeenkomt (!=).
windrichting Tekst Test op exacte waarde (==)
windrichting[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
windrichting[isempty] true | false Test of de waarde leeg is (== '' / != '')
windrichting[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
windrichting[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
windrichting[not] Test of waarde niet overeenkomt (!=).
xCoordinaatMuurvlak Getal Test op exacte waarde (==)
xCoordinaatMuurvlak[lte] Test op kleiner dan of gelijk (<=).
xCoordinaatMuurvlak[lt] Test op kleiner dan (<).
xCoordinaatMuurvlak[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
xCoordinaatMuurvlak[gt] Test op groter dan (>).
xCoordinaatMuurvlak[gte] Test op groter dan of gelijk (>=).
xCoordinaatMuurvlak[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
xCoordinaatMuurvlak[not] Test of waarde niet overeenkomt (!=).
yCoordinaatMuurvlak Getal Test op exacte waarde (==)
yCoordinaatMuurvlak[lte] Test op kleiner dan of gelijk (<=).
yCoordinaatMuurvlak[lt] Test op kleiner dan (<).
yCoordinaatMuurvlak[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
yCoordinaatMuurvlak[gt] Test op groter dan (>).
yCoordinaatMuurvlak[gte] Test op groter dan of gelijk (>=).
yCoordinaatMuurvlak[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
yCoordinaatMuurvlak[not] Test of waarde niet overeenkomt (!=).

Insluitbare relaties

De volgende velden kunnen ingesloten worden met ?_expandScope=...:

Relatie Tabel Omschrijving
ligtInBouwblok gebieden:bouwblokken Een bouwblok is het kleinst mogelijk afgrensbare gebied, in zijn geheel tot een buurt behorend, dat geheel of grotendeels door bestaande of aan te leggen wegen en/of waterlopen is of zal zijn ingesloten en waarop tenminste één gebouw met verblijfsobject staat op maaiveld niveau. Dus ondergrondse garages en metrostations krijgen géén bouwblok