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:
None
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 ☑ Het nummer van het peilmerk
hoogteTovNap Number Geeft de hoogte ten opzichte van NAP in meters. Bij een positieve waarde ligt het peilmerk boven NAP. Bij een negatieve waarde ligt het peilmerk onder NAP
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 Geometrische ligging van het peilmerk
statusCode Integer Status van het peilmerk code
statusOmschrijving String Status van het peilmerk 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 Publiceerbaar ja of nee

De volgende query-parameters zijn te gebruiken:

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

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