機群追蹤簡介

JavaScript 車隊追蹤程式庫適用於下列用途:

  • 隨選行程
  • 排定的工作

本指南將說明如何為這兩項服務使用這個程式庫。

您可以使用 JavaScript 車隊追蹤程式庫,讓車隊操作員以近乎即時的方式,查看車隊中車輛的位置。如果已知車輛的路線,地圖檢視元件會在車輛沿著預測路徑移動時,為該車輛顯示動畫。

車輛追蹤地圖檢視畫面範例

什麼是車隊追蹤?

車隊追蹤是 Fleet Engine 的功能,專為車隊操作員設計。它提供的介面可模擬及追蹤車隊引擎中的車隊資料,並提供可用來為車隊管理員建立豐富的網路地圖行程資訊顯示畫面的類別。例如:

  • 讓隨選行程營運商能夠追蹤多輛車輛的行程進度。
  • 讓預約運送作業人員能夠在網路地圖上查看車隊運送作業的近乎即時進度。

您可以將程式庫整合至網頁應用程式,並在 Fleet Engine 中設定適當的角色設定檔,以便與消費者分享行程。如要進一步瞭解 Fleet Engine 中的角色,請參閱「服務帳戶角色」。

使用車隊追蹤功能的好處

將車隊追蹤功能整合至車隊作業後,您就能享有完整的車輛監控體驗,並取得近乎即時的位置更新。你可以在地圖上查看一或所有車隊車輛的位置,包括停靠站或路線點詳細資料,協助你瞭解車隊的運作情形。

車隊追蹤功能可做什麼?

您可以利用車隊追蹤程式庫提供的資訊,透過下列功能建立車隊作業的豐富檢視畫面:

  • 根據需求自訂車隊追蹤地圖 UI。

  • 查看單一、多輛或所有車輛目前的位置,並定期更新其位置。

  • 計算行程或送貨的預估到達時間,以及剩餘距離。

  • 查看車輛進度,包括已完成的行程或任務狀態。

元件

下表說明車隊追蹤中使用的元件,以及這些元件的功能。

隨選行程

元件 說明
旅程分享地圖檢視畫面 行程分享地圖檢視畫面會顯示車輛位置和行程。如果車隊引擎知道車輛的路線,地圖檢視畫面元件會在車輛沿著預測路徑移動時,為該車輛顯示動畫。
車輛位置供應商

車輛位置供應器會顯示單一車輛的位置資訊。這項資料包含車輛位置、其路徑點,以及指派給車輛的行程。

以下是車輛和其路標的顯示規則:

  • 車輛:車輛在 Fleet Engine 中建立後就會顯示,且 vehicle_stateOnline 時也會顯示。也就是說,即使車輛沒有目前指派的行程,也能顯示。
  • 路線控點標記:規劃的車輛路線控點會在地圖上顯示為起點、中繼點和目的地標記。
自訂選項 您可以使用車輛位置供應器選項提供自訂的折線和標記。您可以為折線著色及設定樣式,以便顯示車輛的各種實際情境,例如行經路線和交通狀況。您可以根據不同用途自訂標記。您也可以為折線和標記新增點擊處理作業。
車輛事件監聽器 事件監聽器可讓操作員取得車輛完成行程的相關資訊。
車隊位置資訊供應商 車隊位置供應工具會顯示多輛送貨車輛的位置資訊。追蹤車隊時,您可以設定地理範圍,也可以選擇依車輛 ID 篩選。

排定的工作

元件 說明
旅程分享地圖檢視畫面 旅程分享地圖檢視畫面會顯示運送車輛和任務的位置。如果車隊引擎知道車輛的路線,地圖檢視畫面元件會在車輛沿著預測路徑移動時,為該車輛顯示動畫。
送貨車輛位置供應器

運送車輛位置供應器會顯示單一運送車輛的位置資訊。其中包含車輛位置、停靠站點,以及送貨車輛完成的工作。

以下是運送車輛、停靠站和相關工作項的顯示規則:

  • 車輛:在 Fleet Engine 中建立運送車輛後,系統就會顯示該車輛,並在其路線的整個過程中顯示,無論其任務為何皆然。
  • 停靠站:系統會在地圖上以車輛停靠標記顯示預定的車輛停靠站。完成任務的標記會以不同於車輛預定停靠站的樣式顯示。
  • 工作:工作結果的位置會顯示工作結果標記。結果為 SUCCEEDED 的工作會顯示成功的工作標記,而所有其他工作則會顯示失敗的工作標記。
自訂選項 透過運送車輛定位服務供應商選項,您可以提供折線和標記自訂設定。您可以為折線指定顏色和樣式,以便顯示車輛的各種實際情境,例如車輛的有效路線。您可以自訂標記,用於不同用途,例如外送車輛。您也可以為折線和標記新增點擊處理作業。
提交任務篩選器 工作篩選器可讓作業員篩選在指定時間之前或之後完成的工作,以及篩選已完成或未完成的工作。
運送車輛事件監聽器 事件監聽器可讓作業員取得運送車輛完成的路線區段資訊,以及車輛提供的任務清單。
貨運車隊位置供應商 這項服務會顯示多輛送貨車輛的位置資訊。您可以篩選特定送貨車輛及其位置,也可以顯示整個車隊的車輛位置。

如何使用車隊追蹤

1 在 JavaScript 中設定車隊追蹤功能。 詳情請參閱「設定 JavaScript 車隊追蹤程式庫」。
2 載入程式庫並初始化地圖。 詳情請參閱「載入程式庫並初始化地圖檢視畫面」。
3 提供車輛位置並設定地圖檢視畫面。 如要開始追蹤車輛,請使用正確的車輛 ID 例項化位置提供工具,並使用該工具初始化地圖檢視畫面。詳情請參閱「提供車輛位置」。
5 更新機群進度並處理行程錯誤。 詳情請參閱「更新車隊進度」和「處理錯誤」。
5 當天作業結束後,請停止追蹤車隊車輛。 詳情請參閱「停止追蹤送貨車輛」。

後續步驟