地點資料欄位

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

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

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

Basic Data

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

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.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

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 --- 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 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，並指定要傳回的欄位。