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.