遷移 Places API 回應

新 Pod 的回應格式 Place Details 搜尋附近搜尋文字 API 已變更現有 API 的格式。主要差別在於 每個方法傳回的 Place 物件格式,如 變更回應 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 已移除。使用 iconMaskBaseUriiconBackgroundColor。詳情請見 地點圖示 瞭解詳情
圖示背景顏色 icon_background_color iconBackgroundColor
圖示遮罩網址 icon_mask_base_uri iconMaskBaseUri
國際電話號碼 international_phone_number internationalPhoneNumber
文字地點名稱 name displayName 文字地點名稱現已可透過 displayName.textlanguagedisplayName.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 的回應變更

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

欄位 Nearby Search (現有) Nearby Search (新版) 附註
放置歸因 html_attributions 將每個地點的資料移至新的 Place 物件,並以 place.attributions 做為鍵
地點陣列 現有 Place 物件的 results 陣列 新的 Place 物件 places 陣列
要求狀態 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
地點詳細資訊 result 包含現有的 Place 物件 新的 Place 物件
要求狀態 status 已移至標準 HTTP 回應 (HTTP 回應代碼和訊息)
任何資訊訊息 info_messages 已改用標準 HTTP 回應 (HTTP 回應代碼和訊息)