Reverse geocoding: coördinaat naar adres

Het verzoek

GET /v1/reverse

De dichtstbijzijnde adressen bij een coördinaat, met afstand in meters.

Parameter	Type	Verplicht	Omschrijving
`lat`	number	ja	Breedtegraad in WGS84, tussen -90 en 90.
`lon`	number	ja	Lengtegraad in WGS84, tussen -180 en 180.
`radius`	integer	nee	Zoekstraal in meters. Wordt afgekapt op het maximum van de API.
`limit`	integer	nee	Aantal treffers. Standaard 10.

De response

Een geslaagde aanroep geeft 200 met Content-Type: application/json en Cache-Control: public, max-age=86400.

200 application/json

{
  "data": [
    {
      "id": "0363200012101386",
      "postcode": "1021JT",
      "number": 19,
      "street": "Hamerstraat",
      "city": "Amsterdam",
      "municipality": "Amsterdam",
      "province": "Noord-Holland",
      "location": { "type": "Point", "coordinates": [4.92204151, 52.38488658] },
      "distance": 12
    }
  ],
  "meta": { "count": 1, "lat": 52.38488658, "lon": 4.92204151, "radius": 100, "unit": "meters" }
}

Voorbeelden

curl -sS \
  -H "X-Api-Key: lat_test_demo_publiek_locatieapi_sandbox" \
  -H "Accept: application/json" \
  "https://api.locatieapi.nl/v1/reverse?lat=52.38488658&lon=4.92204151&radius=100"

$curl = curl_init('https://api.locatieapi.nl/v1/reverse?lat=52.38488658&lon=4.92204151&radius=100');
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 5,
    CURLOPT_HTTPHEADER => ['X-Api-Key: lat_test_demo_publiek_locatieapi_sandbox', 'Accept: application/json'],
]);

$body = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
curl_close($curl);

$result = $status === 200 ? json_decode($body, true) : null;

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders(['X-Api-Key' => config('services.locatieapi.key')])
    ->acceptJson()
    ->timeout(5)
    ->get('https://api.locatieapi.nl/v1/reverse?lat=52.38488658&lon=4.92204151&radius=100');

$result = $response->successful() ? $response->json() : null;

const response = await fetch('https://api.locatieapi.nl/v1/reverse?lat=52.38488658&lon=4.92204151&radius=100', {
  headers: {
    'X-Api-Key': 'lat_test_demo_publiek_locatieapi_sandbox',
    Accept: 'application/json',
  },
});

const result = response.ok ? await response.json() : null;

import requests

response = requests.get(
    "https://api.locatieapi.nl/v1/reverse?lat=52.38488658&lon=4.92204151&radius=100",
    headers={"X-Api-Key": "lat_test_demo_publiek_locatieapi_sandbox", "Accept": "application/json"},
    timeout=5,
)

result = response.json() if response.ok else None

Let op de volgorde

In de querystring geef je lat en lon apart op, dus daar kan het niet misgaan. In de response staat location.coordinates wel in GeoJSON-volgorde: [longitude, latitude].

Nauwkeurigheid

Het coördinaat van een adres is het middelpunt van het verblijfsobject, niet de voordeur en niet het midden van de weg. In een dichte binnenstad liggen adressen soms minder dan drie meter uit elkaar; een gps-positie van een telefoon is buiten meestal vijf tot tien meter nauwkeurig. Reken er dus op dat het eerste resultaat niet altijd het juiste adres is en laat de gebruiker kiezen uit de eerste paar treffers.

De afstand in distance is de hemelsbrede afstand in hele meters, berekend met de haversineformule over WGS84. Dat is geen loopafstand: een adres aan de overkant van een gracht kan tien meter ver zijn en tweehonderd meter lopen.

De zoekstraal is standaard 1.000 meter, en dat is ook het maximum. Geef een kleinere straal mee als je dichterbij wilt zoeken: een grotere straal kost meer tijd en levert zelden een beter antwoord, en in stedelijk gebied is 50 meter meestal genoeg.