What you get back
Links to images,
not the images.
This is the distinction worth being clear about up front. What comes back are the photo
links Google publishes for a place - the same kind of value the Maps Scraper's
photo_url field carries, described in our data dictionary as a
"link to the image of the place". Not image files in a zip.
For most work that's what you want: links are small, they join cleanly onto a place table,
and you can fetch or render only the ones you actually need. If your workflow requires local
copies, downloading from the links is a step you control - which also keeps the licensing
question in your hands rather than ours. More on that below.
- query
- The place you submitted, echoed back on every one of its photo rows.
- name
- The place's name on Google Maps. Filled when you submit a name or a search; empty when you submit an ID, because the name comes from the search response rather than the photo feed.
- google_id
- Google's feature ID for the place - the 0x…:0x… pair the photo feed is keyed on.
- place_id
- Google's Place ID (ChIJ…) - your join key onto a place table you already hold.
- location_link
- The Google Maps URL for the place, including its coordinates.
- photo_id
- Google's identifier for this individual photo - use it to de-duplicate across runs.
- photo_url
- The link to the photo. This is the row: one link per row, not one row per place.
- photo_url_big
- The same photo at up to 2048×2048, for when the default size is too small to judge detail.
- latitude
- Latitude of the place the photo belongs to.
- longitude
- Longitude of the place the photo belongs to.
- photo_date
- When the photo was posted.
- photo_upload_source
- Which Google app posted it and how - gmm_android, gmm_ios, and the _review_post / _photo_post variants that tell you whether it arrived attached to a review.
- photo_source_video
- A video link when the entry is a video rather than a still. Empty on most rows: videos are a small share of any gallery.
- photo_tags
- Google's own gallery tags for the photo - front, food, vibe - the same tabs you see on the listing.
- photo_tag_ids
- The numeric IDs behind those tags, for filtering without string matching.
- original_photo_url
- The thumbnail-sized variant of the photo, as served in the gallery grid.
16 columns per photo - every column above on every plan, including the free tier.
Three identifiers - place_id, google_id and photo_id - make the export joinable onto place data you already hold and de-duplicable across repeat runs, so the photos become an extra table rather than a parallel copy of your place list. Expect many rows per place: a single well-photographed business can produce dozens, so the row count is driven by photo volume rather than by how many places you submitted.