地點資料欄位

選取平台： Android iOS JavaScript 網路服務

地點資料欄位定義要求 Place Details 時要傳回的地點資料類型。本頁面列出所有地點資料欄位，並說明各個 API/SDK 如何支援這些欄位 (地點欄位的支援會因平台和/或功能而異)。

如要進一步瞭解 Place Details 要求的計費方式，請參閱「用量與計費」一文。

下表按價格級別和平台列出所有支援的地點資料欄位值。

重要事項：地點資料結果不可空白，因此系統只會傳回含有資料的地點結果。例如，如果要求的地點沒有相片，photos 欄位就不會顯示在結果中。

Basic Data

欄位	Places API	Maps JavaScript API Places Library	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_offset`	`utc_offset_minutes`	`Place.Field.UTC_OFFSET`	`GMSPlaceFieldUTCOffsetMinutes`
附近地區	`vicinity`	`vicinity`	`---`	`---`
無障礙入口	`wheelchair_accessible_entrance`	`---`	`---`	`---`

Contact Data 欄位

欄位	Places API	Maps JavaScript API Places Library	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`

Atmosphere Data 欄位

欄位	Places API	Maps JavaScript API Places Library	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 Places Library 欄位支援

Find Place、Nearby Search 和 Text Search 要求都會傳回 Place Details 要求所傳回的部分欄位。這些方法「不會」傳回下列欄位：

address_component
adr_address
formatted_phone_number
international_phone_number
opening_hours (所有 Place Search 都不會傳回。如果是 Nearby Search 和 Text Search，請使用 openNow 要求參數)。
reviews
takeout
type
url
utc_offset_minutes
vicinity
website

如要針對某個地點傳回上列一或多個資料欄位，請提出 Place Details 要求、傳遞地點 ID，並指定要傳回的欄位。