Uitgebreide adresinformatie
Nederland Postcode API ondersteunt nu ook het ophalen van uitgebreide adresinformatie.
De Nederland Postcode API is uitgebreid met nieuwe gegevens die je per adres kunt opvragen. Na meerdere verzoeken van gebruikers hebben we het aantal beschikbare velden vergroot, zodat je nog meer informatie over een adres kunt ophalen.
Via de API was het al mogelijk om de coördinaten en wijknaam op te vragen. Deze velden blijven uiteraard beschikbaar, maar daar zijn nu extra velden aan toegevoegd.
Alle velden kunnen optioneel worden opgevraagd via de attributes[] query parameter. Hierdoor ontvang je alleen de gegevens die je daadwerkelijk nodig hebt. Omdat dit een array is, kun je meerdere velden tegelijk opvragen in één request.
Beschikbare attributen
| Parameter | Beschrijving | Voorbeeld |
|---|---|---|
coordinates |
Coördinaten van de locatie | 52.30528553688755, 4.750645160863609 |
district |
Naam van de wijk | Grachtengordel-West |
function |
Functie van de locatie | woonfunctie |
location_status |
Status van de locatie | verblijfsobject in gebruik |
property_status |
Status van het pand | pand in gebruik |
surface_area |
Oppervlakte van het pand | 120 |
construction_year |
Bouwjaar van het pand | 1990 |
coordinates
De geografische coördinaten van het adres. Dit zijn latitude en longitude waarden die je bijvoorbeeld kunt gebruiken voor kaarten, geolocatie of afstandsberekeningen.
district
De wijk waarin het adres zich bevindt. Dit kan handig zijn voor statistieken, visualisaties of het groeperen van adressen binnen een stad.
function
De gebruiksfunctie van het pand. Dit geeft aan waarvoor het gebouw bedoeld is, bijvoorbeeld een woonfunctie, kantoorfunctie, gezondheidszorgfunctie of andere gebruikscategorie.
- bijeenkomstfunctie
- celfunctie
- gezondheidszorgfunctie
- industriefunctie
- kantoorfunctie
- logiesfunctie
- onderwijsfunctie
- overige gebruiksfunctie
- sportfunctie
- verblijfsobject
- winkelfunctie
- woonfunctie
- standplaats
- ligplaats
location_status
De status van de locatie binnen de officiële registraties.
- niet gerealiseerd verblijfsobject
- verblijfsobject buiten gebruik
- verblijfsobject gevormd
- verblijfsobject in gebruik
- verblijfsobject in gebruik (niet ingemeten)
- verblijfsobject ingetrokken
- verblijfsobject ten onrechte opgevoerd
- verbouwing verblijfsobject
property_status
De status van het object binnen de officiële registraties.
- bouw gestart
- bouwvergunning verleend
- niet gerealiseerd pand
- pand buiten gebruik
- pand gesloopt
- pand in gebruik
- pand in gebruik (niet ingemeten)
- pand ten onrechte opgevoerd
- sloopvergunning verleend
- verbouwing pand
surface_area
De oppervlakte van het pand in vierkante meters. Dit kan nuttig zijn voor vastgoedtoepassingen, analyses of het tonen van extra details bij een adres.
construction_year
Het bouwjaar van het pand. Handig voor toepassingen die bijvoorbeeld woninginformatie tonen of analyses doen op bouwperiodes.
Voorbeeld API-verzoek
GET https://api.nederlandpostcode.nl/v1/address?postcode=1118BN&number=800&attributes[]=district&attributes[]=coordinates&attributes[]=function
Je kunt zelf bepalen welke velden je nodig hebt door alleen de gewenste attributes[] mee te geven in je request.
Door deze extra gegevens beschikbaar te maken wordt de API breder inzetbaar voor toepassingen zoals:
- vastgoedplatforms
- data-analyse
- kaartvisualisaties
- adresverrijking in applicaties
Meer informatie en voorbeelden van integratie vind je in de API documentatie.