Skip to content

Reverse Search

Reverse search (also known as reverse geocoding or address geocoding) helps you find places nearest to some geographic coordinates. Like the other endpoints, it offers a number of parameters to adjust the search.

Endpoint: https://api.stadiamaps.com/geocoding/v1/reverse

Query String Parameters

Parameter Type Required Description Default Example
point.lat float yes The latitude of the point at which to perform the search. none 48.858268
point.lon float yes The longitude of the point at which to perform the search. none 2.294471
boundary.circle.radius float no The radius (in kilometers) of the circle to limit the search to. 1 35
layers comma-delimited string array no A list of layers, to limit the search to. all layers address,venue
sources comma-delimited string array no A list of sources, to limit the search to. all sources openstreetmap,wof
boundary.country comma-delimited string array no A list of countries to limit the search to. none GBR,FRA
boundary.gid Pelias GID no The Pelias GID of a region to limit the search to. none whosonfirst:locality:101748355
size integer no The maximum number of results to return. 10 3

Notes and tips

  • Use layers=coarse can be used for extremely fast, coarse-grained lookups.
  • The confidence score has a specific meaning for reverse search results.

Response format

All geocoding, autocomplete, and search endpoints share a common response format. See the response format documentation for details.