Routes API 的大型車輛路線規劃功能可計算大型車輛的路線和預計到達時間。這項服務會根據車輛高度、重量、長度和危險物品分類，傳回避開限制的最佳化路線。這項服務也會產生路線權杖，可傳遞至 Navigation SDK，提供即時路線指引。
使用大型車輛路線規劃功能的優點
使用大型車輛路徑規劃，建構可解決大型車輛車隊物流挑戰的應用程式。
| 好處 | 說明 |
|---|---|
| 提高價格和規劃準確度 | 根據即時路況產生預估抵達時間，為卡車和公車等大型車輛提供更準確的報價和送達時間。 |
| 提升駕駛人安全和效率 | 引導駕駛人避開低橋、限重道路和其他危險路段。 |
| 簡化整個車隊的作業 | 搭配大型車輛路線規劃使用路徑最佳化功能，即可為整個車隊最佳化指派的負載和停靠順序。使用 Fleet Engine 即時掌握指派作業和車輛位置。 |
| 減少訓練並提高採用率 | 在自家應用程式中提供 Google 地圖導航體驗，讓大型車輛或卡車駕駛人感到熟悉 |
大型車輛路線規劃功能
使用大型車輛路線規劃功能，您可以執行下列重要作業：
- 指定詳細的車輛屬性，包括高度、重量、長度、寬度、車軸數量和危險物品分類。
- 取得專為車輛屬性計算的路線、行程時間和行程距離。
- 生成最佳化路線，方便車輛移動：自動避開迴轉，並優先選擇州際公路和高速公路。這樣一來，大型車輛就能行駛在符合司機需求和期望的路徑上。
- 使用卡車專屬的預計抵達時間模型，計算更準確的預計抵達時間。模型會結合觀察到的卡車行車速度與即時和預測交通資訊，為大型車輛提供更準確的預估時間。
- 使用路線權杖在 Navigation SDK 中啟用即時路況導航，從 Routes API 轉移卡車安全路線。
- 計算路線矩陣，判斷多個出發地和目的地之間的交通時間和距離，以便規劃整個車隊的行程。
- 為車隊規劃最佳路線，全面提升營運效率，同時兼顧可行性和安全性。
大型車輛路線的運作方式
大型車輛路線規劃功能會透過下列服務運作：
| 端點 | 作業 | 輸出 |
|---|---|---|
| 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 會傳回考量指定車輛資訊的路線。視指定的 fieldmask 而定，回應可能包含路線折線、卡車專屬預計抵達時間、行車距離，以及 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，開始導覽工作階段。