REST Resource: places

  • The Place resource in Google Places API provides comprehensive data about real-world locations, including identification, contact details, location coordinates, user feedback, operational status, visuals, and descriptive information.

  • It utilizes various data structures such as LocalizedText, AddressComponent, PlusCode, LatLng, Viewport, and more to represent specific attributes.

  • Developers can leverage the Place resource to display place details, enable user interactions, and build location-aware applications using methods like autocomplete, get, searchNearby, and searchText.

  • Additional attributes offer specific insights into payment options, parking, sub-locations, fuel and EV charging, contextual information, links, pricing, timezone, service options, food and drinks, ambiance, and accessibility.

  • The resource incorporates AI-generated summaries, references, and contextual details for a more enriched understanding of the place and its surroundings.

Resource: Place

All the information representing a Place.

JSON representation 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "reviewSummary": {
    object (ReviewSummary)
  },
  "evChargeAmenitySummary": {
    object (EvChargeAmenitySummary)
  },
  "neighborhoodSummary": {
    object (NeighborhoodSummary)
  },
  "consumerAlert": {
    object (ConsumerAlert)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  },
  "pureServiceAreaBusiness": boolean
}
Fields
name

string

This Place's resource name, in places/{placeId} format. Can be used to look up the Place.
id

string

The unique identifier of a place.
displayName

object (LocalizedText)

The localized name of the place, suitable as a short human-readable description. For example, "Google Sydney", "Starbucks", "Pyrmont", etc.
types[]

string

A set of type tags for this result. For example, "political" and "locality". For the complete list of possible values, see Table A and Table B at https://developers.google.com/maps/documentation/places/web-service/place-types
primaryType

string

The primary type of the given result. This type must be one of the Places API supported types. For example, "restaurant", "cafe", "airport", etc. A place can only have a single primary type. For the complete list of possible values, see Table A and Table B at https://developers.google.com/maps/documentation/places/web-service/place-types. The primary type may be missing if the place's primary type is not a supported type. When a primary type is present, it is always one of the types in the types field.
primaryTypeDisplayName

object (LocalizedText)

The display name of the primary type, localized to the request language if applicable. For the complete list of possible values, see Table A and Table B at https://developers.google.com/maps/documentation/places/web-service/place-types. The primary type may be missing if the place's primary type is not a supported type.
nationalPhoneNumber

string

A human-readable phone number for the place, in national format.
internationalPhoneNumber

string

A human-readable phone number for the place, in international format.
formattedAddress

string

A full, human-readable address for this place.
shortFormattedAddress

string

A short, human-readable address for this place.
postalAddress

object (PostalAddress)

The address in postal address format.
addressComponents[]

object (AddressComponent)

Repeated components for each locality level. Note the following facts about the addressComponents[] array: - The array of address components may contain more components than the formattedAddress. - The array does not necessarily include all the political entities that contain an address, apart from those included in the formattedAddress. To retrieve all the political entities that contain a specific address, you should use reverse geocoding, passing the latitude/longitude of the address as a parameter to the request. - The format of the response is not guaranteed to remain the same between requests. In particular, the number of addressComponents varies based on the address requested and can change over time for the same address. A component can change position in the array. The type of the component can change. A particular component may be missing in a later response.
plusCode

object (PlusCode)

Plus code of the place location lat/long.
location

object (LatLng)

The position of this place.
viewport

object (Viewport)

A viewport suitable for displaying the place on an average-sized map. This viewport should not be used as the physical boundary or the service area of the business.
rating

number

A rating between 1.0 and 5.0, based on user reviews of this place.
googleMapsUri

string

A URL providing more information about this place.
websiteUri

string

The authoritative website for this place, e.g. a business' homepage. Note that for places that are part of a chain (e.g. an IKEA store), this will usually be the website for the individual store, not the overall chain.
reviews[]

object (Review)

List of reviews about this place, sorted by relevance. A maximum of 5 reviews can be returned.
regularOpeningHours

object (OpeningHours)

The regular hours of operation. Note that if a place is always open (24 hours), the close field will not be set. Clients can rely on always open (24 hours) being represented as an open period containing day with value 0, hour with value 0, and minute with value 0.
timeZone

object (TimeZone)

IANA Time Zone Database time zone. For example "America/New_York".
photos[]

object (Photo)

Information (including references) about photos of this place. A maximum of 10 photos can be returned.
adrFormatAddress

string

The place's address in adr microformat: http://microformats.org/wiki/adr.
businessStatus

enum (BusinessStatus)

The business status for the place.
priceLevel

enum (PriceLevel)

Price level of the place.
attributions[]

object (Attribution)

A set of data provider that must be shown with this result.
iconMaskBaseUri

string

A truncated URL to an icon mask. User can access different icon type by appending type suffix to the end (eg, ".svg" or ".png").
iconBackgroundColor

string

Background color for icon_mask in hex format, e.g. #909CE1.
currentOpeningHours

object (OpeningHours)

The hours of operation for the next seven days (including today). The time period starts at midnight on the date of the request and ends at 11:59 pm six days later. This field includes the specialDays subfield of all hours, set for dates that have exceptional hours.
currentSecondaryOpeningHours[]

object (OpeningHours)

Contains an array of entries for the next seven days including information about secondary hours of a business. Secondary hours are different from a business's main hours. For example, a restaurant can specify drive through hours or delivery hours as its secondary hours. This field populates the type subfield, which draws from a predefined list of opening hours types (such as DRIVE_THROUGH, PICKUP, or TAKEOUT) based on the types of the place. This field includes the specialDays subfield of all hours, set for dates that have exceptional hours.
regularSecondaryOpeningHours[]

object (OpeningHours)

Contains an array of entries for information about regular secondary hours of a business. Secondary hours are different from a business's main hours. For example, a restaurant can specify drive through hours or delivery hours as its secondary hours. This field populates the type subfield, which draws from a predefined list of opening hours types (such as DRIVE_THROUGH, PICKUP, or TAKEOUT) based on the types of the place.
editorialSummary

object (LocalizedText)

Contains a summary of the place. A summary is comprised of a textual overview, and also includes the language code for these if applicable. Summary text must be presented as-is and can not be modified or altered.
paymentOptions

object (PaymentOptions)

Payment options the place accepts. If a payment option data is not available, the payment option field will be unset.
parkingOptions

object (ParkingOptions)

Options of parking provided by the place.
subDestinations[]

object (SubDestination)

A list of sub-destinations related to the place.
fuelOptions

object (FuelOptions)

The most recent information about fuel options in a gas station. This information is updated regularly.
evChargeOptions

object (EVChargeOptions)

Information of ev charging options.
generativeSummary

object (GenerativeSummary)

AI-generated summary of the place.
containingPlaces[]

object (ContainingPlace)

List of places in which the current place is located.
addressDescriptor

object (AddressDescriptor)

The address descriptor of the place. Address descriptors include additional information that help describe a location using landmarks and areas. See address descriptor regional coverage in https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
priceRange

object (PriceRange)

The price range associated with a Place.
reviewSummary

object (ReviewSummary)

AI-generated summary of the place using user reviews.
evChargeAmenitySummary

object (EvChargeAmenitySummary)

The summary of amenities near the EV charging station.
neighborhoodSummary

object (NeighborhoodSummary)

A summary of points of interest near the place.
consumerAlert

object (ConsumerAlert)

The consumer alert message for the place when we detect suspicious review activity on a business or a business violates our policies.
utcOffsetMinutes

integer

Number of minutes this place's timezone is currently offset from UTC. This is expressed in minutes to support timezones that are offset by fractions of an hour, e.g. X hours and 15 minutes.
userRatingCount

integer

The total number of reviews (with or without text) for this place.
takeout

boolean

Specifies if the business supports takeout.
delivery

boolean

Specifies if the business supports delivery.
dineIn

boolean

Specifies if the business supports indoor or outdoor seating options.
curbsidePickup

boolean

Specifies if the business supports curbside pickup.
reservable

boolean

Specifies if the place supports reservations.
servesBreakfast

boolean

Specifies if the place serves breakfast.
servesLunch

boolean

Specifies if the place serves lunch.
servesDinner

boolean

Specifies if the place serves dinner.
servesBeer

boolean

Specifies if the place serves beer.
servesWine

boolean

Specifies if the place serves wine.
servesBrunch

boolean

Specifies if the place serves brunch.
servesVegetarianFood

boolean

Specifies if the place serves vegetarian food.
outdoorSeating

boolean

Place provides outdoor seating.
liveMusic

boolean

Place provides live music.
menuForChildren

boolean

Place has a children's menu.
servesCocktails

boolean

Place serves cocktails.
servesDessert

boolean

Place serves dessert.
servesCoffee

boolean

Place serves coffee.
goodForChildren

boolean

Place is good for children.
allowsDogs

boolean

Place allows dogs.
restroom

boolean

Place has restroom.
goodForGroups

boolean

Place accommodates groups.
goodForWatchingSports

boolean

Place is suitable for watching sports.
accessibilityOptions

object (AccessibilityOptions)

Information about the accessibility options a place offers.
pureServiceAreaBusiness

boolean

Indicates whether the place is a pure service area business. Pure service area business is a business that visits or delivers to customers directly but does not serve customers at their business address. For example, businesses like cleaning services or plumbers. Those businesses may not have a physical address or location on Google Maps.

LocalizedText

Localized variant of a text in a particular language.

JSON representation 
{
  "text": string,
  "languageCode": string
}
Fields
text

string

Localized string in the language corresponding to languageCode below.
languageCode

string

The text's BCP-47 language code, such as "en-US" or "sr-Latn".

For more information, see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

PostalAddress

Represents a postal address, such as for postal delivery or payments addresses. With a postal address, a postal service can deliver items to a premise, P.O. box, or similar. A postal address is not intended to model geographical locations like roads, towns, or mountains.

In typical usage, an address would be created by user input or from importing existing data, depending on the type of process.

Advice on address input or editing:

  • Use an internationalization-ready address widget such as https://github.com/google/libaddressinput.
  • Users should not be presented with UI elements for input or editing of fields outside countries where that field is used.

For more guidance on how to use this schema, see: https://support.google.com/business/answer/6397478.

JSON representation 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Fields
revision

integer

The schema revision of the PostalAddress. This must be set to 0, which is the latest revision.

All new revisions must be backward compatible with old revisions.
regionCode

string

Required. CLDR region code of the country/region of the address. This is never inferred and it is up to the user to ensure the value is correct. See https://cldr.unicode.org/ and https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for Switzerland.
languageCode

string

Optional. BCP-47 language code of the contents of this address (if known). This is often the UI language of the input form or is expected to match one of the languages used in the address' country/region, or their transliterated equivalents. This can affect formatting in certain countries, but is not critical to the correctness of the data and will never affect any validation or other non-formatting related operations.

If this value is not known, it should be omitted (rather than specifying a possibly incorrect default).

Examples: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (for example, state or zip code validation in the United States).
sortingCode

string

Optional. Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like "CEDEX", optionally followed by a number (for example, "CEDEX 7"), or just a number alone, representing the "sector code" (Jamaica), "delivery area indicator" (Malawi) or "post office indicator" (Côte d'Ivoire).
administrativeArea

string

Optional. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. For Spain, this is the province and not the autonomous community (for example, "Barcelona" and not "Catalonia"). Many countries don't use an administrative area in postal addresses. For example, in Switzerland, this should be left unpopulated.
locality

string

Optional. Generally refers to the city or town portion of the address. Examples: US city, IT comune, UK post town. In regions of the world where localities are not well defined or do not fit into this structure well, leave locality empty and use addressLines.
sublocality

string

Optional. Sublocality of the address. For example, this can be a neighborhood, borough, or district.
addressLines[]

string

Unstructured address lines describing the lower levels of an address.

Because values in addressLines do not have type information and may sometimes contain multiple values in a single field (for example, "Austin, TX"), it is important that the line order is clear. The order of address lines should be "envelope order" for the country or region of the address. In places where this can vary (for example, Japan), address_language is used to make it explicit (for example, "ja" for large-to-small ordering and "ja-Latn" or "en" for small-to-large). In this way, the most specific line of an address can be selected based on the language.

The minimum permitted structural representation of an address consists of a regionCode with all remaining information placed in the addressLines. It would be possible to format such an address very approximately without geocoding, but no semantic reasoning could be made about any of the address components until it was at least partially resolved.

Creating an address only containing a regionCode and addressLines and then geocoding is the recommended way to handle completely unstructured addresses (as opposed to guessing which parts of the address should be localities or administrative areas).
recipients[]

string

Optional. The recipient at the address. This field may, under certain circumstances, contain multiline information. For example, it might contain "care of" information.
organization

string

Optional. The name of the organization at the address.

AddressComponent

The structured components that form the formatted address, if this information is available.

JSON representation 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Fields
longText

string

The full text description or name of the address component. For example, an address component for the country Australia may have a long_name of "Australia".
shortText

string

An abbreviated textual name for the address component, if available. For example, an address component for the country of Australia may have a short_name of "AU".
types[]

string

An array indicating the type(s) of the address component.
languageCode

string

The language used to format this components, in CLDR notation.

PlusCode

Plus code (http://plus.codes) is a location reference with two formats: global code defining a 14mx14m (1/8000th of a degree) or smaller rectangle, and compound code, replacing the prefix with a reference location.

JSON representation 
{
  "globalCode": string,
  "compoundCode": string
}
Fields
globalCode

string

Place's global (full) code, such as "9FWM33GV+HQ", representing an 1/8000 by 1/8000 degree area (~14 by 14 meters).
compoundCode

string

Place's compound code, such as "33GV+HQ, Ramberg, Norway", containing the suffix of the global code and replacing the prefix with a formatted name of a reference entity.

LatLng

An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges.

JSON representation 
{
  "latitude": number,
  "longitude": number
}
Fields
latitude

number

The latitude in degrees. It must be in the range [-90.0, +90.0].
longitude

number

The longitude in degrees. It must be in the range [-180.0, +180.0].

Viewport

A latitude-longitude viewport, represented as two diagonally opposite low and high points. A viewport is considered a closed region, i.e. it includes its boundary. The latitude bounds must range between -90 to 90 degrees inclusive, and the longitude bounds must range between -180 to 180 degrees inclusive. Various cases include:

  • If low = high, the viewport consists of that single point.

  • If low.longitude > high.longitude, the longitude range is inverted (the viewport crosses the 180 degree longitude line).

  • If low.longitude = -180 degrees and high.longitude = 180 degrees, the viewport includes all longitudes.

  • If low.longitude = 180 degrees and high.longitude = -180 degrees, the longitude range is empty.

  • If low.latitude > high.latitude, the latitude range is empty.

Both low and high must be populated, and the represented box cannot be empty (as specified by the definitions above). An empty viewport will result in an error.

For example, this viewport fully encloses New York City:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON representation 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Fields
low

object (LatLng)

Required. The low point of the viewport.
high

object (LatLng)

Required. The high point of the viewport.

Review

Information about a review of a place.

JSON representation 
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string,
  "flagContentUri": string,
  "googleMapsUri": string,
  "visitDate": {
    object (Date)
  }
}
Fields
name

string

A reference representing this place review which may be used to look up this place review again (also called the API "resource" name: places/{placeId}/reviews/{review}).
relativePublishTimeDescription

string

A string of formatted recent time, expressing the review time relative to the current time in a form appropriate for the language and country.
text

object (LocalizedText)

The localized text of the review.
originalText

object (LocalizedText)

The review text in its original language.
rating

number

A number between 1.0 and 5.0, also called the number of stars.
authorAttribution

object (AuthorAttribution)

This review's author.
publishTime

string (Timestamp format)

Timestamp for the review.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
flagContentUri

string

A link where users can flag a problem with the review.
googleMapsUri

string

A link to show the review on Google Maps.
visitDate

object (Date)

The date when the author visited the place. This is trucated to month.

AuthorAttribution

Information about the author of the UGC data. Used in Photo, and Review.

JSON representation 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
Fields
displayName

string

Name of the author of the Photo or Review.
uri

string

URI of the author of the Photo or Review.
photoUri

string

Profile photo URI of the author of the Photo or Review.

Date

Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following:

  • A full date, with non-zero year, month, and day values.
  • A month and day, with a zero year (for example, an anniversary).
  • A year on its own, with a zero month and a zero day.
  • A year and month, with a zero day (for example, a credit card expiration date).

Related types:

JSON representation 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Fields
year

integer

Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
month

integer

Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
day

integer

Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.

OpeningHours

Information about business hour of the place.

JSON representation 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
Fields
periods[]

object (Period)

The periods that this place is open during the week. The periods are in chronological order, in the place-local timezone. An empty (but not absent) value indicates a place that is never open, e.g. because it is closed temporarily for renovations.

The starting day of periods is NOT fixed and should not be assumed to be Sunday. The API determines the start day based on a variety of factors. For example, for a 24/7 business, the first period may begin on the day of the request. For other businesses, it might be the first day of the week that they are open.

NOTE: The ordering of the periods array is independent of the ordering of the weekdayDescriptions array. Do not assume they will begin on the same day.
weekdayDescriptions[]

string

Localized strings describing the opening hours of this place, one string for each day of the week.

NOTE: The order of the days and the start of the week is determined by the locale (language and region). The ordering of the periods array is independent of the ordering of the weekdayDescriptions array. Do not assume they will begin on the same day.

Will be empty if the hours are unknown or could not be converted to localized text. Example: "Sun: 18:00–06:00"
secondaryHoursType

enum (SecondaryHoursType)

A type string used to identify the type of secondary hours.
specialDays[]

object (SpecialDay)

Structured information for special days that fall within the period that the returned opening hours cover. Special days are days that could impact the business hours of a place, e.g. Christmas day. Set for currentOpeningHours and currentSecondaryOpeningHours if there are exceptional hours.
nextOpenTime

string (Timestamp format)

The next time the current opening hours period starts up to 7 days in the future. This field is only populated if the opening hours period is not active at the time of serving the request.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
nextCloseTime

string (