地点数据字段

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

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

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

基本数据

字段 Places API（旧版） Places Library、Maps JavaScript API Places SDK for Android（旧版） Places SDK for iOS（旧版）
地址组件 address_components address_components Place.Field.ADDRESS_COMPONENTS GMSPlaceFieldAddressComponents
地址 adr_address adr_address --- ---
商家状态 business_status business_status Place.Field.BUSINESS_STATUS GMSPlaceFieldBusinessStatus
设置了格式的地址 formatted_address formatted_address Place.Field.FORMATTED_ADDRESS GMSPlaceFieldFormattedAddress
视口 geometry/viewport geometry.viewport Place.Field.VIEWPORT GMSPlaceFieldViewport
地点 geometry/location geometry.location Place.Field.LOCATION GMSPlaceFieldCoordinate
图标 icon icon --- ---
图标遮罩基本 URI icon_mask_base_uri icon_mask_base_uri Place.Field.ICON_MASK_URL GMSPlaceFieldIconImageURL
图标背景颜色 icon_background_color icon_background_color Place.Field.ICON_BACKGROUND_COLOR GMSPlaceFieldIconBackgroundColor
名称 name name Place.Field.DISPLAY_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 --- Place.Field.ACCESSIBILITY_OPTIONS GMSPlaceFieldWheelchairAccessibleEntrance

联系人数据字段

字段 Places API（旧版） Places Library、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.INTERNATIONAL_PHONE_NUMBER GMSPlaceFieldPhoneNumber
营业时间 opening_hours opening_hours Place.Field.OPENING_HOURS GMSPlaceFieldOpeningHours
当前营业时间 current_opening_hours --- Place.Field.CURRENT_OPENING_HOURS GMSPlaceFieldCurrentOpeningHours
次要营业时间 secondary_opening_hours --- Place.Field.SECONDARY_OPENING_HOURS GMSPlaceFieldSecondaryOpeningHours
网站 website website Place.Field.WEBSITE_URI GMSPlaceFieldWebsite

氛围数据字段

字段 Places API（旧版） Places Library、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 --- Place.Field.EDITORIAL_SUMMARY GMSPlaceFieldEditorialSummary
价格水平 price_level price_level Place.Field.PRICE_LEVEL GMSPlaceFieldPriceLevel
评分 rating rating Place.Field.RATING GMSPlaceFieldRating
可预订 reservable --- Place.Field.RESERVABLE GMSPlaceFieldReservable
评价 reviews reviews Place.Field.REVIEWS ---
供应啤酒 serves_beer --- Place.Field.SERVES_BEER GMSPlaceFieldServesBeer
供应早餐 serves_breakfast --- Place.Field.SERVES_BREAKFAST GMSPlaceFieldServesBreakfast
供应早午餐 serves_brunch --- Place.Field.SERVES_BRUNCH GMSPlaceFieldServesBrunch
供应晚餐 serves_dinner --- Place.Field.SERVES_DINNER GMSPlaceFieldServesDinner
供应午餐 serves_lunch --- Place.Field.SERVES_LUNCH GMSPlaceFieldServesLunch
供应素食 serves_vegetarian_food --- Place.Field.SERVES_VEGETARIAN_FOOD GMSPlaceFieldServesVegetarianFood
供应葡萄酒 serves_wine --- Place.Field.SERVES_WINE GMSPlaceFieldServesWine
外带 takeout --- Place.Field.TAKEOUT GMSPlaceFieldTakeout
用户评分总计 user_ratings_total user_ratings_total Place.Field.USER_RATINGS_COUNT GMSPlaceFieldUserRatingsTotal

Maps JavaScript API 地点库字段支持

查找地点（旧版）、附近搜索（旧版）和文本搜索（旧版）请求均会返回“地点详情（旧版）”请求所返回的部分字段。这些方法不会返回以下字段：

  • address_component
  • adr_address
  • formatted_phone_number
  • international_phone_number
  • opening_hours（不会针对任何地点搜索返回。对于“附近搜索（旧版）”和“文本搜索（旧版）”，请使用 openNow 请求参数。）
  • reviews
  • takeout
  • type
  • url
  • utc_offset_minutes
  • vicinity
  • website

若要针对某个地点返回上述一个或多个数据字段，请发出地点详情（旧版）请求、传递地点 ID 并指定要返回的字段。