Nearby places

Overview

GET /nearby returns points of interest around a point (or within a map viewport), filtered by category. It answers "what’s around here" by proximity — for search-as-you-type by name, use /search instead. Authenticate with a key scoped to "nearby". Responses are near-static and edge-cached.

Request

Anchor by a point + radius, or by a bounding box (great for loading exactly what’s on the map as the user pans).

# around a point (radius in km, default 5, max 25)
curl "https://api.goggleplaces.com/nearby?lat=53.4808&lng=-2.2426&radius=2&categories=restaurant,bar&key=gk_live_pk_..."

# within a map viewport (bbox = minLng,minLat,maxLng,maxLat)
curl "https://api.goggleplaces.com/nearby?bbox=-2.26,53.46,-2.20,53.50&categories=lodging,charging&key=gk_live_pk_..."

Categories

Categories: restaurant (restaurants, cafés, fast food) · bar (pubs & bars) · supermarket (supermarkets & convenience stores) · shopping (high-street & retail shops) · cinema (cinemas) · fuel (petrol / fuel stations) · lodging (hotels, hostels, guest houses) · attraction (museums, galleries, landmarks) · charging (EV charge points) · transport (rail/bus stations, airports) · hospital (hospitals, clinics, pharmacies) · parking (public car parks). Pass one or more as a CSV in categories=.

Response

hits[] nearest-first. Each has id, category, subcategory, display_name, geo_point, distance and an inline icon — plus opening_hours, website, phone, cuisine and wheelchair where OpenStreetMap has them.

{
  "categories": ["lodging", "charging"],
  "total": 42,
  "hits": [
    {
      "id": "osm:n456",
      "category": "charging",
      "subcategory": "charging_station",
      "display_name": "Source London",
      "geo_point": { "lat": 51.51, "lon": -0.12 },
      "distance": 0.3,
      "distance_unit": "mi"
    }
  ]
}

Data

POIs come from OpenStreetMap (Great Britain, ODbL). "© OpenStreetMap contributors" attribution is mandatory wherever this data is shown — the SDK and widget render it by default.