適用於 Automotive 的 Routes API 為開發車內導航功能的汽車合作夥伴提供特殊屬性。其擴充了標準 Routes API,並包含專為汽車業量身打造的屬性。
適用於 Automotive 的 Routes API 說明文件內容
除了標準 Routes API 的說明文件以外,Automotive 適用的 Routes API 還包括以下內容:
- 版本資訊 (Automotive)
- 使用 OAuth (Automotive)
- 用戶端程式庫 (Automotive)
- REST 參考資料 (汽車)
- 遠端程序呼叫 (RPC) 參考資料 (Automotive)
授權要求
如要授權向 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
)。