Place Data Fields

Place data fields define the types of Place data to return when requesting Place Details. This page lists all place data fields, and explains how they are supported for each API/SDK (support for place fields varies by platform and/or feature).

For more information about how Place Details requests are billed, see Usage and Billing.

The following table lists all supported place data field values by pricing tier, and platform.

Important: Because place data results cannot be empty, only place results with data are returned. For example, if a requested place has no photos, the photos field will not be present in the result.

Basic Data

Field	Places API	Places Library, Maps JavaScript API	Places SDK for Android	Places SDK for iOS
Address Component	`address_component`	`address_component`	`Place.Field.ADDRESS_COMPONENTS`	`GMSPlaceFieldAddressComponents`
Address	`adr_address`	`adr_address`	`---`	`---`
Business Status	`business_status`	`business_status`	`Place.Field.BUSINESS_STATUS`	`GMSPlaceFieldBusinessStatus`
Formatted Address	`formatted_address`	`formatted_address`	`Place.Field.ADDRESS`	`GMSPlaceFieldFormattedAddress`
Viewport	`geometry/viewport`	`geometry.viewport`	`Place.Field.VIEWPORT`	`GMSPlaceFieldViewport`
Location	`geometry/location`	`geometry.location`	`Place.Field.LAT_LNG`	`GMSPlaceFieldCoordinate`
Icon	`icon`	`icon`	`---`	`---`
Icon Mask Base URI	`icon_mask_base_uri`	`icon_mask_base_uri`	`Place.Field.ICON_URL`	`GMSPlaceFieldIconImageURL`
Icon Background Color	`icon_background_color`	`icon_background_color`	`Place.Field.ICON_BACKGROUND_COLOR`	`GMSPlaceFieldIconBackgroundColor`
Name	`name`	`name`	`Place.Field.NAME`	`GMSPlaceFieldName`
Permanently Closed (deprecated)	`permanently_closed`	`permanently_closed`	`---`	`---`
Photo	`photos`	`photos`	`Place.Field.PHOTO_METADATAS`	`GMSPlaceFieldPhotos`
Place ID	`place_id`	`place_id`	`Place.Field.ID`	`GMSPlaceFieldPlaceID`
Plus Code	`plus_code`	`plus_code`	`Place.Field.PLUS_CODE`	`GMSPlaceFieldPlusCode`
Type	`type`	`type`	`Place.Field.TYPES`	`GMSPlaceFieldTypes`
URL	`url`	`url`	`---`	`---`
UTC Offset	`utc_offset`	`utc_offset_minutes`	`Place.Field.UTC_OFFSET`	`GMSPlaceFieldUTCOffsetMinutes`
Vicinity	`vicinity`	`vicinity`	`---`	`---`

Contact Data Fields

Field	Places API	Places Library, Maps JavaScript API	Places SDK for Android	Places SDK for iOS
Phone Number	`formatted_phone_number`	`formatted_phone_number`	`---`	`---`
International Phone Number	`international_phone_number`	`international_phone_number`	`Place.Field.PHONE_NUMBER`	`GMSPlaceFieldPhoneNumber`
Opening Hours	`opening_hours`	`opening_hours`	`Place.Field.OPENING_HOURS`	`GMSPlaceFieldOpeningHours`
Website	`website`	`website`	`Place.Field.WEBSITE_URI`	`GMSPlaceFieldWebsite`

Atmosphere Data Fields

Field	Places API	Places Library, Maps JavaScript API	Places SDK for Android	Places SDK for iOS
Price Level	`price_level`	`price_level`	`Place.Field.PRICE_LEVEL`	`GMSPlaceFieldPriceLevel`
Rating	`rating`	`rating`	`Place.Field.RATING`	`GMSPlaceFieldRating`
Reviews	`reviews`	`reviews`	`---`	`---`
User Ratings Total	`user_ratings_total`	`user_ratings_total`	`Place.Field.USER_RATINGS_TOTAL`	`GMSPlaceFieldUserRatingsTotal`

Places SDK for Android fields support

findCurrentPlace() does NOT support the following fields:

Place.Field.ADDRESS_COMPONENTS
Place.Field.OPENING_HOURS
Place.Field.PHONE_NUMBER
Place.Field.WEBSITE_URI
Place.Field.UTC_OFFSET