Streets

Search 52M+ named streets worldwide.

GET

Parameters

Parameter	Type	Required	Description
`q`	string	Required	Street name to search for
`lat`	number	Optional	Latitude for nearby search
`lng`	number	Optional	Longitude for nearby search
`radius`	number	Optional	Search radius in km (default: 5)
`limit`	integer	Optional	Number of results (default: 10, max: 50)

Request Example

curl "https://api.localityapi.com/v1/streets?q=Oxford+Street&lat=51.5085&lng=-0.1257&radius=2" \
  -H "X-API-Key: lapi_your_key"

Response

json

{
  "query": "Oxford Street",
  "results": [
    {
      "name": "Oxford Street",
      "highway_type": "primary",
      "lat": 51.5154,
      "lng": -0.1416,
      "distance_km": 0.82
    }
  ],
  "count": 1,
  "query_ms": 45
}

Response Fields

querystringThe search query

resultsarrayArray of matching streets

results[].namestringStreet name

results[].highway_typestringRoad classification (primary, secondary, residential)

results[].latnumberLatitude

results[].lngnumberLongitude

results[].distance_kmnumberDistance from search coordinates

countintegerNumber of results

query_msintegerQuery execution time in milliseconds