Reverse geocoding | LocatieAPI

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.
`lon`	number	ja	Lengtegraad in WGS84.
`radius`	integer	nee	Zoekstraal in meters, 1 tot 1.000. Standaard 100.

De response

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

200 application/json

{
  "data": [
    {
      "distance": 12,
      "postcode": "1021JT",
      "number": 19,
      "street": "Hamerstraat",
      "city": "Amsterdam",
      "location": { "type": "Point", "coordinates": [4.92204151, 52.38488658] }
    }
  ]
}

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 uit de BAG, 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 100 meter en maximaal 1.000. Een grotere straal kost meer tijd en levert zelden een beter antwoord; in stedelijk gebied is 50 meter meestal genoeg.