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:

Veld ID Veldnaam Type Identifier Omschrijving
identificatie Peilmerk ID String ☑ Unieke identificatie van het peilmerk
hoogteTovNap Peilmerk hoogte tov NAP Number Gemeten hoogte van het peilmerk t.o.v. NAP (m)
jaar Waterpassing jaar Integer Het jaar van waterpassing, behorende bij de hoogte
merkCode Peilmerk merk code String Gebruikte peilmerk code
merkOmschrijving Peilmerk merk omschrijving String Gebruikte peilmerk omschrijving
omschrijving Peilmerk object omschrijving String Beschrijving van het object waarin het peilmerk zich bevindt
windrichting Windrichting omschrijving 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 Muurvlak x-coordinaat 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 Muurvlak y-coordinaat 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 Meetbout rijkswaterstaat nummer String Nummer dat Rijkswaterstaat hanteert voor een meetbout
geometrie Geometrie Geometry Vorm en ligging van het object in het stelsel van de Rijksdriehoekmeting (RD)
statusCode Peilmerk status code Integer Status van het peilmerk code
statusOmschrijving Peilmerk status omschrijving String Status van het referentiepunt (1=actueel, 2=niet te meten, 3=vervallen) omschrijving
vervaldatum Peilmerk geldigheid einddatum Date Vervaldatum van het peilmerk
ligtInBouwblok Peilmerk ligt in bouwblok Object (relatie) Het bouwblok waarbinnen het peilmerk ligt
ligtInBouwblok.identificatie None String (relatie) Het bouwblok waarbinnen het peilmerk ligt
ligtInBouwblok.volgnummer None Integer (relatie) Het bouwblok waarbinnen het peilmerk ligt
publiceerbaar Publiceerbaar indicatie 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[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.
geometrie[intersects] GeoJSON of POLYGON(x y ...) Test of er een intersectie is met de waarde.
hoogteTovNap Getal Test op exacte waarde (==)
hoogteTovNap[lt] Test op kleiner dan (<).
hoogteTovNap[gt] Test op groter dan (>).
hoogteTovNap[gte] Test op groter dan of gelijk (>=).
hoogteTovNap[not] Test of waarde niet overeenkomt (!=).
hoogteTovNap[lte] Test op kleiner dan of gelijk (<=).
hoogteTovNap[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
hoogteTovNap[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
identificatie Tekst Test op exacte waarde (==)
identificatie[not] Test of waarde niet overeenkomt (!=).
identificatie[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
identificatie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
identificatie[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
identificatie[isempty] true | false Test of de waarde leeg is (== '' / != '')
jaar Geheel getal Test op exacte waarde (==)
jaar[lt] Test op kleiner dan (<).
jaar[gt] Test op groter dan (>).
jaar[gte] Test op groter dan of gelijk (>=).
jaar[not] Test of waarde niet overeenkomt (!=).
jaar[lte] Test op kleiner dan of gelijk (<=).
jaar[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
jaar[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
ligtInBouwblok.identificatie Tekst Test op exacte waarde (==)
ligtInBouwblok.identificatie[not] Test of waarde niet overeenkomt (!=).
ligtInBouwblok.identificatie[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
ligtInBouwblok.identificatie[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
ligtInBouwblok.identificatie[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
ligtInBouwblok.identificatie[isempty] true | false Test of de waarde leeg is (== '' / != '')
ligtInBouwblok.volgnummer Geheel getal Test op exacte waarde (==)
ligtInBouwblok.volgnummer[lt] Test op kleiner dan (<).
ligtInBouwblok.volgnummer[gt] Test op groter dan (>).
ligtInBouwblok.volgnummer[gte] Test op groter dan of gelijk (>=).
ligtInBouwblok.volgnummer[not] Test of waarde niet overeenkomt (!=).
ligtInBouwblok.volgnummer[lte] Test op kleiner dan of gelijk (<=).
ligtInBouwblok.volgnummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
ligtInBouwblok.volgnummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
merkCode Tekst Test op exacte waarde (==)
merkCode[not] Test of waarde niet overeenkomt (!=).
merkCode[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
merkCode[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
merkCode[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
merkCode[isempty] true | false Test of de waarde leeg is (== '' / != '')
merkOmschrijving Tekst Test op exacte waarde (==)
merkOmschrijving[not] Test of waarde niet overeenkomt (!=).
merkOmschrijving[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
merkOmschrijving[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
merkOmschrijving[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
merkOmschrijving[isempty] true | false Test of de waarde leeg is (== '' / != '')
omschrijving Tekst Test op exacte waarde (==)
omschrijving[not] Test of waarde niet overeenkomt (!=).
omschrijving[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
omschrijving[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
omschrijving[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
omschrijving[isempty] true | false Test of de waarde leeg is (== '' / != '')
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[not] Test of waarde niet overeenkomt (!=).
rwsNummer[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
rwsNummer[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
rwsNummer[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
rwsNummer[isempty] true | false Test of de waarde leeg is (== '' / != '')
statusCode Geheel getal Test op exacte waarde (==)
statusCode[lt] Test op kleiner dan (<).
statusCode[gt] Test op groter dan (>).
statusCode[gte] Test op groter dan of gelijk (>=).
statusCode[not] Test of waarde niet overeenkomt (!=).
statusCode[lte] Test op kleiner dan of gelijk (<=).
statusCode[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
statusCode[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
statusOmschrijving Tekst Test op exacte waarde (==)
statusOmschrijving[not] Test of waarde niet overeenkomt (!=).
statusOmschrijving[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
statusOmschrijving[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
statusOmschrijving[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
statusOmschrijving[isempty] true | false Test of de waarde leeg is (== '' / != '')
vervaldatum yyyy-mm-dd Test op exacte waarde (==)
vervaldatum[lt] Test op kleiner dan (<).
vervaldatum[gt] Test op groter dan (>).
vervaldatum[gte] Test op groter dan of gelijk (>=).
vervaldatum[not] Test of waarde niet overeenkomt (!=).
vervaldatum[lte] Test op kleiner dan of gelijk (<=).
vervaldatum[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
vervaldatum[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
windrichting Tekst Test op exacte waarde (==)
windrichting[not] Test of waarde niet overeenkomt (!=).
windrichting[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
windrichting[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
windrichting[like] Tekst met jokertekens (* en ?). Test op gedeelte van tekst.
windrichting[isempty] true | false Test of de waarde leeg is (== '' / != '')
xCoordinaatMuurvlak Getal Test op exacte waarde (==)
xCoordinaatMuurvlak[lt] Test op kleiner dan (<).
xCoordinaatMuurvlak[gt] Test op groter dan (>).
xCoordinaatMuurvlak[gte] Test op groter dan of gelijk (>=).
xCoordinaatMuurvlak[not] Test of waarde niet overeenkomt (!=).
xCoordinaatMuurvlak[lte] Test op kleiner dan of gelijk (<=).
xCoordinaatMuurvlak[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
xCoordinaatMuurvlak[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).
yCoordinaatMuurvlak Getal Test op exacte waarde (==)
yCoordinaatMuurvlak[lt] Test op kleiner dan (<).
yCoordinaatMuurvlak[gt] Test op groter dan (>).
yCoordinaatMuurvlak[gte] Test op groter dan of gelijk (>=).
yCoordinaatMuurvlak[not] Test of waarde niet overeenkomt (!=).
yCoordinaatMuurvlak[lte] Test op kleiner dan of gelijk (<=).
yCoordinaatMuurvlak[in] Lijst van waarden Test of de waarde overeenkomst met 1 van de opties (IN).
yCoordinaatMuurvlak[isnull] true | false Test op ontbrekende waarden (IS NULL / IS NOT NULL).

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