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，納入下列一或多個值：