地點資料欄位

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

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

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

Basic Data

欄位 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_offset utc_offset_minutes Place.Field.UTC_OFFSET GMSPlaceFieldUTCOffsetMinutes
附近 vicinity vicinity --- ---

聯絡資料欄位

欄位 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
網站 website website Place.Field.WEBSITE_URI GMSPlaceFieldWebsite

氣氛資料欄位

欄位 Places API 地點資料庫、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 Library、Maps JavaScript API 欄位支援

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

  • address_component
  • adr_address
  • formatted_phone_number
  • international_phone_number
  • opening_hours
  • reviews
  • type
  • url
  • utc_offset_minutes
  • vicinity
  • website

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