Google Maps
Google Maps
Google Maps places near a point
GET /google-maps/v1/nearbyPlaces 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
| Name | Type | Description |
|---|---|---|
latrequired | number | Latitude of the point. Example: 30.2672 |
lngrequired | number | Longitude of the point. Example: -97.7431 |
q | string | What to look for (default: any place). Example: restaurants |
zoom | integer | Map zoom 3-21 (default 15); lower is a wider area. |
page | integer | Page number (20 places per page). |
limit | integer | Places to return (default 20, max 200; each 20 is one more page). |
hl | string | Language (default en). |
gl | string | Country (default us). |
radius | integer | Only places within this many metres (10-100000), nearest first; sets the zoom to fit. |
subtypes | string | Keep only businesses with one of these categories (comma-separated, as in `subtypes`), e.g. `Plumber,Drainage service`. |
verified | boolean | true: only businesses claimed by their owner; false: only unclaimed ones. |
business_status | string | Keep only these statuses (comma-separated): OPEN, CLOSED_TEMPORARILY, CLOSED. |
extract_emails_and_contacts | boolean | true: 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. |
language | string | Language (same as `hl`, default en). |
region | string | Country (same as `gl`, default us). |
min_rating | number | Only places rated at least this (1-5, e.g. 4.5). |
open_now | true | false | true: 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 |
$.cached | boolean |
$.credits_used | integer |
$.location | object |
$.location.lat | number |
$.location.lng | number |
$.location.zoom | integer |
$.next_page | integer |
$.page | integer |
$.places | array |
$.places[] | object | string |
$.places[].address | string |
$.places[].address_detail | array |
$.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_parts | array |
$.places[].address_parts[] | string |
$.places[].categories | array |
$.places[].categories[] | string |
$.places[].category | string |
$.places[].cid | string |
$.places[].city | string |
$.places[].country_code | string |
$.places[].description | string |
$.places[].distance_m | integer |
$.places[].feature_id | string |
$.places[].full_address | string |
$.places[].hours | object |
$.places[].hours.Friday | array |
$.places[].hours.Friday[] | string |
$.places[].hours.Monday | array |
$.places[].hours.Monday[] | string |
$.places[].hours.Saturday | array |
$.places[].hours.Saturday[] | string |
$.places[].hours.Sunday | array |
$.places[].hours.Sunday[] | string |
$.places[].hours.Thursday | array |
$.places[].hours.Thursday[] | string |
$.places[].hours.Tuesday | array |
$.places[].hours.Tuesday[] | string |
$.places[].hours.Wednesday | array |
$.places[].hours.Wednesday[] | string |
$.places[].kgmid | string |
$.places[].latitude | number |
$.places[].longitude | number |
$.places[].name | string |
$.places[].neighborhood | string |
$.places[].open_status | string |
$.places[].permanently_closed | null |
$.places[].phone | string |
$.places[].phone_international | string |
$.places[].phones | array |
$.places[].phones[] | string |
$.places[].photos_count | integer |
$.places[].place_id | string |
$.places[].postal_code | string |
$.places[].price_level | null |
$.places[].review_count | integer |
$.places[].service_options | object |
$.places[].service_options.Accessibility | array |
$.places[].service_options.Accessibility[] | string |
$.places[].stars | number |
$.places[].state | string |
$.places[].street | string |
$.places[].thumbnail | string |
$.places[].timezone | string |
$.places[].url | string |
$.places[].website | string |
$.places[].website_domain | string |
$.query | string |