Automotive 適用的 Routes API

Automotive 適用的 Routes API 提供專屬屬性，讓開發車內導航功能的汽車合作夥伴使用。它會使用專為汽車業設計的屬性來擴充標準 Routes API，

Routes API for Automotive 說明文件包含的內容

除了標準 Routes API 的說明文件外，Automotive 的 Routes API 還包括下列項目：

授權要求

如要將要求授權給 annotatePaths，您必須使用使用 OAuth (Automotive) 說明的 OAuth 方法。這些要求必須您搭配 OAuth 使用模擬功能，類似於呼叫 Automotive Maps API (但使用不同的範圍)。

不過，如果您呼叫的是 computeRoutes 或 computeRoutesMatrix 方法，可以使用一般 Routes API 文件中所述的任一授權類型：API 金鑰或 OAuth。

透過 Standard Routes API 共用說明文件

Automotive 適用的 Routes API 會與標準 Routes API 分享說明文件，例如「指南」分頁下的教學課程。

請注意，使用標準 Routes API 教學課程時，連結會指向標準參考資料。您必須前往 Routes API 中的對等連結，才能取得 Automotive 參考資料。只要在瀏覽器網址中的 routes/ 後方加上 automotive/，即可執行此操作，如下所示：routes/automotive/。

取得協助

由於 Automotive Routes API 尚未公開提供，因此請避免向 Google 的公開 Issue Tracker 回報錯誤。我們已經為您的團隊提供公司專屬的 Issue Tracker 元件，以便在其中回報錯誤。如有任何疑慮，請洽詢您的 Google 聯絡人。

駝峰式大小寫慣例和術語

說明文件大部分採用 REST 駝峰式大小寫慣例 (例如 annotatePaths)，而非 RPC 大小寫慣例 (AnnotatePaths)。不過，這兩種大小寫都相同。

此外，雖然將 annotatePaths、computeRoutes 或 computeRoutesMatrix 稱為「API」，但實際上其實是自訂方法。不過，您可能會發現它們稱為方法或 API。

正式發布版和實驗功能

本節說明 Routes API for Automotive 的獨特屬性。下列功能已全面開放使用。

透過 Routes API 公開的基本屬性

E7 折線 (使用 E7 座標，而非 E5 說明的標準編碼折線)：

實驗功能

下列功能仍在實驗階段，僅供特定客戶使用：

透過 Routes API 公開的基本屬性

  • 使用做為選填輸入內容的路徑權杖。請參閱 Route 中的 routeToken。

折線上可取得的資訊

  • 交通壅塞的延遲時間，以分鐘為單位。請參閱「IncidentType」。
  • 不含文字事件詳細資料的事件列舉。請參閱「IncidentInfo」。

請參閱「PolylineDetails」。

其他功能

  • 沿途的海拔高度。請參閱「AltitudeInfo」。
  • 沿途的預測速度值區 (8 個值區，每個區間寬度為 10 至 20 公里)。請參閱「PredictedSpeedInfo」。

路徑修飾符

您可以透過 API 觸發下列 RouteModifiers。不過，路徑可能未遵循修飾符目標，因為它們仍在開發和測試中。如有疑問，請洽詢您的 Google 代表。

  • 避免使用穿插廣告 (avoidVignettes[])。支援以下六個國家/地區：奧地利、瑞士、匈牙利、斯洛維尼亞、斯洛伐克和捷克。
  • 允許高乘載車輛 (HOV) 道路 (hovPreference)。適用於美國和加拿大。
  • 避開通道 (avoidTunnels)。
  • 拖車專屬路徑 (totalAxleCount、totalHeightMm、totalLengthMm、totalWidthMm、totalWeightKg)。