Skip to main content
GET
/
v1
/
geocoding
/
reverse
Reverse geocode coordinates
curl --request GET \
  --url https://api.footstep.ai/v1/geocoding/reverse \
  --header 'x-api-key: <api-key>'
{
  "results": [
    {
      "coordinates": {
        "lat": 51.5074,
        "lng": -0.1278
      },
      "label": "10 Downing Street, London, England, United Kingdom",
      "name": "10 Downing Street",
      "country": "United Kingdom",
      "country_code": "GBR",
      "region": "England",
      "locality": "London",
      "confidence": 0.9,
      "layer": "address",
      "source": "openstreetmap"
    }
  ],
  "query": {
    "lat": 51.5034,
    "lon": -0.1276,
    "size": 1
  }
}

Authorizations

​
x-api-key
string
header
required

Your Footstep API key

Query Parameters

​
point.lat
number
required

Latitude of the point to reverse geocode

Required range: -90 <= x <= 90
​
point.lon
number
required

Longitude of the point to reverse geocode

Required range: -180 <= x <= 180
​
size
integer
default:1

Maximum number of results

Required range: 1 <= x <= 40
​
boundary.circle.radius
number

Search radius in kilometers

​
layers
string

Comma-separated layers to filter: venue, address, street, locality, region, country

Response

Reverse geocoding results

​
results
object[]
required
​
query
object
required