Get (Place Details)

GET https://places.googleapis.com/v1/places/{{placeId}}

Once you have a place ID, you can request more details about a particular establishment or point of interest by initiating a Place Details (New) request. A Place Details (New) request returns more comprehensive information about the indicated place such as its complete address, phone number, user rating and reviews.

There are many ways to obtain a place ID. You can use:

Request Params

KeyDatatypeRequiredDescription
languageCodestringThe language in which to return results.

See the list of supported languages. Google often updates the supported languages, so this list may not be exhaustive. If languageCode is not supplied, the API defaults to en. If you specify an invalid language code, the API returns an INVALID_ARGUMENT error. The API does its best to provide a street address that is readable for both the user and locals. To achieve that goal, it returns street addresses in the local language, transliterated to a script readable by the user if necessary, observing the preferred language. All other addresses are returned in the preferred language. Address components are all returned in the same language, which is chosen from the first component. If a name is not available in the preferred language, the API uses the closest match. The preferred language has a small influence on the set of results that the API chooses to return, and the order in which they are returned. The geocoder interprets abbreviations differently depending on language, such as the abbreviations for street types, or synonyms that may be valid in one language but not in another. | | regionCode | string | | The region code used to format the response, specified as a two-character CLDR code value. There is no default value.

If the country name of the formattedAddress field in the response matches the regionCode, the country code is omitted from formattedAddress. This parameter has no effect on adrFormatAddress, which always includes the country name, or on shortFormattedAddress, which never includes it.

Most CLDR codes are identical to ISO 3166-1 codes, with some notable exceptions. For example, the United Kingdom's ccTLD is "uk" (.co.uk) while its ISO 3166-1 code is "gb" (technically for the entity of "The United Kingdom of Great Britain and Northern Ireland"). The parameter can affect results based on applicable law. | | sessionToken | string | | Session tokens are user-generated strings that track Autocomplete (New) calls as "sessions." Autocomplete (New) uses session tokens to group the query and place selection phases of a user autocomplete search into a discrete session for billing purposes. Session tokens are passed into Place Details (New) calls that follow Autocomplete (New) calls. For more information, see Session tokens. |

HEADERS

KeyDatatypeRequiredDescription
X-Goog-Api-Keystring
X-Goog-FieldMaskstringSpecify the list of fields to return in the response by creating a response field mask. Pass the response field mask to the method by using the URL parameter $fields or fields, or by using the HTTP header X-Goog-FieldMask. There is no default list of returned fields in the response. If you omit the field mask, the method returns an error.

Field masking is a good design practice to ensure that you don't request unnecessary data, which helps to avoid unnecessary processing time and billing charges.

Specify a comma-separated list of place data types to return. For example, to retrieve the display name and the address of the place.

X-Goog-FieldMask: displayName,formattedAddress Note: Spaces are not allowed anywhere in the field list. Use * to retrieve all fields.

X-Goog-FieldMask: * Wildcard "" selects all fields. However, while that wildcard is fine to use in development, Google discourage the use of the wildcard () response field mask in production because of the large amount of data that can be returned. Further guidance for using iconMaskBaseUri and iconBackgroundColor can be found in Place Icons section. Specify one or more of the following fields:

The following fields trigger the Place Details (IDs Only) SKU:

id, name*, photos

  • The name field contains the place resource name in the form: places/PLACE_ID. Use displayName to access the text name of the place.

The following fields trigger the Place Details (Location Only) SKU:

addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

The following fields trigger the Place Details (Basic) SKU:

accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations, utcOffsetMinutes

The following fields trigger the Place Details (Advanced) SKU:

currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

The following fields trigger the Place Details (Preferred) SKU:

allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, reviews, servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDesserts, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout | | Content-Type | string | | |