GET /v1/reverse returns up to size places within a radius of a point, nearest first. Each result has its distance in kilometres.
Parameters
| Parameter | Type | Default | Meaning |
|---|---|---|---|
point.lat | number −90–90 | required | Latitude of the point. |
point.lon | number −180–180 | required | Longitude of the point. |
boundary.circle.radius | number, > 0 and ≤ 100 | 1 | Search radius in kilometres. |
size | integer 1–40 | 10 | Number of results. |
layers | list | all | venue, address, street, locality, county, region, country. |
boundary.country | list | every country | ISO 3166-1 alpha-2 codes. |
focus.point.lat and focus.point.lon are accepted but have no effect here.
Example
curl 'http://localhost:4000/v1/reverse?point.lat=18.5195&point.lon=73.8553&size=2'
{
"bbox": [
73.85535,
18.51957,
73.8553518,
18.5195709
],
"features": [
{
"geometry": {
"coordinates": [
73.85535,
18.51957
],
"type": "Point"
},
"properties": {
"country": "India",
"country_code": "IN",
"county": "Pune",
"distance": 0.009,
"gid": "geolith:venue:3810173583912348177",
"id": "3810173583912348177",
"importance": 0.34360000491142273,
"label": "Mahindra Automotive, Pune, Maharashtra, India",
"layer": "venue",
"locality": "Pune",
"name": "Mahindra Automotive",
"region": "Maharashtra",
"source": "geolith"
},
"type": "Feature"
},
{
"geometry": {
"coordinates": [
73.8553518,
18.5195709
],
"type": "Point"
},
"properties": {
"country": "India",
"country_code": "IN",
"county": "Pune",
"distance": 0.01,
"gid": "geolith:venue:17375909595434777",
"id": "17375909595434777",
"importance": 0.8500000238418579,
"label": "Pathkind Labs, Pune, Maharashtra, India",
"layer": "venue",
"locality": "Pune",
"name": "Pathkind Labs",
"region": "Maharashtra",
"source": "geolith"
},
"type": "Feature"
}
],
"geocoding": {
"attribution": "https://console.geolith.app/attribution",
"engine": {
"name": "geolith-search",
"version": "0.1.0"
},
"query": {
"boundary.circle.radius": 1.0,
"point.lat": 18.5195,
"point.lon": 73.8553,
"size": 2
},
"version": "0.2"
},
"type": "FeatureCollection"
}
The response is trimmed to two features.
See Reverse geocoding for how the nearest places are found.