地点数据字段

请选择平台： 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`
地址	`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`

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 并指定要返回的字段。