Routes API 的大型車輛路線規劃功能是一系列服務，可計算大型車輛的路線和預計抵達時間。只要接受指定車輛屬性 (例如高度、重量、長度和危險物品分類) 的要求，系統就會傳回經過最佳化的路線，避開相關限制。這項服務也會產生路線權杖，可傳遞至 Navigation SDK，為駕駛人提供卡車專屬路徑的即時路線指引。
為什麼要使用大型車輛路線規劃功能
使用大型車輛路徑規劃功能，建構可解決大型車輛車隊物流挑戰的應用程式。
| 好處 | 應用程式行為 |
|---|---|
| 提高價格和規劃準確度 | 根據即時路況產生預估抵達時間，為卡車和公車等大型車輛提供更準確的報價和送達時間。 |
| 提升駕駛人安全和效率 | 引導駕駛人避開低橋、限重道路和其他危險路段。 |
| 簡化整個車隊的營運 | 搭配使用路徑最佳化和大車路線規劃功能，即可為整個車隊最佳化貨物分配和停靠順序。使用 Fleet Engine 即時掌握指派作業和車輛位置資訊。 |
| 減少訓練並提高採用率 | 在自家應用程式中提供 Google 地圖導航體驗，讓大型車輛或卡車駕駛人感到熟悉 |
大型車輛路線規劃功能
使用大型車輛路線規劃功能，您可以執行下列重要作業：
- 指定詳細的車輛設定檔，包括高度、重量、長度、寬度、車軸數量和危險物品分類。
- 取得 路線、行程時間和行程距離：系統會使用 Google 完整的道路資料和車流量模型，根據車輛屬性計算這些資訊。
- 使用我們全新的卡車專用預計抵達時間模型，計算更準確的預計抵達時間。這項模型會結合觀察到的卡車行車速度，以及即時和預測的交通資訊，為大型車輛提供更準確的預估時間。
- 使用路線權杖在 Navigation SDK 中啟用即時路況導航，從 Routes API 轉移卡車安全路線。
- 計算路線矩陣，判斷多個出發地和目的地之間的行程時間和距離，以便規劃整個車隊的行程。
- 為車隊規劃最佳路線，全面提升作業效率，同時考量可行性和安全性
大型車輛路線的運作方式
大型車輛路線規劃功能會透過下列服務運作：
| 端點 | 作業 | 輸出 |
|---|---|---|
| Routes API | 傳送至 Routes API 端點 (computeRoutes 或 computeRouteMatrix) 的 HTTPS 要求，要求主體包含起點和目的地。travelMode 必須設為 TRUCK，且 routeModifiers 物件必須包含車輛設定檔。
|
路徑折線、路徑路段和步驟清單、預估行程時間和路徑權杖。 |
| Route Optimization API | 對 Route Optimization API 端點發出的 HTTPS 要求。travelMode 必須設為 TRUCK，且 routeModifiers 物件必須包含車輛設定檔。
routeModifiers 物件中的交通方式和車輛資料檔。
|
針對特定車輛設定檔設計的車隊最佳化路線規劃，以及每趟行程的路線權杖。 |
| Navigation SDK | 呼叫 setDestination 時，請加入路徑權杖 (透過 Routes API 或 Route Optimization API 搭配大型車輛路徑規劃功能產生)。 |
為卡車量身打造的即時路況導航體驗，並遵循原始 Routes API 或 Route Optimization API 要求中指定的車輛設定檔路線。 |
範例
必要：要求必須將 travelMode 設為 TRUCK，並使用車輛的特定維度和屬性填入 vehicleInfo 物件。
舉例來說，基本 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
}
}
}
服務會處理這項要求，並傳回考量指定車輛設定檔的路線。視指定的欄位遮罩而定，回應可以包含路線折線、卡車專屬預計抵達時間、行車距離，以及用於 Navigation SDK 的路線權杖。如果找不到完全符合規定的路線，回應也會指出這點。
要求和回應內容
下表摘要說明您用來發出大型車輛路徑規劃要求的資源，以及傳回的資料。
| 要求內容 | 回應內容 | 傳回格式 |
|---|---|---|
|
|
JSON |
限制
開始之前，請務必瞭解下列限制和規定。
- 適用地區：大型車輛路線規劃功能僅適用於美國本土 48 州。
- 大型車輛路線規劃功能目前為預覽階段。駕駛人不得僅依據這個 API 傳回的路線，確保行車安全或合法。系統無法保證路線適合車輛，如果按照路線行駛，駕駛人可能會遇到低矮橋梁或禁止大型車輛通行的道路等危險情況。
- 盡力而為路徑。在某些情況下，API 可能無法找到完全符合旅遊限制的路線。而是傳回「盡力處理」的路線，這類路線仍可能經過管制區域。Routes API 回應會在
routeRestrictionsPartiallyIgnored欄位中清楚標示這些路線。在這種情況下，請仔細規劃路線，最好使用其他來源資料。請勿使用標記的路線做為規劃或導航的單一事實來源。 - 不支援的功能：我們正努力為這項服務提供更多功能，但大型車輛路線規劃目前不支援下列功能：
- 卡車通行費
- 速限
- 放射性有害物質的路線
- 用量限制：所有要求均須遵守標準的每秒查詢次數 (QPS) 限制。
如何使用大型車輛路線規劃功能
- 設定專案：確認已建立 Google Cloud 專案，並為 Routes API 啟用專案。
- 大型車輛路線規劃功能：請與 Google 代表聯絡，為專案啟用這項受限的預先發布版功能。
- 建構路線要求：呼叫
computeRoutes端點，並將travelMode設為TRUCK，以及使用VehicleInfo物件指定虛擬車輛。 - 提供即時路況導航 (選用)：將回應中的
routeToken傳遞至 Navigation SDK，即可開始導覽工作階段。