遷移 Places API 回應

新版 Place Details、Nearby Search 和 Text Search API 的回應格式已與現有 API 的格式有所不同。主要差異在於每個方法傳回的 Place 物件格式，如「回應 Place 物件的變更」一文所述。

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

回應 Place 物件的變更

本表列出 Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) 回應中新 Place 物件與現有 Place 物件的差異。

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

欄位 現有的 Place 物件 新的 Place 物件 附註
地址元件 address_components addressComponents
Place 微格式地址 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 物件中，並以 place.attributions 的形式呈現
地點陣列 results 現有 Place 物件的陣列 新的 Place 物件的 places 陣列
要求狀態 status 已改用標準 HTTP 回應 (HTTP 回應代碼和訊息)
所有錯誤訊息 error_message 已改用標準 HTTP 回應 (HTTP 回應代碼和訊息)
任何資訊訊息 info_messages 已移除
網頁憑證 next_page_token 已移除

Nearby Search 回應異動

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

欄位 Nearby Search (現有) Nearby Search (新版) 附註
放置歸因 html_attributions 將每個地點的資料移至新的 Place 物件中，並以 place.attributions 做為鍵
地點陣列 results 現有 Place 物件的陣列 新 Place 物件的 places 陣列
要求狀態 status 已改用標準 HTTP 回應 (HTTP 回應代碼和訊息)
所有錯誤訊息 error_message 已改用標準 HTTP 回應 (HTTP 回應代碼和訊息)
任何資訊訊息 info_messages 已移除
網頁憑證 next_page_token 已移除

Place Details 回應變更

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

欄位 Place Details (Existing) Place Details (新版) 附註
放置歸因 html_attributions 已移至新的 Place 物件，並以 attributions 的形式存在
地點詳細資訊 result 包含現有的 Place 物件 新的 Place 物件
要求狀態 status 已改用標準 HTTP 回應 (HTTP 回應代碼和訊息)
任何資訊訊息 info_messages 已改用標準 HTTP 回應 (HTTP 回應代碼和訊息)