Search APIs
Loading…
← API Store
Search & SEO

Google Maps

Google Maps

Google Maps places near a point

GET /google-maps/v1/nearby
Test this endpoint

Places around lat,lng (or location=lat,lng), optionally of a kind (q, e.g. restaurants, pharmacies). zoom sets the area (15 by default: a neighbourhood; 13 a city district; 17 a few blocks); radius (metres) keeps only places within that distance, nearest first. Each place carries distance_m from the point and the full business record. Each business carries business_id (= google_id, the 0x…:0x… feature id), place_id, google_mid, cid, name, phone_number (E.164), full_address with street_address, district, city, zipcode, state, country, latitude/longitude, timezone, rating, review_count, opening_status, working_hours, website, verified (claimed by its owner), owner_id/owner_name/owner_link, business_status (OPEN, CLOSED_TEMPORARILY, CLOSED), type and subtypes (categories), place_link, reviews_link, booking_link, reservations_link, order_link, menu_link, action_links, photos_sample, photo_count, summary, about_details, price_level, departments, next to the original fields. Filter by min_rating (places rated at least this) and open_now (places open at the time of the call); like the other filters, they apply to the places fetched for limit.

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
latrequirednumberLatitude of the point. Example: 30.2672
lngrequirednumberLongitude of the point. Example: -97.7431
qstringWhat to look for (default: any place). Example: restaurants
zoomintegerMap zoom 3-21 (default 15); lower is a wider area.
pageintegerPage number (20 places per page).
limitintegerPlaces to return (default 20, max 200; each 20 is one more page).
hlstringLanguage (default en).
glstringCountry (default us).
radiusintegerOnly places within this many metres (10-100000), nearest first; sets the zoom to fit.
subtypesstringKeep only businesses with one of these categories (comma-separated, as in `subtypes`), e.g. `Plumber,Drainage service`.
verifiedbooleantrue: only businesses claimed by their owner; false: only unclaimed ones.
business_statusstringKeep only these statuses (comma-separated): OPEN, CLOSED_TEMPORARILY, CLOSED.
extract_emails_and_contactsbooleantrue: also read the business website (home page and its contact page) for `emails_and_contacts`: emails, phone numbers and Facebook, Instagram, LinkedIn, X, YouTube, TikTok, GitHub, Yelp, Pinterest, Snapchat, Threads and WhatsApp links. Costs extra credits per business.
languagestringLanguage (same as `hl`, default en).
regionstringCountry (same as `gl`, default us).
min_ratingnumberOnly places rated at least this (1-5, e.g. 4.5).
open_nowtrue | falsetrue: only places open now.

Every endpoint also takes: fields、raw、fresh、output、records

{
  "cached": false,
  "credits_used": 1,
  "location": {
    "lat": 30.2672,
    "lng": -97.7431,
    "zoom": 15
  },
  "next_page": 2,
  "page": 1,
  "places": [
    {
      "address": "Dirty Martin's Place, 2808 Guadalupe St, Austin, TX 78705",
      "address_detail": [
        [
          [
            7,
            [
              [
                "Dirty Martin's Place"
              ],
              [
                "2808 Guadalupe St"
              ],
              "… 1 more"
            ]
          ],
          [
            2,
            [
              [
                "Dirty Martin's Place, 2808 Guadalupe St, Austin, TX 78705"
              ]
            ]
          ],
          "… 2 more"
        ],
        [
          "West University",
          "2808 Guadalupe St",
          "… 5 more"
        ]
      ],
      "address_parts": [
        "2808 Guadalupe St",
        "Austin, TX 78705"
      ],
      "categories": [
        "Hamburger restaurant",
        "Diner"
      ],
      "category": "Hamburger restaurant",
      "cid": "4536994861005164242",
      "city": "Austin",
      "country_code": "US",
      "description": "An Austin mainstay since 1926 with burgers, beer &  American chow served in an old-school space.",
      "distance_m": 2980,
      "feature_id": "0x8644b57f5ab0661b:0x3ef6a4c9bdfc4ed2",
      "full_address": "2808 Guadalupe St, Austin, TX 78705",
      "hours": {
        "Friday": [
          "11 AM–10 PM"
        ],
        "Monday": [
          "11 AM–9 PM"
        ],
        "Saturday": [
          "11 AM–10 PM"
        ],
        "Sunday": [
          "11 AM–9 PM"
        ],
        "Thursday": [
          "11 AM–10 PM"
        ],
        "Tuesday": [
          "11 AM–9 PM"
        ],
        "Wednesday": [
          "11 AM–9 PM"
        ]
      },
      "kgmid": "/m/020yvbs",
      "latitude": 30.293996,
      "longitude": -97.742344,
      "name": "Dirty Martin's Place",
      "neighborhood": "West University",
      "open_status": "Open · Closes 10 PM",
      "permanently_closed": null,
      "phone": "+1 555 010 0000",
      "phone_international": "+1 555 010 0000",
      "phones": [
        "+1 555 010 0000"
      ],
      "photos_count": 1379,
      "place_id": "ChIJG2awWn-1RIYR0k78vcmk9j4",
      "postal_code": "78705",
      "price_level": null,
      "review_count": 1697,
      "service_options": {
        "Accessibility": [
          "Wheelchair accessible entrance",
          "Wheelchair accessible parking lot",
          "… 2 more"
        ]
      },
      "stars": 4.5,
      "state": "Texas",
      "street": "2808 Guadalupe St",
      "thumbnail": "https://lh4.googleusercontent.com/-YQrlGKaiPBE/AAAAAAAAAAI/AAAAAAAAAAA/hCcsXWMmeQ4/s44-p-k-no-ns-nd/photo.jpg",
      "timezone": "America/Chicago",
      "url": "https://www.google.com/maps/place/?q=place_id:ChIJG2awWn-1RIYR0k78vcmk9j4",
      "website": "https://www.dirtymartins.com/",
      "website_domain": "dirtymartins.com"
    },
    {
      "address": "Fareground Austin, 111 Congress Ave, Austin, TX 78701",
      "address_detail": [
        [
          [
            7,
            [
              [
                "Fareground Austin"
              ],
              [
                "111 Congress Ave"
              ],
              "… 1 more"
            ]
          ],
          [
            2,
            [
              [
                "Fareground Austin, 111 Congress Ave, Austin, TX 78701"
              ]
            ]
          ],
          "… 2 more"
        ],
        [
          "Downtown Austin",
          "111 Congress Ave",
          "… 5 more"
        ]
      ],
      "address_parts": [
        "111 Congress Ave",
        "Austin, TX 78701"
      ],
      "categories": [
        "Restaurant"
      ],
      "category": "Restaurant",
      "cid": "10909873677001107616",
      "city": "Austin",
      "country_code": "US",
      "description": "Counter with farm-to-table burgers, rotisserie chicken, wings & salad plus breakfast options.",
      "distance_m": 372,
      "feature_id": "0x8644b507c51a5043:0x9767a84e660928a0",
      "full_address": "111 Congress Ave, Austin, TX 78701",
      "hours": {
        "Friday": [
          "8 AM–9 PM"
        ],
        "Monday": [
          "8 AM–9 PM"
        ],
        "Saturday": [
          "8 AM–9 PM"
        ],
        "Sunday": [
          "8 AM–9 PM"
        ],
        "Thursday": [
          "8 AM–9 PM"
        ],
        "Tuesday": [
          "8 AM–9 PM"
        ],
        "Wednesday": [
          "8 AM–9 PM"
        ]
      },
      "kgmid": "/g/11c5442_np",
      "latitude": 30.263959999999997,
      "longitude": -97.744068,
      "name": "Fareground Austin",
      "neighborhood": "Downtown Austin",
      "open_status": "Open · Closes 9 PM",
      "permanently_closed": null,
      "phone": "+1 555 010 0000",
      "phone_international": "+1 555 010 0000",
      "phones": [
        "+1 555 010 0000"
      ],
      "photos_count": 1646,
      "place_id": "ChIJQ1AaxQe1RIYRoCgJZk6oZ5c",
      "postal_code": "78701",
      "price_level": null,
      "review_count": 1439,
      "service_options": {
        "Accessibility": [
          "Assistive hearing loop",
          "Wheelchair accessible entrance",
          "… 3 more"
        ]
      },
      "stars": 4.4,
      "state": "Texas",
      "street": "111 Congress Ave",
      "thumbnail": "https://lh3.googleusercontent.com/-KQ66gAcIrrI/AAAAAAAAAAI/AAAAAAAAAAA/x1Ew8KrbT_Y/s44-p-k-no-ns-nd/photo.jpg",
      "timezone": "America/Chicago",
      "url": "https://www.google.com/maps/place/?q=place_id:ChIJQ1AaxQe1RIYRoCgJZk6oZ5c",
      "website": "https://www.faregroundaustin.com/",
      "website_domain": "faregroundaustin.com"
    },
    "… 18 more"
  ],
  "query": "places"
}
Response fields (73)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.cachedboolean
$.credits_usedinteger
$.locationobject
$.location.latnumber
$.location.lngnumber
$.location.zoominteger
$.next_pageinteger
$.pageinteger
$.placesarray
$.places[]object | string
$.places[].addressstring
$.places[].address_detailarray
$.places[].address_detail[]array
$.places[].address_detail[][]array | string
$.places[].address_detail[][][]array | integer
$.places[].address_detail[][][][]array | string
$.places[].address_detail[][][][][]string
$.places[].address_partsarray
$.places[].address_parts[]string
$.places[].categoriesarray
$.places[].categories[]string
$.places[].categorystring
$.places[].cidstring
$.places[].citystring
$.places[].country_codestring
$.places[].descriptionstring
$.places[].distance_minteger
$.places[].feature_idstring
$.places[].full_addressstring
$.places[].hoursobject
$.places[].hours.Fridayarray
$.places[].hours.Friday[]string
$.places[].hours.Mondayarray
$.places[].hours.Monday[]string
$.places[].hours.Saturdayarray
$.places[].hours.Saturday[]string
$.places[].hours.Sundayarray
$.places[].hours.Sunday[]string
$.places[].hours.Thursdayarray
$.places[].hours.Thursday[]string
$.places[].hours.Tuesdayarray
$.places[].hours.Tuesday[]string
$.places[].hours.Wednesdayarray
$.places[].hours.Wednesday[]string
$.places[].kgmidstring
$.places[].latitudenumber
$.places[].longitudenumber
$.places[].namestring
$.places[].neighborhoodstring
$.places[].open_statusstring
$.places[].permanently_closednull
$.places[].phonestring
$.places[].phone_internationalstring
$.places[].phonesarray
$.places[].phones[]string
$.places[].photos_countinteger
$.places[].place_idstring
$.places[].postal_codestring
$.places[].price_levelnull
$.places[].review_countinteger
$.places[].service_optionsobject
$.places[].service_options.Accessibilityarray
$.places[].service_options.Accessibility[]string
$.places[].starsnumber
$.places[].statestring
$.places[].streetstring
$.places[].thumbnailstring
$.places[].timezonestring
$.places[].urlstring
$.places[].websitestring
$.places[].website_domainstring
$.querystring