Google Maps response objects

Every object the Google Maps endpoints return, field by field, named after Google's Places API. Every key is there on every call: a field the platform does not show is null, and a list is empty.

`google_maps_place`

One business or place, as its Google Maps listing shows it. Returned by google-maps/places, google-maps/place.

Fields
Field	What it is
`place_id` string	Google's place ID — the same one the Places API and every Maps URL use.
`name` string	As the listing shows it.
`category` string · or null	The category printed under the name, e.g. "Coffee shop".
`categories` array of strings	Every category on the listing, the main one first.
`formatted_address` string · or null	The address as one line, as Google formats it.
`address` object	The same address in parts. Where the source gives the address as one line, only `country_code` is filled.
`address.street` string · or null	Street and number. `null` where the source gives the address as one line: see `formatted_address`.
`address.city` string · or null	City or town.
`address.region` string · or null	State, province or region.
`address.postal_code` string · or null	Postal or ZIP code.
`address.country_code` string · or null	ISO 3166-1 alpha-2, e.g. `US`.
`location` object · or null	The pin. `null` when the source does not give it.
`location.lat` number	Latitude.
`location.lng` number	Longitude.
`plus_code` string · or null	The global plus code, e.g. `87G8P2QX+RV`.
`rating` number · or null	The star rating, 1.0–5.0. `null` until the place has ratings.
`user_ratings_total` integer · or null	How many ratings the star rating is the average of.
`rating_distribution` object · or null	How many ratings of each star value, as the listing's bar chart shows them.
`rating_distribution.1` integer	One-star ratings.
`rating_distribution.2` integer	Two-star ratings.
`rating_distribution.3` integer	Three-star ratings.
`rating_distribution.4` integer	Four-star ratings.
`rating_distribution.5` integer	Five-star ratings.
`price_level` integer · or null	0 (free) to 4 (very expensive), as the Places API counts it.
`formatted_phone_number` string · or null	The phone number in local format.
`international_phone_number` string · or null	With the country code, e.g. `+1 718-555-0142`.
`website` URL · or null	The business's own site.
`url` URL	The place on Google Maps.
`business_status` string, one of	As the Places API reports it. OPERATIONAL · CLOSED_TEMPORARILY · CLOSED_PERMANENTLY
`opening_hours` object · or null	Regular opening hours. `null` when the listing has none.
`opening_hours.weekday_text` array of strings	Seven lines, Monday first, as the listing prints them.
`opening_hours.periods` array of objects	The same hours as data. A place open around the clock has one period with no `close`.
`opening_hours.periods[].open` object	When it opens.
`opening_hours.periods[].open.day` integer	0 is Sunday.
`opening_hours.periods[].open.time` string	24-hour `HHMM`, local time.
`opening_hours.periods[].close` object · or null	When it closes.
`opening_hours.periods[].close.day` integer	0 is Sunday.
`opening_hours.periods[].close.time` string	24-hour `HHMM`, local time.
`popular_times` array of objects · or null	The "Popular times" chart. `null` for places too quiet to have one.
`popular_times[].day` integer	0 is Sunday.
`popular_times[].busyness` array of integers	Twenty-four values, midnight first, 0–100 relative to the place's busiest hour.
`about` object, by heading	The listing's About tab, by heading: `service_options`, `accessibility`, `amenities`, `payments` and so on — only the headings the place has.
`claimed` boolean · or null	Whether the owner has claimed the listing. Unclaimed ones offer "Own this business?".
`photo` object · or null	The listing's main photo.
`photo.url` URL	The image on Google's CDN. We do not rehost images.
`photo.width` integer · or null	Pixels.
`photo.height` integer · or null	Pixels.
`photo.author_name` string · or null	Who uploaded it, as the listing credits them. `null` for the owner's own photos.
`photo.author_url` URL · or null	Their Google Maps contributor page.

`google_maps_review`

One Google review of a place. Returned by google-maps/reviews.

Fields
Field	What it is
`review_id` string	Google's id for the review.
`place_id` string	The place it is about.
`author` object	Who wrote the review.
`author.name` string · or null	As shown on the review. `null` where the source gives none.
`author.url` URL · or null	Their Google Maps contributor page.
`author.profile_photo_url` URL · or null	Their profile photo.
`author.is_local_guide` boolean	Whether they carry the Local Guide badge.
`author.review_count` integer · or null	How many reviews they have written, as the review shows.
`author.photo_count` integer · or null	How many photos they have posted.
`rating` integer · or null	1 to 5. `null` when the source gives no rating.
`text` string · or null	`null` for a rating with no words.
`language` string · or null	Two-letter code of the language it was written in.
`publish_time` time, ISO 8601 UTC · or null	When it was posted. `null` when the source does not say.
`like_count` integer · or null	How many people marked it helpful.
`photos` array of objects	Photos attached to the review.
`photos[].url` URL	The image on Google's CDN. We do not rehost images.
`photos[].width` integer · or null	Pixels.
`photos[].height` integer · or null	Pixels.
`photos[].author_name` string · or null	Who uploaded it, as the listing credits them. `null` for the owner's own photos.
`photos[].author_url` URL · or null	Their Google Maps contributor page.
`owner_response` object · or null	The "Response from the owner", where there is one.
`owner_response.text` string	The owner's reply.
`owner_response.publish_time` time, ISO 8601 UTC · or null	When the owner replied. `null` when the source does not say.

`google_maps_photo`

One photo on a place's listing. Returned by google-maps/photos.

Fields
Field	What it is
`url` URL	The image on Google's CDN. We do not rehost images.
`width` integer · or null	Pixels.
`height` integer · or null	Pixels.
`author_name` string · or null	Who uploaded it, as the listing credits them. `null` for the owner's own photos.
`author_url` URL · or null	Their Google Maps contributor page.

`google_maps_post`

An update the owner posted on a Google Maps listing. Returned by google-maps/posts.

Fields
Field	What it is
`text` string · or null	The post's text.
`date` string · or null	`YYYY-MM-DD`: the day the listing shows; it gives no time.
`image_url` URL · or null	The post's image.
`link_url` URL · or null	Where the post links, such as a booking page.