Place Data Fields (New)

  • This documentation details the data fields available when requesting place data using the Places SDK for iOS.

  • You must specify at least one field in the field mask (GMSPlaceProperty) to avoid errors when requesting data.

  • The cost of accessing specific fields is determined by the Place Details, Text Search, and Nearby Search SKUs.

  • Place data results are non-empty; if a field is requested but no data is available, it will not be included in the result.

  • The Places SDK for iOS offers a comprehensiveGMSPlacePropertyAll type for retrieving all data fields.

European Economic Area (EEA) developers If your billing address is in the European Economic Area, effective on 8 July 2025, the Google Maps Platform EEA Terms of Service will apply to your use of the Services. Functionality varies by region.Learn more.

Place data fields define the place data to return in the responseGMSPlaceobject forPlace Details (New),Text Search (New),andNearby Search (New).In the request, you specify the list of fields to return, called thefield mask, usingGMSPlaceProperty.If you don't specify at least one field in the field mask, or if you omit the field mask, then thecall returns an error.

This page lists all the place data fields by pricing tier (SKU). For more information about howrequests are billed, seeUsage and Billing.

Important: Because place data results cannot beempty, only place results with data are returned. For example, if a requestedplace has no photos, thephotos field won't be present in theresult.

Place data fields and SKUs

Field descriptionGMSPlaceProperty fieldPlace Details SKUText Search SKUNearby Search SKU
Address ComponentsGMSPlacePropertyAddressComponentsPlace Details EssentialsText Search ProNearby Search Pro
Business StatusGMSPlacePropertyBusinessStatusPlace Details ProText Search ProNearby Search Pro
Curbside PickupGMSPlacePropertyCurbsidePickupPlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
Current Opening HoursGMSPlacePropertyCurrentOpeningHoursPlace Details EnterpriseText Search ProNearby Search Enterprise
DeliveryGMSPlacePropertyDeliveryPlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
Dine-inGMSPlacePropertyDineInPlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
Editorial SummaryGMSPlacePropertyEditorialSummaryPlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
Formatted AddressGMSPlacePropertyFormattedAddressPlace Details EssentialsText Search ProNearby Search Pro
Icon Background ColorGMSPlacePropertyIconBackgroundColorPlace Details ProText Search ProNearby Search Pro
Image URLGMSPlacePropertyIconImageURLPlace Details ProText Search ProNearby Search Pro
International Phone NumberGMSPlacePropertyPhoneNumberPlace Details EnterpriseText Search EnterpriseNearby Search Enterprise
LocationGMSPlacePropertyCoordinatePlace Details EssentialsText Search ProNearby Search Pro
NameGMSPlacePropertyNamePlace Details ProText Search ProNearby Search Pro
Opening HoursGMSPlacePropertyOpeningHoursPlace Details EnterpriseText Search ProNearby Search Enterprise
PhotoGMSPlacePropertyPhotosPlace Details Essentials (IDs Only)Text Search ProNearby Search Pro
Place IDGMSPlacePropertyPlaceIDPlace Details Essentials (IDs Only)Text Search Essentials (IDs Only)Nearby Search Pro
Plus CodeGMSPlacePropertyPlusCodePlace Details EssentialsText Search ProNearby Search Pro
Price LevelGMSPlacePropertyPriceLevelPlace Details EnterpriseText Search ProNearby Search Enterprise
RatingGMSPlacePropertyRatingPlace Details EnterpriseText Search ProNearby Search Enterprise
ReservableGMSPlacePropertyReservablePlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
ReviewsGMSPlacePropertyReviewsPlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
Secondary Opening HoursGMSPlacePropertySecondaryOpeningHoursPlace Details EnterpriseText Search ProNearby Search Enterprise
Serves BeerGMSPlacePropertyServesBeerPlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
Serves BreakfastGMSPlacePropertyServesBreakfastPlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
Serves BrunchGMSPlacePropertyServesBrunchPlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
Serves DinnerGMSPlacePropertyServesDinnerPlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
Serves LunchGMSPlacePropertyServesLunchPlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
Serves Vegetarian FoodGMSPlacePropertyServesVegetarianFoodPlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
Serves WineGMSPlacePropertyServesWinePlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
TakeoutGMSPlacePropertyTakeoutPlace Details Enterprise + AtmosphereText Search Enterprise + AtmosphereNearby Search Enterprise + Atmosphere
TypeGMSPlacePropertyTypesPlace Details EssentialsText Search ProNearby Search Pro
User Ratings TotalGMSPlacePropertyUserRatingsTotalPlace Details EnterpriseText Search ProNearby Search Enterprise
UTC OffsetGMSPlacePropertyUTCOffsetMinutesPlace Details ProText Search ProNearby Search Pro
ViewportGMSPlacePropertyViewportPlace Details EssentialsText Search ProNearby Search Pro
WebsiteGMSPlacePropertyWebsitePlace Details EnterpriseText Search EnterpriseNearby Search Enterprise
Wheelchair Accessible EntranceGMSPlacePropertyWheelchairAccessibleEntrancePlace Details ProText Search ProNearby Search Pro

Places SDK for iOS all fields

In addition to the fields listed previously, the Places SDK for iOS includestheGMSPlacePropertyAll data type, which has the effect of returningall available data fields.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-11-21 UTC.