機群追蹤簡介

JavaScript 機群追蹤程式庫適用於以下用途:

  • 隨選行程
  • 已排定的工作

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

使用 JavaScript 機群追蹤程式庫,即可為機群運算子 以近乎即時的方式呈現車輛載隊的位置。 如果已知車輛的路線,地圖檢視元件會在車輛沿著預測路徑移動時,為該車輛顯示動畫。

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

什麼是車隊追蹤?

車隊追蹤是 Fleet Engine 的功能,專為車隊操作員設計。這項服務 提供介面,且會在 Fleet Engine 中追蹤機群資料 提供您用來建立豐富資訊、網頁式地圖呈現旅程的類別 給車隊管理員的資訊例如:

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

您將程式庫整合至網頁應用程式,並設定適當的角色 設定檔,支援與消費者分享歷程。適用對象 如要進一步瞭解 Fleet Engine 中的角色,請參閱服務帳戶角色

使用機群追蹤功能的好處

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

機群追蹤功能的用途為何?

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

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

  • 查看單個、多輛或所有車輛的目前位置,如 他們會沿路前進,同時更新他們的位置。 定期更新。

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

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

元件

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

隨選行程

元件 說明
分享地圖檢視畫面 行程分享地圖檢視畫面會顯示車輛的位置和行程。如果 Fleet Engine 得知 地圖檢視元件會在車輛上移動時以動畫呈現該車輛 預測路徑
車輛位置供應商

車輛定位服務供應商顯示單一車輛的 位置資訊。其中包含車輛位置、 路線控點和指派給車輛的行程。

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

  • 交通工具:車輛過貨 建立而成,且可在 vehicle_state 層級查看 為 Online。也就是說,即使車輛沒有目前指派的行程,也能顯示。
  • 路線控點標記:預定的車輛路線控點為 在地圖上顯示為起點、中繼及目的地標記。
自訂選項 您可以使用車輛位置供應器選項提供自訂的折線和標記。您可以為折線著色及設定樣式,以便顯示車輛的各種實際情境,例如行經路線和交通狀況。您可以為不同的 用途。您也可以在折線和標記中加入點擊處理方式。
車輛事件監聽器 事件監聽器可讓作業員取得車輛完成行程的相關資訊。
車輛車隊定位服務供應商 車隊位置供應商顯示多家運輸車輛 位置資訊。追蹤機群時,您可以設定地理界線 或者,你也可以選擇按車輛 ID 篩選。

已排定的工作

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

交車地點供應商顯示了一輛交車的 位置資訊。其中包含車輛位置、 再由貨運車輛完成工作

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

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

如何使用車隊追蹤

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

後續步驟