# Adressen en gebieden

> Een woning of een gebied aanduiden in het pad.

Bron: https://huispedia.dev/nl/docs/locators/

## Woningen

Een woning staat in het pad als `:locator`, in een van twee vormen:

| Vorm | Voorbeeld | Wat je opgeeft |
|---|---|---|
| BAG-nummeraanduiding | `bag:0363200000028422` | Het 16-cijferige BAG-id van het adres |
| Postcode-adres | `1076LJ-12-2` | Postcode, huisnummer en eventueel de toevoeging; hoofdletters en spaties maken niet uit |

Weet je de toevoeging niet? `GET /v5/addresses/suggest?q=Amazonenstraat 12, Amsterdam` zoekt het adres op (gratis); `GET /v5/addresses/1076LJ-12?all=true` geeft alle woningen op een huisnummer.

In een POST-body (scenariowaarderingen) identificeer je een woning met `locator`, `bag_id` of `postcode` + `house_number` (+ `house_number_ext`).

## Gebieden

Een gebied staat in het pad als `:area`, altijd als `niveau:code`:

| Niveau | Code | Voorbeeld |
|---|---|---|
| `neighbourhood` | CBS-buurtcode | `neighbourhood:BU0363KH05` |
| `district` | CBS-wijkcode | `district:WK0363KH` |
| `municipality` | CBS-gemeentecode | `municipality:GM0363` |
| `province` | CBS-provinciecode | `province:PV27` |
| `postcode4` | De vier cijfers van de postcode | `postcode4:1076` |
| `postcode6` | De volledige postcode | `postcode6:1076LJ` |
| `national` | Geen code | `national` |

De CBS-codes staan in elk antwoord over een adres, of zoek ze op met `GET /v5/areas/lookup?postcode=1076LJ`. Statistieken, prijsindex en demografie zijn er per buurt, wijk, gemeente, provincie en land.