Place Data Fields

Select platform: Android iOS JavaScript Web Service

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 API fields support

Place Search, Nearby Search, and Text Search requests all return a subset of the fields that are returned by Place Details requests. These methods do NOT return the following fields:

address_component
adr_address
formatted_phone_number
international_phone_number
reviews
type
url
utc_offset
vicinity
website

To return one or more of these data fields for a place, make a Place Details request, pass a place ID, and specify which fields to return.