Get the full record of one photo or video of a business: when it was uploaded (to the hour), when it was taken, where, by whom, and how it reached Google Maps (the owner’s Business Profile, the Maps app on Android or iOS, Maps on the web, Google Search). Take the photo_id from Business Photos
. To get these fields for a whole page of photos in one call, use details=true on Business Photos instead.
HTTP Request
| |
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
business_id | string | Yes | — | Google ID (0x...:0x...), place ID (ChIJ...) or numeric CID of the business the photo belongs to |
photo_id | string | Yes | — | The id of a photo from Business Photos |
lang | string | No | "en" | Language code for the response |
country | string | No | "us" | Country code for regional context |
Response
| |
Response Fields
| Field | Type | Description |
|---|---|---|
status | boolean | true when the request succeeded |
request_id | string | Unique identifier for this request |
data | object | The photo |
data.id | string | Photo id |
data.url | string | Photo URL. Add a size suffix such as =w1600-h1200-k-no to resize |
data.type | string | photo or video |
data.max_size | array | [width, height] of the original in pixels |
data.aspect_ratio | number | Width divided by height |
data.date | string | Upload date as YYYY-M-D (not zero-padded) |
data.timestamp | integer | Upload time as Unix epoch seconds, to the hour, UTC |
data.taken_date | string/null | Date the photo was taken, YYYY-M-D. Same day as date or earlier |
data.taken_timestamp | integer/null | taken_date at midnight UTC (Google gives no hour for it) |
data.latitude | number | Latitude Google attaches to the photo, usually the business’s own position |
data.longitude | number | Longitude Google attaches to the photo |
data.user_name | string | Who uploaded it. For owner photos this is the business name |
data.user_id | string | Uploader’s Google Maps contributor id |
data.user_profile_url | string | Uploader’s contributor page |
data.user_avatar | string | Uploader’s avatar URL |
data.video_url | string/null | MP4 link (largest rendition), videos only |
data.video_duration_ms | integer/null | Video length in milliseconds, videos only |
data.uploaded_by_owner | boolean/null | true when the business uploaded it, false for a customer |
data.upload_source | string/null | How the photo reached Google Maps (values below) |
data.from_review | boolean/null | true when the photo was posted with a review |
request_params | object | The parameters you sent |
upload_source values
| Value | Meaning |
|---|---|
business_profile | The owner, through Google Business Profile |
maps_android | Google Maps app on Android |
maps_ios | Google Maps app on iOS |
maps_web | Google Maps on the web |
google_search | The business panel on Google Search |
other | Any other source |
Notes
timestampcarries the upload hour (UTC).taken_timestamphas no hour, so it is always midnight UTC.- In the example the owner took the photo in October 2014 and uploaded it in February 2018. For customer photos posted from the Maps app the two dates are often the same day.
- Street View panoramas listed by Business Photos
(
type: null) have no details entry. - Calling this endpoint for every photo of a page costs as much as
details=trueon Business Photos, which does it in one call.
Error Responses
| |
| Status Code | Cause | Description |
|---|---|---|
| 400 | Unknown photo_id | The photo does not belong to that business, or the id is wrong |
| 400 | Missing parameter | "Invalid parameter 'photo_id': Field required" |
| 503 | Upstream failure | Google did not answer. Retry the call |
Code Examples
| |
| |
| |
Related Endpoints
- Business Photos
— List photo ids, or get these fields for a whole page with
details=true - Business Photos Categories — Filter the photo list by category
- Business Details — The business the photo belongs to