地点数据字段

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

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

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

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

基本数据

字段 Places API Places Library、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 --- ---

联系人数据字段

字段 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.PHONE_NUMBER GMSPlaceFieldPhoneNumber
营业时间 opening_hours opening_hours Place.Field.OPENING_HOURS GMSPlaceFieldOpeningHours
网站 website website Place.Field.WEBSITE_URI GMSPlaceFieldWebsite

氛围数据字段

字段 Places API Places Library、Maps JavaScript API Places SDK for Android Places SDK for iOS
路边自提 curbside_pickup --- --- ---
递送 delivery --- --- ---
堂食 dine_in --- --- ---
价格水平 price_level price_level Place.Field.PRICE_LEVEL GMSPlaceFieldPriceLevel
分级 rating rating Place.Field.RATING GMSPlaceFieldRating
评价 reviews reviews --- ---
外带 takeout --- --- ---
用户评分总计 user_ratings_total user_ratings_total Place.Field.USER_RATINGS_TOTAL GMSPlaceFieldUserRatingsTotal

Places API 字段支持

地点搜索附近搜索文本搜索请求都会返回地点详情请求返回的字段子集。这些方法不会返回以下字段:

  • address_component
  • adr_address
  • curbside_pickup
  • delivery
  • dine_in
  • formatted_phone_number
  • international_phone_number
  • reviews
  • takeout
  • type
  • url
  • utc_offset
  • vicinity
  • website

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