新 Place Details、Nearby Search 和 Text Search API 的回應格式已變更為現有 API 的格式。主要差異在於每個方法傳回的 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.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
陣列。
欄位 | Nearby Search (現有) | Nearby Search (新版) | 附註 |
---|---|---|---|
地點作者資訊 | 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 物件 |
|
地點詳細資訊 | 包含現有 Place 物件的 result |
新的 Place 物件 | |
要求狀態 | status |
已移至標準 HTTP 回應 (HTTP 回應代碼和訊息) | |
所有資訊訊息 | info_messages |
已移至標準 HTTP 回應 (HTTP 回應代碼和訊息) |