Reverse geocode

GET /address_whisper/geocode

Returns the addresses closest to a given lon/lat, ordered by ascending distance. Useful for "use my location" flows and map pins.

Parameters

Query

Body (JSON)

Request

cURL

Code(bash)
 
curl -G 'https://api.polaris.launify.com/address_whisper/geocode' \
  -H 'Referer: https://yourapp.com' \
  -H 'Content-Type: application/json' \
  --data-urlencode 'apiKey=YOUR_API_KEY' \
  -d '{ "country": "CZ", "lon": 14.41346, "lat": 50.08125 }'

JavaScript

Code(js)
 
const url = new URL(
  'https://api.polaris.launify.com/address_whisper/geocode',
);
url.searchParams.set('apiKey', 'YOUR_API_KEY');

const res = await fetch(url, {
  method: 'GET',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ country: 'CZ', lon: 14.41346, lat: 50.08125 }),
});
const nearest = JSON.parse(await res.text());

Response

200 OK — a JSON-encoded string containing an array of up to 10 nearest addresses, sorted by distance (metres) ascending.

Code(json)
 
[
  {
    "street": "Národní 223/2",
    "city": "Praha - Nové Město",
    "postcode": "11000",
    "country": "CZ",
    "lon": 14.41346,
    "lat": 50.08125,
    "value": "Národní 223/2, Praha - Nové Město, 11000",
    "distance": 12.4
  }
]