Routes API 的大型車輛路線規劃功能可計算大型車輛的路線和預計到達時間。系統會根據車輛高度、重量、長度和危險物品分類，傳回避開限制的最佳化路線。這項服務也會產生路徑權杖，可傳遞至 Navigation SDK，提供即時路線指引。
使用大型車輛路線規劃功能的優點
使用大型車輛路徑規劃功能，建構可解決大型車輛車隊物流挑戰的應用程式。
| 好處 | 說明 |
|---|---|
| 提高價格和規劃準確度 | 根據即時路況產生特定預估抵達時間，為卡車和巴士等大型車輛提供更準確的報價和送達時間。 |
| 提升駕駛人安全和效率 | 引導駕駛人避開低橋、限重道路和其他危險路段。 |
| 簡化機群作業 | 搭配使用路徑最佳化和大型車輛路線規劃功能，為整個車隊最佳化指派的負載和停靠順序。使用 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，開始導覽工作階段。