地点数据字段

选择平台： Android iOS JavaScript 网络服务

地点数据字段定义了请求地点详情时要返回的地点数据的类型。本页面列出了所有地点数据字段，还介绍了各个 API/SDK 如何支持这些字段（对地点字段的支持因平台和/或功能而异）。

如需详细了解“地点详情”请求的结算方式，请参阅使用量和结算。

下表按价格层级和平台列出了所有支持的地点数据字段值。

重要提示：由于地点数据结果不得为空，因此系统只会返回包含数据的地点结果。例如，如果所请求的地点没有照片，photos 字段将不会显示在结果中。

基本数据

字段	Places API	Maps JavaScript API 地点库	Places SDK for Android	Places SDK for iOS
地址组成部分	address_component	address_component	Place.Field.ADDRESS_COMPONENTS	GMSPlaceFieldAddressComponents
Address	adr_address	adr_address	---	---
商家状态	business_status	business_status	Place.Field.BUSINESS_STATUS	GMSPlaceFieldBusinessStatus
设置了格式的地址	formatted_address	formatted_address	Place.Field.ADDRESS	GMSPlaceFieldFormattedAddress
视口	geometry/viewport	geometry.viewport	Place.Field.VIEWPORT	GMSPlaceFieldViewport
位置	geometry/location	geometry.location	Place.Field.LAT_LNG	GMSPlaceFieldCoordinate
图标	icon	icon	---	---
图标遮罩基本 URI	icon_mask_base_uri	icon_mask_base_uri	Place.Field.ICON_URL	GMSPlaceFieldIconImageURL
图标背景颜色	icon_background_color	icon_background_color	Place.Field.ICON_BACKGROUND_COLOR	GMSPlaceFieldIconBackgroundColor
名称	name	name	Place.Field.NAME	GMSPlaceFieldName
已永久停业（已弃用）	permanently_closed	permanently_closed	---	---
照片	photos	photos	Place.Field.PHOTO_METADATAS	GMSPlaceFieldPhotos
地点 ID	place_id	place_id	Place.Field.ID	GMSPlaceFieldPlaceID
Plus Code	plus_code	plus_code	Place.Field.PLUS_CODE	GMSPlaceFieldPlusCode
类型	type	type	Place.Field.TYPES	GMSPlaceFieldTypes
网址	url	url	---	---
UTC 时差	utc_offset	utc_offset_minutes	Place.Field.UTC_OFFSET	GMSPlaceFieldUTCOffsetMinutes
周边	vicinity	vicinity	---	---
无障碍入口	wheelchair_accessible_entrance	---	---	---

联系人数据字段

字段	Places API	Maps JavaScript API 地点库	Places SDK for Android	Places SDK for iOS
电话号码	formatted_phone_number	formatted_phone_number	---	---
国际电话号码	international_phone_number	international_phone_number	Place.Field.PHONE_NUMBER	GMSPlaceFieldPhoneNumber
营业时间	opening_hours	opening_hours	Place.Field.OPENING_HOURS	GMSPlaceFieldOpeningHours
当前营业时间	current_opening_hours	---	---	---
次要营业时间	secondary_opening_hours	---	---	---
网站	website	website	Place.Field.WEBSITE_URI	GMSPlaceFieldWebsite

氛围数据字段

字段	Places API	Maps JavaScript API 地点库	Places SDK for Android	Places SDK for iOS
路边自提	curbside_pickup	---	Place.Field.CURBSIDE_PICKUP	GMSPlaceFieldCurbsidePickup
送餐	delivery	---	Place.Field.DELIVERY	GMSPlaceFieldDelivery
堂食	dine_in	---	Place.Field.DINE_IN	GMSPlaceFieldDineIn
编辑摘要	editorial_summary	---	---	---
价格水平	price_level	price_level	Place.Field.PRICE_LEVEL	GMSPlaceFieldPriceLevel
分级	rating	rating	Place.Field.RATING	GMSPlaceFieldRating
可预订	reservable	---	---	---
评价	reviews	reviews	---	---
供应啤酒	serves_beer	---	---	---
供应早餐	serves_breakfast	---	---	---
供应早午餐	serves_brunch	---	---	---
供应晚餐	serves_dinner	---	---	---
供应午餐	serves_lunch	---	---	---
供应素食	serves_vegetarian_food	---	---	---
供应葡萄酒	serves_wine	---	---	---
外带	takeout	---	Place.Field.TAKEOUT	GMSPlaceFieldTakeout
用户评分总计	user_ratings_total	user_ratings_total	Place.Field.USER_RATINGS_TOTAL	GMSPlaceFieldUserRatingsTotal

Places SDK for iOS 字段支持

除了上面列出的字段之外，Places SDK for iOS 还包含 GMSPlaceFieldAll 数据类型，其作用是返回所有可用的数据字段。

findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: 不支持以下字段：

• GMSPlaceFieldTakeout
• GMSPlaceFieldDelivery
• GMSPlaceFieldDineIn
• GMSPlaceFieldCurbsidePickup
• GMSPlaceFieldAddressComponents
• GMSPlaceFieldOpeningHours
• GMSPlaceFieldPhoneNumber
• GMSPlaceFieldWebsite
• GMSPlaceFieldUtcOffsetMinutes