遷移 Places API 回應

新 Place Details、Nearby Search 和 Text Search API 的回應格式已變更為現有 API 的格式。主要差異在於每個方法傳回的 Place 物件格式，如回應地點物件的變更一節所述。

此外，回應物件的頂層欄位也針對每個 API 變更。請參閱以下內容：

變更回應 Place 物件

下表顯示在 Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) 回應中新 Place 物件的變更，並與現有的 Place 物件進行比較。

新的回應物件會使用駝峰式大小寫做為欄位名稱、包含新欄位，以及重新命名部分現有欄位。

欄位 現有 Place 物件 新地點物件 附註
地址元件 address_components addressComponents
放置微格式地址 adr_address adrFormatAddress
商家狀態 business_status businessStatus
下週營業時間 current_opening_hours currentOpeningHours
編輯摘要 editorial_summary editorialSummary
格式化地址 formatted_address formattedAddress
國內電話號碼 formatted_phone_number nationalPhoneNumber
位置 geometry.location location
可視區域 geometry.viewport viewport
地點作者資訊 html_attributions attributions 現有 API 的回應頂層欄位
圖示網址 icon 已移除。請使用 iconMaskBaseUri 和 iconBackgroundColor。詳情請參閱「地點圖示」一文。
圖示背景顏色 icon_background_color iconBackgroundColor
圖示遮罩網址 icon_mask_base_uri iconMaskBaseUri
國際電話號碼 international_phone_number internationalPhoneNumber
文字地點名稱 name displayName 文字地點名稱現已以 displayName.text 和 language 的身分存取，格式為 displayName.languageCode
營業時間 opening_hours regularOpeningHours
相簿 photos photos 新的 Place 物件中的 photos 格式已變更。詳情請參閱「相片參考資料變更」一文。
地點 ID place_id id
Plus Code plus_code plusCode
價格等級 price_level priceLevel
Rating rating rating
評論 reviews reviews
從今天起下週的次要營業時間，例外情況和所有其他資料 secondary_opening_hours currentSecondaryOpeningHours
地點類型 types types
地點的 Google 地圖網址 url googleMapsUri
使用者評分次數 user_ratings_total userRatingCount
世界標準時間時差 utc_offset utcOffsetMinutes
簡短格式的地址，包含街道名稱和鄉鎮縣市 vicinity shortFormattedAddress
地點網站 website websiteUri
無障礙設施資訊 wheelchair_accessible_entrance accessibilityOptions 「wheelchair_accessible_entrance」目前在「accessibilityOptions.wheelchairAccessibleEntrance」
地點屬性 takeout, delivery, dine_in, curbside_pickup, reservable, serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine, serves_brunch, serves_vegetarian_food takeout, delivery, dineIn, curbsidePickup, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, servesBrunch, servesVegetarianFood
資源名稱 places/PLACE_ID 格式的 name 欄位 在現有的 API 中，name 欄位以文字字串的形式包含地點名稱。在新的 API 中，相關資訊位於 displayName 中。
地點主要類型 primaryTypeName 新品
將主要類型設為文字字串 primaryTypeDisplayName 新品
每週固定的次要營業時間，例外狀況和所有其他資料 regularSecondaryOpeningHours 新品
地點接受的付款方式 paymentOptions 新品
地點停車選項 parkingOptions 新品
地點相關的子目的地清單 subDestinations 新品
加油站的最新燃油選項相關資訊 fuelOptions 新品
地點的電動車充電資訊 evChargeOptions 新品
地點屬性 outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports 新品

Text Search 回應變更

下表顯示對現有 Text Search 回應物件的頂層欄位和 Text Search (新版) 回應物件的變更。針對新 API，回應中唯一的頂層欄位是 places 陣列。

欄位 Text Search (現有) Text Search (新版) 附註
地點作者資訊 html_attributions 以 place.attributions 的形式移至每個地點的新 Place 物件
地點陣列 現有 Place 物件的 results 陣列 新 Place 物件的 places 陣列
要求狀態 status 已移至標準 HTTP 回應 (HTTP 回應代碼和訊息)
所有錯誤訊息 error_message 已移至標準 HTTP 回應 (HTTP 回應代碼和訊息)
所有資訊訊息 info_messages 已移除
網頁權杖 next_page_token 已移除

Nearby Search 的回應變更

下表列出對現有 Nearby Search 回應物件的頂層欄位，以及 Nearby Search (新版) 的回應物件的變更。如果是新 API，回應中唯一的頂層欄位是 places 陣列。

欄位 Nearby Search (現有) Nearby Search (新版) 附註
地點作者資訊 html_attributions 以 place.attributions 的形式移至每個地點的新 Place 物件
地點陣列 現有 Place 物件的 results 陣列 新 Place 物件的 places 陣列
要求狀態 status 已移至標準 HTTP 回應 (HTTP 回應代碼和訊息)
所有錯誤訊息 error_message 已移至標準 HTTP 回應 (HTTP 回應代碼和訊息)
所有資訊訊息 info_messages 已移除
網頁權杖 next_page_token 已移除

Place Details 回應變更

下表列出對現有 Place Details 回應物件的頂層欄位，以及 Place Details (新功能) 的回應物件的變更。如果是新 API，回應中唯一的頂層欄位是 places 陣列。

欄位 Place Details (現有) Place Details (新) 附註
地點作者資訊 html_attributions 以 attributions 的形式移至新的 Place 物件
地點詳細資訊 包含現有 Place 物件的 result 新的 Place 物件
要求狀態 status 已移至標準 HTTP 回應 (HTTP 回應代碼和訊息)
所有資訊訊息 info_messages 已移至標準 HTTP 回應 (HTTP 回應代碼和訊息)