Nearby

Find places within a radius of coordinates.

GET

Parameters

Parameter	Type	Required	Description
`lat`	number	Required	Latitude of center point
`lng`	number	Required	Longitude of center point
`radius`	integer	Optional	Search radius in km (default: 10, max: 100)
`limit`	integer	Optional	Maximum results (default: 10, max: 100)

Request Example

curl "https://api.localityapi.com/v1/nearby?lat=25.2048&lng=55.2708&radius=10" \
  -H "X-API-Key: lapi_your_key"

Response

json

{
  "results": [
    {
      "name": "Dubai",
      "country": "AE",
      "admin1": "Dubai",
      "lat": 25.2048,
      "lng": 55.2708,
      "distance_km": 0.0,
      "population": 3790000
    },
    {
      "name": "Sharjah",
      "country": "AE",
      "admin1": "Sharjah",
      "lat": 25.3463,
      "lng": 55.4209,
      "distance_km": 8.2,
      "population": 1274000
    }
  ],
  "count": 2,
  "query_ms": 15
}

Response Fields

resultsarrayArray of nearby places sorted by distance

results[].namestringPlace name

results[].countrystringISO2 country code

results[].admin1stringPrimary admin region

results[].latnumberLatitude

results[].lngnumberLongitude

results[].distance_kmnumberDistance from center point in km

results[].populationintegerPopulation count

countintegerTotal number of results

query_msintegerQuery execution time in milliseconds