遷移 Places API 回應

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

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

對「Place」物件的回應

下表比較了 Place Details (New)、Nearby Search (New) 和 Text Search (New) 回應中的「New」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
資源名稱 name 欄位 (格式為 places/PLACE_ID) 在現有的 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 回應異動

下表顯示現有 Nearby Search 與 Nearby Search (新) 回應物件的頂層欄位變更情形。如果是新 API，回應中唯一的頂層欄位是 places 陣列。

廣闊 搜尋附近地區 (現有) 搜尋附近地點 (新推出) 附註
地點屬性 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 物件
地點詳細資訊 result：包含現有 Place 物件 新的 Place 物件
要求的狀態 status 移至標準 HTTP 回應 (HTTP 回應碼和訊息)
任何資訊訊息 info_messages 移至標準 HTTP 回應 (HTTP 回應碼和訊息)