WebsiteDashboard
GuidesAPI Reference

Nearby - Places (Public BETA)

The Nearby API returns nearby places around a specified location.

Results can include points of interest such as cafes, hospitals, and airports, as well as place-level features such as cities, depending on the requested tag.

Note: The Nearby API endpoint is presently in BETA. The request or response format may change without notice. While we don't expect to remove any elements, there will be additions.

GET
/nearby

Authorization

stringRequired

LocationIQ Access Token

Query Parameters

numberRequired

Latitude of the location to generate an address for.

Formatfloat
numberRequired

Longitude of the location to generate an address for.

Formatfloat
string

You can use a tag to restrict Nearby API results to specific types of places. We support two types of tags: a single-word format for common use-cases and key-value pairs for advanced use-cases.

1. Single-word Format (Simple)

For most use-cases, the list of tags below should suffice. Multiple tags can be specified as a comma-separated list.

TagDescription
allReturn a list of all places
airportList of airports
cityList of nearby cities
restaurantList of restaurants
bankList of banks
atmList of ATMs
hotelList of hotels
pubList of pubs
bus_stationList of bus stations
railway_stationList of railway stations
cinemaList of cinema theatres
hospitalList of hospitals
collegeList of colleges
schoolList of schools
pharmacyList of pharmacies
supermarketList of supermarket
fuelList of fuel stations
gymList of gyms
place_of_worshipList of places of worship
toiletList of toilets
parkList of parks
stadiumList of stadiums
parkingList of parking
cardealerList of car dealers

2. Key Value Format (Advanced)

For advanced use-cases that need additional tags not present in the table above, we also support tags based on OpenStreetMap''s (OSM) exhaustive list of tags. These tags are represented as key-value pairs of class and type values. Multiple class and type values can be specified as a comma-separated list.

Examples:

  • To return a list of all places: tag=all
  • To return city records: tag=place:city
  • To return records with amenity class (e.g., restaurants, hospitals, banks): tag=amenity:*
  • To return records with the amenity class and school as type (i.e., a list of schools): tag=amenity:school
  • To return all records except those with amenity as class: tag=all,!amenity:*
  • To return all records in the amenity class except gym: tag=amenity:*,!amenity:gym
  • To return all records except elements with amenity as class and gym as type: tag=!amenity:gym
  • To return a list of airports, hotels, and parking spaces nearby: tag=aeroway:aerodrome,tourism:hotel,amenity:parking
integerDefaults to 100

Radius (in meters) from the given latitude and longitude to search for results in. Accepted value: 1 to 500000. Defaults to 100.

Note: Nearby API results are matched using each result's associated location point, not the full boundary or area of the result. A result is returned only when the search radius reaches that point.

For example, a search near outer London may not return London until the radius is large enough to reach London's associated location point, even if part of the wider London area is already within the search radius.

Range1 <= value <= 500000
integer

Limit the number of returned results. Accepted value: 1 to 50. Defaults to 10.

Range1 <= value <= 50
integerDefaults to 0

When enabled, the geocoder attempts to filter out duplicate results for the same real-world place. Because limit is applied before deduplication, fewer results than requested may be returned.

Allowed:01

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/nearby?lat=40.748442&lon=-73.985658"
[  {    "place_id": "423028398818",    "osm_type": "way",    "osm_id": "34633854",    "lat": "40.7484284",    "lon": "-73.98565462",    "class": "tourism",    "type": "attraction",    "tag_type": "attraction",    "name": "Empire State Building",    "display_name": "Empire State Building, 350, 5th Avenue, Korea Town, Midtown South, New York, New York, 10001, United States of America",    "address": {      "name": "Empire State Building",      "house_number": "350",      "road": "5th Avenue",      "neighbourhood": "Korea Town",      "suburb": "Midtown South",      "city": "New York",      "state": "New York",      "postcode": "10001",      "country": "United States of America",      "country_code": "us"    },    "boundingbox": [      "40.7479226",      "40.7489422",      "-73.9864855",      "-73.9848259"    ],    "distance": 1  },  {    "place_id": "423629875658",    "osm_type": "node",    "osm_id": "5190610589",    "lat": "40.7483271",    "lon": "-73.9856549",    "class": "tourism",    "type": "attraction",    "tag_type": "attraction",    "name": "NY Skyride",    "display_name": "NY Skyride, 350, 5th Avenue, Korea Town, Midtown South, New York, New York, 10001, United States of America",    "address": {      "name": "NY Skyride",      "house_number": "350",      "road": "5th Avenue",      "neighbourhood": "Korea Town",      "suburb": "Midtown South",      "city": "New York",      "state": "New York",      "postcode": "10001",      "country": "United States of America",      "country_code": "us"    },    "boundingbox": [      "40.7483271",      "40.7483271",      "-73.9856549",      "-73.9856549"    ],    "distance": 9  }]