簡介
Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) API 的回應格式已不同於舊版 API。主要差異在於每個方法傳回的 Place 物件格式，詳情請參閱「回應 Place 物件的變更」。
此外，每個 API 的回應物件頂層欄位也已變更。請參閱：
回應 Place 物件的變更
下表顯示 Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) 回應中新
Place 物件與舊
Place 物件的變更。
新回應物件的欄位名稱使用駝峰式大小寫，包含新欄位，並重新命名部分舊版欄位。
| 欄位 | Places API (舊版) 物件 | Places API (新版) 物件 | 附註 |
|---|---|---|---|
| 地址元件 | 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 物件，做為 place.attributions |
|
| 地點陣列 | 舊版 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 物件，做為 place.attributions |
|
| 地點陣列 | 舊版 Place 物件的 results 陣列 |
新 places 陣列
Place 物件 |
|
| 要求狀態 | status |
改為標準 HTTP 回應 (HTTP 回應代碼和訊息) | |
| 所有錯誤訊息 | error_message |
改為標準 HTTP 回應 (HTTP 回應代碼和訊息) | |
| 任何資訊訊息 | info_messages |
已移除 | |
| 頁面權杖 | next_page_token |
已移除 |
Place Details (New) 回應異動
下表顯示 Place Details (舊版) 的回應物件和 Place Details (新版) 的回應物件，其頂層欄位有哪些異動。在新版 API 中，回應的唯一頂層欄位是 places 陣列。
| 欄位 | Place Details (Legacy) | Place Details (新推出) | 附註 |
|---|---|---|---|
| 地點歸因 | html_attributions |
已移至新的 Place 物件，做為 attributions |
|
| Place Details (新推出) | 包含舊版 Place 物件的 result |
新的「Place」物件 | |
| 要求狀態 | status |
改為標準 HTTP 回應 (HTTP 回應代碼和訊息) | |
| 任何資訊訊息 | info_messages |
改為標準 HTTP 回應 (HTTP 回應代碼和訊息) |