Google Maps
Google Maps
Google Maps place photos
GET /google-maps/v1/photosThe place's whole photo and video gallery, paged like the Maps gallery: each item has photo_id, photo_url, photo_url_large (=s0), size, location, date (photo_datetime_utc), type (photo or video), video_urls for videos and whether the owner uploaded it. Up to 200 per call (limit); pass next_cursor back as cursor (null on the last page). is_video=true keeps only videos. The first page also keeps the older photos list (cover photos and review photos). Identify the place by business_id or as for details.
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 |
|---|---|---|
feature_id | string | The place's Google data id (`0x…:0x…`), from search results (`feature_id`) or a Maps URL (`!1s0x…`). Example: 0x8644ca6bc309e81b:0x1f1a903bbb66839 |
cid | string | The place's CID (the number in `?cid=` Maps links), instead of feature_id. |
url | string | A Google Maps place URL, instead of feature_id. |
place_id | string | Google place id (`ChI…`), alone (resolved through its Maps page) or with `q` (the place name and city). |
q | string | With place_id, or alone: the place name and city to look up. |
hl | string | Language (default en). |
gl | string | Country (default us). |
limit | integer | Photos to return (max 200). |
business_id | string | The business: its `business_id` (`0x…:0x…`), `place_id` (`ChI…`) or `cid`, instead of feature_id. Example: 0x89c2598f7ff4aa09:0x313547e757cb8cea |
cursor | string | Value of `next_cursor` from the previous page. |
is_video | boolean | true: only videos. |
language | string | Language (same as `hl`, default en). |
region | string | Country (same as `gl`, default us). |
Every endpoint also takes: fields、raw、fresh、output、records
{
"cached": false,
"credits_used": 1,
"photos": [
{
"caption": null,
"height": 1367,
"id": "CIABIhCBrju2LNmiIE8BUuf1Z3Ib",
"url": "https://lh3.googleusercontent.com/grass-cs/AABkmLfJIKtqpCzKk8ZK26sD-UimId0Y5kZKPzmvwB1d_IbomeNX4wXLTnEH9Vb9r-4VgnIAv2KGYZh26SDOe3YpjkZZ-p_Ik…",
"width": 1080
},
{
"caption": null,
"height": 1560,
"id": "CIHM0ogKEICAgIC9i7zAGw",
"url": "https://lh3.googleusercontent.com/grass-cs/AABkmLfxnvwfIePp3G4HBtEOo7fwfEGvN6xKgaGGljP38EVP19oLpQisv3PCSKt3b-Ksq-AzR-LPWCyowl5VMEpSNJm7e1E26…",
"width": 1171
},
"… 11 more"
],
"photos_returned": 13,
"place": {
"feature_id": "0x397c4318fd9a8927:0xea7428bd31a33dd8",
"name": "Nothing Before Coffee Cafe - Gulmohar, Bhopal",
"photos_count": 1106,
"place_id": "ChIJJ4ma_RhDfDkR2D2jMb0odOo"
}
} Response fields (16)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.credits_used | integer |
$.photos | array |
$.photos[] | object | string |
$.photos[].caption | null |
$.photos[].height | integer |
$.photos[].id | string |
$.photos[].url | string |
$.photos[].width | integer |
$.photos_returned | integer |
$.place | object |
$.place.feature_id | string |
$.place.name | string |
$.place.photos_count | integer |
$.place.place_id | string |