從預覽版本遷移

Routes API 已於 2022 年 9 月發布公開預先發布版 (正式發布前)。正式發布前產品/功能受到《Google 地圖平台服務專屬條款》規範。詳情請參閱推出階段說明。

本節說明如何將應用程式從搶先版遷移至正式版。

正式版新增功能

正式版新增了下列預先發布版未包含的新功能：

• 除了地點 ID 和經緯度座標，您現在還可以在正式發布版中指定位置，方法如下：

  • 地址字串 (「伊利諾州芝加哥」或「澳洲北領地達爾文」)

    使用者通常會以地址字串輸入地址。不過，{product_name} 必須先在內部對地址字串進行地理編碼，轉換為經緯度座標，才能計算路線。

    此外，我們也新增了 regionCode 要求參數的支援，讓您指定要傳回特定地理區域的地理編碼結果。

  • Plus Code

    Plus Code 就像是街道地址，適用於沒有實際地址的人或地點。Plus code 是以經緯度為依據，並以數字和字母顯示，而非街道名稱和號碼。

• 計算路線回應現在包含 geocodingResults 陣列。對於要求中以地址字串或 Plus Code 指定的每個位置 (起點、目的地或中途停靠點)，API 都會執行地點 ID 查詢。這個陣列的每個元素都包含與位置相應的地點 ID，以及位置的其他中繼資料。系統會忽略要求中指定為地點 ID 或經緯度座標的位置。

現有預先發布版功能的異動

您現在必須在正式發布的 GA 中，將新的陣列 extraComputations 欄位新增至要求，明確啟用下列功能：

• 通行費資訊

• 燃料耗量

• 折線上的車流量

在搶先體驗版中，您可以使用欄位遮罩，指定要在回應中傳回這些功能的資訊。現在，你們必須：

• 設定新的 extraComputations 陣列要求參數，即可啟用這些功能。
• 設定欄位遮罩，指定要在回應中傳回的資訊。

我需要知道哪些資訊？

除非透過設定 extraComputations 明確啟用，否則下列欄位將不再納入計算路徑矩陣回應：

• travelAdvisory.tollInfo (收費資訊)

除非透過設定 extraComputations 明確啟用，否則下列欄位不會再納入 computeRoutes 回應：

• routes.legs.travelAdvisory.tollInfo(收費資訊)
• routes.travelAdvisory.tollInfo(收費資訊)
• routes.travelAdvisory.fuelConsumptionMicroliters(燃料耗量)
• routes.travelAdvisory.speedReadingIntervals(折線上的車流量)
• routes.legs.travelAdvisory.speedReadingIntervals(折線上的車流量)

我需要做些什麼？

如要接收收費資訊、燃料消耗量或折線路況的回應欄位，您必須將新的要求陣列欄位 extraComputations 設為包含下列一或多個值：

• 如要接收收費資訊，請將新的 extraComputations 陣列欄位設為 "TOLLS"。

• 如要接收油耗，請將新的 extraComputations 陣列欄位設為 "FUEL_CONSUMPTION"。

• 如要接收折線上的車流量資訊，請將新的 extraComputations 陣列欄位設為 "TRAFFIC_ON_POLYLINE"。