ROOTEDocs
CapabilitiesGeography

Reverse Geocode

Convert coordinates into a readable place or address.

Page actions

Convert coordinates into a readable place or address.

GET https://api.roote.ai/v1/reverse-geocode

Request

curl "https://api.roote.ai/v1/reverse-geocode?lat=48.8566&lon=2.3522" \\
  -H "Authorization: Bearer YOUR_API_TOKEN"
ParameterRequiredDescription
latYesLatitude from -90 to 90.
lonYesLongitude from -180 to 180.

Response

{
  "results": [{
    "roote_id": null,
    "name": "Paris",
    "label": "Paris, France",
    "type": "locality",
    "location": { "lat": 48.8566, "lon": 2.3522 },
    "address": { "city": "Paris", "region": "Île-de-France", "country": "France" },
    "source_id": "google",
    "source_place_id": "provider-place-id"
  }],
  "meta": { "source": "google", "cache": "miss", "total": 1, "origin": { "lat": 48.8566, "lon": 2.3522 } }
}

Authenticated calls use the geography:read scope. Up to five ordered candidates may be returned. No result is HTTP 200 with an empty results array.

On this page