地点数据字段

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。
选择平台Android iOS JavaScript Web 服务

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

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

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

基本数据

字段 Places API Maps JavaScript API 地点库 Places SDK for Android Places SDK for iOS
地址组成部分 address_component address_component Place.Field.ADDRESS_COMPONENTS GMSPlaceFieldAddressComponents
地址 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 --- --- ---
递送 delivery --- --- ---
堂食 dine_in --- --- ---
编辑摘要 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 --- --- ---
用户评分总计 user_ratings_total user_ratings_total Place.Field.USER_RATINGS_TOTAL GMSPlaceFieldUserRatingsTotal

Places API 字段支持

地点搜索附近搜索文本搜索请求均会返回“地点详情”请求所返回的部分字段。这些方法不会返回以下字段:

  • address_component
  • adr_address
  • curbside_pickup
  • current_opening_hours
  • delivery
  • dine_in
  • editorial_summary
  • formatted_phone_number
  • international_phone_number
  • opening_hours.periods
  • opening_hours.special_days
  • opening_hours.type
  • opening_hours.weekday_text
  • reservable
  • secondary_opening_hours
  • reviews
  • serves_beer
  • serves_breakfast
  • serves_brunch
  • serves_dinner
  • serves_lunch
  • serves_vegetarian_food
  • serves_wine
  • takeout
  • type
  • url
  • user_ratings_total
  • utc_offset_minutes
  • vicinity
  • website
  • wheelchair_accessible_entrance

如需返回某个地点的一个或多个数据字段,请发出地点详情请求,传递地点 ID 并指定要返回的字段。