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.