地點資料欄位

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

如要進一步瞭解 Place Details 要求如何計費,請參閱用量與帳單

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

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

聯絡資料欄位

欄位 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

氣氛資料欄位

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

Place SearchNearby SearchText Search 要求都會傳回 Place Details 要求傳回的部分欄位。這些方法「不會」傳回下列欄位:

  • 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

若要為地點傳回一或多個資料欄位,請提出 Place Details 要求、傳遞地點 ID,並指定指定要傳回的欄位。