遷移 Places API 回應

新 Pod 的回應格式 Place Details 搜尋附近 和 搜尋文字 API 已變更現有 API 的格式。主要差別在於 每個方法傳回的 Place 物件格式，如 變更回應 Place 物件。

此外，回應物件的頂層欄位也包括 為每個 API 變更請參閱：

變更回應 Place 物件

下表顯示了新版 Place 物件 Place Details (新版) 回應中 Nearby Search (新版)，以及 Text Search (新版)，與現有 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 新版中的 photos 格式已變更 Place 物件。若需更多資訊，請參閲 變更相片參考資料。
地點 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 (新版)。針對新 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 的回應變更

下表顯示對 回應頂層欄位所做的變更 物體 現有的「搜尋附近」功能，以及 回應 物件 。如果是新 API，則只有 便是 places 陣列。

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

Place Details 回應變更

下表顯示對 回應頂層欄位所做的變更 物體 現有的 Place Details 和 回應 物件 。如果是新 API，則只有 便是 places 陣列。

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