Geo
Omgekeerde Geocoding (PDOK)
Nederlandse reverse geocoding API — coördinaten naar adres via PDOK Locatieserver. WGS84 lat/lon omzetten naar straatnaam, postcode en plaatsnaam.
GET /v1/geo/reverse-geocode
Converts WGS84 latitude/longitude coordinates into the nearest Dutch address, using the PDOK Locatieserver (CC-0 open data, Kadaster).
Only Dutch territory is supported (lat 50.5–53.7 °N, lon 3.2–7.3 °E).
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
lat | number | ✓ | Latitude in decimal degrees (WGS84), e.g. 52.3756 |
lon | number | ✓ | Longitude in decimal degrees (WGS84), e.g. 4.8951 |
Example request
curl -H "X-API-Key: YOUR_KEY" \
"https://api.omnizoek.nl/v1/geo/reverse-geocode?lat=52.3756&lon=4.8951"Example response
{
"lat": 52.3756,
"lon": 4.8951,
"display_name": "Damrak 1, Amsterdam",
"type": "adres",
"postcode": "1012LG",
"city": "Amsterdam",
"municipality": "Amsterdam",
"province": "Noord-Holland",
"street": "Damrak",
"house_number": "1",
"bag_id": "0363200000397642"
}Response fields
| Field | Type | Description |
|---|---|---|
lat | number | Input latitude (WGS84) |
lon | number | Input longitude (WGS84) |
display_name | string | Full formatted address of the nearest location |
type | string | PDOK result type, e.g. adres |
postcode | string | null | Postcode, e.g. 1012LG |
city | string | null | City / woonplaats |
municipality | string | null | Municipality / gemeente |
province | string | null | Province / provincie |
street | string | null | Street name |
house_number | string | null | House number |
bag_id | string | null | BAG object ID |
Error responses
| Status | Cause |
|---|---|
404 | No address found near the given coordinates |
422 | Coordinates outside Dutch territory |
503 | PDOK Locatieserver unavailable |
Caching
Results are cached for 24 hours per unique coordinate pair (5 decimal places).