Automotive 適用的 Routes API

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

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

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

授權要求

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

不過,如果您呼叫 computeRoutescomputeRoutesMatrix 方法,則可以使用一般 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)。不過,這兩種大小寫的大小寫都相同。

此外,雖然將 annotatePathscomputeRoutescomputeRoutesMatrix 稱為「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)。
  • 延伸專用路線 (totalAxleCounttotalHeightMmtotalLengthMmtotalWidthMmtotalWeightKg)。