Automotive 適用的 Routes API 提供專屬屬性,讓開發車內導航功能的汽車合作夥伴使用。它會使用專為汽車業設計的屬性來擴充標準 Routes API,
Routes API for Automotive 說明文件包含的內容
除了標準 Routes API 的說明文件外,Automotive 的 Routes API 還包括下列項目:
- 版本資訊 (Automotive)
- 使用 OAuth (Automotive)
- 用戶端程式庫 (Automotive)
- REST 參考資料 (Automotive)
- RPC 參考資料 (Automotive)
授權要求
如要將要求授權給 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
)。