Routes API 於 2022 年 9 月發布為公開預先發布版 (正式發布前)。正式發布前產品/功能受到《Google 地圖平台服務專屬條款》規範。詳情請參閱推出階段說明。
本節說明如何將應用程式從預覽版本遷移至正式發布版。
在正式發布版中加入的新功能
正式發布版加入了下列預先發布版未提供的新功能:
除了地點 ID 和經緯度座標之外,您現在還可以使用以下方式在 Google Analytics (分析) 版本中指定位置:
地址字串 (「Chicago, IL」或「Darwin, NT, Australia」)
地址字串通常是使用者輸入地址的方式。不過,{product_name} 必須先在內部對地址字串進行地理編碼,將其轉換為經緯度座標,才能計算路線。
此外,我們還新增對
regionCode
要求參數的支援功能,可讓您指定要傳回特定地理區域的地理編碼結果。-
Plus Code 就像是使用者或地點的街道地址,但沒有實際地址。Plus Codes 是以經緯度為依據,並以數字和英文字母顯示,而非含有街道名稱和號碼的地址。
運算路徑回應現在包含
geocodingResults
陣列。對於要求 (起點、目的地或中繼路線控點) 指定為地址字串或做為 Plus Code 的每個位置,API 都會執行地點 ID 查詢。這個陣列的每個元素都包含與地點對應的地點 ID,以及地點的其他中繼資料。如果要求中的位置指定為地點 ID 或經緯度座標,系統就會忽略這類位置。
現有預先發布版功能異動
您現在必須在要求中加入新的陣列 extraComputations
欄位,在 Google Analytics (分析) 中明確啟用下列功能:
在預覽版本中,您使用了欄位遮罩來指定在回應中傳回這些功能的資訊。現在,您必須執行下列兩項操作:
- 設定新的
extraComputations
陣列要求參數以啟用這些功能。 - 設定欄位遮罩以指定在回應中傳回資訊。
重要須知
除非透過設定 extraComputations
明確啟用下列欄位,否則 computeRouteMatrix 回應中將不再包含下列欄位:
travelAdvisory.tollInfo
(收費資訊)
除非透過設定 extraComputations
明確啟用下列欄位,否則 computeRoutes 回應將不再包含下列欄位:
routes.legs.travelAdvisory.tollInfo
(收費資訊)routes.travelAdvisory.tollInfo
(收費資訊)routes.travelAdvisory.fuelConsumptionMicroliters
(燃料消耗)routes.travelAdvisory.speedReadingIntervals
(折線上的路況)routes.legs.travelAdvisory.speedReadingIntervals
(折線上的路況)
我需要做些什麼?
如要接收折線上收費資訊、燃料消耗或車流量的回應欄位,您必須將新的要求陣列欄位 extraComputations
設為包含下列一或多個值: