Automotive 適用的 Routes API

適用於 Automotive 的 Routes API 為開發車內導航功能的汽車合作夥伴提供特殊屬性。其擴充了標準 Routes API，並包含專為汽車業量身打造的屬性。

適用於 Automotive 的 Routes API 說明文件內容

除了標準 Routes API 的說明文件以外，Automotive 適用的 Routes API 還包括以下內容：

授權要求

如要授權向 annotatePaths 提出要求，您必須使用以下所述的 OAuth 方法：使用 OAuth (Automotive)。這類要求會要求您搭配 OAuth 使用模擬功能，類似於呼叫 Automotive Maps API 的方式 (但範圍不同)。

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

Standard Routes API 的共用說明文件

Automotive 適用的 Routes API 會與標準 Routes API 共用說明文件，例如「Guides」分頁中的教學課程。

請注意，使用標準 Routes API 教學課程時，連結會指向標準參考資料。您必須前往 Routes API 中的對等連結，才能取得 Automotive 參考資料。方法是在瀏覽器網址中的 routes/ 後方加上 automotive/，例如：routes/automotive/。

取得協助

由於 Routes API for Automotive 並未開放給大眾使用，因此建議您不要向我們的公開 Issue Tracker 提交錯誤。我們為您的團隊提供公司專屬的 Issue Tracker 元件，以便您回報錯誤。如有任何其他疑慮，請洽詢您的 Google 聯絡人。

駝峰式大小寫慣例與術語

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

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

正式發布版 (正式發布版) 和實驗功能

本節說明 Automotive 適用的 Routes API 專用屬性。以下功能已正式發布。

透過 Routes API 公開的基本屬性

E7 折線 (以 E7 座標而非 E5 描述的標準編碼折線)：

實驗功能

以下功能仍在實驗階段，僅開放特定客戶使用：

透過 Routes API 公開的基本屬性

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

可沿著折線顯示的資訊

  • 交通壅塞路段 (以分鐘為單位) 測得。請參閱「IncidentType」。
  • 不含文字事件詳細資料的事件列舉。請參閱「IncidentInfo」。

請參閱「PolylineDetails」。

其他功能

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

路徑修飾符

您可以透過 API 觸發下列 RouteModifiers。然而，路徑可能仍在開發和測試中，因此可能不會遵循修飾符目標。如有疑問，請與 Google 代表聯絡。

  • 避免使用穿插廣告 (avoidVignettes[])。支援六個國家/地區：奧地利、 瑞士、匈牙利、斯洛維尼亞、斯洛伐克和捷克共和國。
  • 允許高乘載車輛 (HOV) 道路 (hovPreference)，目前僅在美國和加拿大推出。
  • 避開通道 (avoidTunnels)。
  • 延伸專用路線 (totalAxleCount、totalHeightMm、totalLengthMm、totalWidthMm、totalWeightKg)。