Nieuw: buurt opvragen via de API

Tot nu toe kon je via de API al de wijk van een adres opvragen met attributes[]=district. Op veelvuldig verzoek hebben we daar nu de buurt aan toegevoegd. Vanaf vandaag kun je met attributes[]=neighborhood de buurtnaam van elk Nederlands adres ophalen.

Wijk en buurt: wat is het verschil?

In Nederland is elke gemeente opgedeeld in wijken, en elke wijk is op zijn beurt opgedeeld in buurten. De buurt is daarmee het meest gedetailleerde geografische niveau. Deze indeling is afkomstig van het CBS (Centraal Bureau voor de Statistiek) en wordt onder andere gebruikt voor statistiek, beleid en analyse.

Met de toevoeging van de buurt kun je adressen nog fijnmaziger groeperen en segmenteren dan met alleen de wijk.

Hoe vraag je de buurt op?

De buurt is, net als de wijk en coördinaten, een optioneel attribuut dat je meegeeft via de attributes[] query parameter. Je kunt de buurt los opvragen of combineren met andere attributen in één request.

GET https://api.nederlandpostcode.nl/v1/address?postcode=1015CN&number=10&attributes[]=neighborhood

De buurtnaam wordt teruggegeven in het details object van het adres:

{
    "data": [
        {
            "postcode": "1015CN",
            "number": 10,
            "addition": "A",
            "street": "Keizersgracht",
            "city": "Amsterdam",
            "municipality": "Amsterdam",
            "province": "Noord-Holland",
            "country": "Nederland",
            "details": {
                "neighborhood": "Langestraat e.o."
            }
        }
    ]
}

Wil je zowel de wijk als de buurt? Combineer dan beide attributen:

GET https://api.nederlandpostcode.nl/v1/address?postcode=1015CN&number=10&attributes[]=district&attributes[]=neighborhood

Waarvoor kun je dit gebruiken?

• Vastgoedplatforms - categoriseer woningen tot op buurtniveau
• Marketing en analyse - segmenteer doelgroepen fijnmazig per buurt
• Gemeentelijke planning - analyseer buurtdata voor beleid en rapportages
• Logistiek & bezorgdiensten - verrijk adressen met buurtinformatie voor efficiëntere routes

De buurt is beschikbaar in alle abonnementen, zonder extra kosten. Net als bij de wijk geldt: voor een heel beperkt aantal adressen kan de waarde null zijn wanneer er geen buurt bekend is.

Meer informatie vind je op de Buurten API pagina en in de API documentatie.