Routes API 的大型車輛路線規劃功能可計算大型車輛的路線和預計到達時間。這項服務會根據車輛高度、重量、長度和危險物質分類，傳回避開限制的最佳路線。這項服務也會產生路徑權杖，可傳遞至 Navigation SDK，提供即時路線指引。
使用大型車輛路線規劃的原因
使用大型車輛路線規劃功能建構應用程式，解決大型車隊的物流難題。
| 優點 | 說明 |
|---|---|
| 提高定價和規劃準確度 | 生成具體且考量路況的預計到達時間，為卡車和公車等大型車輛提供更準確的報價和送達時間。 |
| 提升駕駛安全和效率 | 引導駕駛避開低矮橋梁、限重道路和其他危險路段。 |
| 簡化機群作業 | 搭配使用 Route Optimization 和大型車輛路線規劃，可為整個車隊最佳化載貨分配和停靠順序。使用 Fleet Engine 即時掌握任務和車輛位置。 |
| 減少訓練時間，提高採用率 | 在自家應用程式中，為大型車輛或卡車駕駛提供熟悉的 Google 地圖導航體驗 |
大型車輛路線規劃功能
大型車輛路線規劃功能可讓您執行下列重要作業：
- 指定詳細車輛屬性，包括高度、重量、長度、寬度、軸數和危險物品分類。
- 取得路線、行程時間和行程距離：系統會根據車輛屬性計算這些資訊。
- 產生最適合行駛的路線：自動避開迴轉，並優先選擇州際公路和高速公路。這樣一來，大型車輛就能行駛在符合駕駛人需求和期望的路線上。
- 使用卡車專用預計到達時間模型，計算更準確的預計到達時間。模型會結合觀察到的卡車行駛速度，以及即時和預測路況資料，為大型車輛提供更準確的預估值。
- 在 Navigation SDK 中啟用即時路況導航，並使用路線權杖從 Routes API 轉移卡車安全路線。
- 計算路線矩陣，判斷多個起點和目的地之間的行程時間和距離，以便規劃整個車隊。
- 規劃最佳卡車車隊路線，在考量可行性和安全性的前提下，提升整體作業效率。
大型車輛路線規劃的運作方式
大型車輛路線規劃功能可透過下列服務運作：
| Endpoint | Operation | 輸出 |
|---|---|---|
| Routes API | 向 Routes API 端點 (computeRoutes 或 computeRouteMatrix) 發出 HTTPS 要求，並在要求主體中加入起點和目的地。travelMode 必須設為 TRUCK，且 routeModifiers 物件必須包含 vehicleInfo。 |
路線折線、路線路段和步驟清單、預估行程時間，以及路線權杖。 |
| Route Optimization API | 向 Route Optimization API 端點傳送 HTTPS 要求。travelMode 必須設為 TRUCK，且 routeModifiers 物件必須包含 vehicleInfo。 |
為車隊規劃的最佳路線 (專為特定車輛設計)，以及每趟行程的路線權杖。 |
| Navigation SDK (Android、iOS) | 在導航器中設定目的地時，請加入路線權杖 (由 Routes API 或 Route Optimization API 搭配大型車輛路線規劃功能產生)。 | 專為卡車量身打造的即時路況導航體驗，並遵循原始 Routes API 或 Route Optimization API 要求中指定的車輛資訊。 |
範例
以下範例著重於如何搭配 Routes API 使用大型車輛路線規劃。
舉例來說，基本的 computeRoutes 要求主體如下所示：
{
"origin": { "location": { "latLng": { "latitude": 41.31, "longitude": -74.75 }}},
"destination": { "location": { "latLng": { "latitude": 41.30, "longitude": -74.78 }}},
"travelMode": "TRUCK",
"routeModifiers": {
"vehicleInfo": {
"totalHeightMm": 4114,
"totalLengthMm": 21945,
"totalWeightKg": 32658,
... // other vehicle attributes
}
}
}
必要：要求必須將 travelMode 設為 TRUCK，並在 vehicleInfo 物件中填入車輛的特定尺寸和屬性。
Routes API 會根據指定的車輛資訊傳回路線。回應可能包含路線折線、卡車專屬預計到達時間、行程距離，以及與 Navigation SDK 搭配使用的路線權杖，具體取決於指定的欄位遮罩。如果找不到完全符合規定的路線，回應也會指出。
要求和回應內容
下表列出使用 Routes API computeRoutes 方法，提出大型車輛路線規劃要求時，傳送及接收的資料。
| 要求內容 | 回應內容 | 傳回格式 |
|---|---|---|
|
|
JSON |
限制
開始之前，請務必瞭解下列限制和規定。
- 適用地區：大型車輛路線規劃功能適用於美國本土 48 州 (正式發布) 和日本 (實驗版)。不適用於阿拉斯加、夏威夷或美國領地。
- 駕駛建議和安全。駕駛人不應僅依賴這個 API 傳回的路線，來確保行車安全或合法。路線不一定適合車輛行駛，駕駛人可能會遇到危險，例如低矮橋梁或禁止大型車輛通行的道路。
- 盡力路由。在某些情況下，API 無法找到完全符合行程限制的路線。而是會傳回「盡可能」避開管制區的路線，但仍可能穿過管制區。Routes API 回應會在
routeRestrictionsPartiallyIgnored欄位中清楚標示這些路線。在這種情況下，請仔細規劃路線，最好使用其他來源資料。請勿將標記的路線做為規劃或導航的單一事實來源。 - 不支援的功能：大型車輛路線不支援下列功能：
- 卡車過路費
- 速限
- 放射性危險物質路線
- 用量限制：所有要求都必須遵守標準每秒查詢次數 (QPS) 限制。
如何使用大型車輛路線
請按照下列步驟，使用 Routes API 規劃大型車輛路線：
- 設定專案：確認您已建立 Google Cloud 專案，並為 Routes API 啟用該專案。
- 大型車輛路線規劃功能佈建：大型車輛路線規劃功能僅開放給部分客戶，請與我們聯絡要求存取權，並為專案佈建這項功能。
- 建立要求：呼叫
computeRoutes或computeRouteMatrix端點，將travelMode設為TRUCK，將routingPreference設為TRAFFIC_AWARE_OPTIMAL，並使用vehicleInfo物件指定車輛屬性。 - 提供即時路況導航 (選用)：如果您呼叫了
computeRoutes，請將回應中的routeToken傳遞至 Navigation SDK，以啟動導航工作階段。