新 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 |
已移除。使用 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 的回應變更
下表顯示對 回應頂層欄位所做的變更
物體
找出現有的「搜尋附近」功能,以及 回應
物件
。如果是新 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 回應代碼和訊息) |