機群追蹤簡介

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

  • 隨選行程
  • 排定的工作

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

使用 JavaScript 車隊追蹤程式庫,車隊營運人員就能近乎即時地查看車隊車輛的位置。如果知道車輛的路線,地圖檢視畫面元件會以動畫呈現車輛沿著預測路徑移動的過程。

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

什麼是車隊追蹤?

車隊追蹤是 Fleet Engine 的一項功能,專為車隊營運商設計。這個程式庫提供介面,可模擬及追蹤 Fleet Engine 中的車隊資料,並提供類別,供您為車隊管理員建立豐富的網頁式地圖,顯示行程資訊。例如:

  • 讓隨選行程營運商能夠追蹤多輛車輛的行程進度。
  • 讓預定出貨作業人員在網頁地圖上,查看車隊出貨進度 (近乎即時)。

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

為什麼要使用車隊追蹤功能?

將車隊追蹤功能整合至車隊作業後,您就能獲得全面的車輛監控體驗,並取得近乎即時的位置資訊更新。您可以在地圖上查看部分或所有車輛的位置,包括停靠站或途中的詳細資料,有助於瞭解車隊的表現。

車隊追蹤功能有哪些用途?

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

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

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

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

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

元件

下表說明車隊追蹤功能使用的元件及其用途。

隨選行程

元件 說明
旅程分享地圖檢視畫面 行程分享地圖檢視畫面會顯示車輛位置和行程。如果 Fleet Engine 知道車輛的路線,地圖檢視畫面元件會以動畫呈現車輛沿著預測路徑移動的過程。
車輛位置資訊供應商

車輛位置資訊供應商會顯示單一車輛的位置資訊。當中包含車輛位置、途中的航點,以及指派給車輛的行程。

以下是車輛及其途經點標記的顯示規則:

  • 車輛:車輛一經在 Fleet Engine 中建立,就會顯示在畫面上,且會顯示 vehicle_stateOnline也就是說,即使車輛目前未指派任何行程,仍可顯示。
  • 路線控點標記:地圖上會顯示規劃的車輛路線控點,包括起點、中途點和目的地標記。
自訂選項 車輛位置資訊供應商選項可讓您自訂折線和標記。您可以為折線上色及設定樣式,顯示車輛的各種實際情況,例如行駛路線和交通狀況。您可以自訂標記,以達到不同目的。您也可以為折線和標記新增點擊處理常式。
車輛事件監聽器 作業人員可透過事件監聽器,取得車輛完成的行程相關資訊。
車隊位置資訊供應商 車隊位置資訊供應商會顯示多輛送貨車輛的位置資訊。追蹤車隊時,您可以設定地理界線,也可以選擇依車輛 ID 篩選。

排定的工作

元件 說明
旅程分享地圖檢視畫面 旅程分享地圖檢視畫面會顯示外送車輛和任務的位置。如果 Fleet Engine 知道車輛的路線,地圖檢視畫面元件會以動畫呈現車輛沿著預測路徑移動的過程。
送貨車輛位置資訊供應商

送貨車輛位置資訊供應商會顯示單一送貨車輛的位置資訊。包括車輛位置、停靠站,以及送貨車輛完成的任務。

以下是送貨車輛、停靠點及其任務的顯示規則:

  • 車輛:只要在 Fleet Engine 中建立外送車輛,系統就會顯示該車輛,且無論車輛的任務為何,都會在整個路線中顯示。
  • 停靠站:地圖上會以車輛停靠站標記顯示預計停靠站。已完成工作的標記會以不同樣式顯示,與車輛的預定停靠點有所區別。
  • 工作:系統會顯示工作結果的位置,並以工作結果標記表示。結果為 SUCCEEDED 的工作會顯示成功標記,其他工作則會顯示失敗標記。
自訂選項 您可以透過外送車輛位置資訊供應商選項,自訂折線和標記。您可以為折線上色及設定樣式,顯示車輛的各種實際情況,例如車輛的現行路線。你可以自訂標記,用於不同用途,例如外送車輛。您也可以為折線和標記新增點擊處理作業。
外送工作篩選條件 作業篩選器可讓作業人員篩選檢視畫面,查看指定時間之前或之後完成的作業,以及篩選開放或關閉的作業。
送貨車輛事件監聽器 作業人員可透過事件監聽器取得送貨車輛完成的行程路段資訊,以及車輛執行的工作清單。
車隊位置資訊供應商 送貨車隊位置資訊供應商會顯示多輛送貨車輛的位置資訊。你可以篩選顯示特定送貨車輛及其位置,也可以顯示整個車隊的車輛位置。

如何使用車隊追蹤功能

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

後續步驟