JavaScript 車隊追蹤程式庫適用於下列用途：
- 隨選行程
- 排定的任務
本指南說明如何將這個程式庫用於這兩項服務。
使用 JavaScript 車隊追蹤程式庫，即可讓車隊營運商以近乎即時的方式，查看車隊中車輛的位置。如果車輛路線已知，地圖檢視元件會沿著預測路徑，以動畫顯示車輛移動。
什麼是車隊追蹤？
車隊追蹤是 Fleet Engine 專為車隊營運商設計的功能。提供介面，用於模擬及追蹤車隊引擎中的車隊資料，並提供類別，可用於建立豐富的網頁式地圖，向車隊管理員顯示行程資訊。例如：
- 允許隨選行程業者追蹤多輛車輛的行程進度。
- 允許排程運送作業員在網頁式地圖上，查看車隊運送的近乎即時進度。
您將程式庫整合至網頁應用程式，並在 Fleet Engine 中設定適當的角色設定檔，以便與消費者分享行程。如要進一步瞭解 Fleet Engine 中的角色，請參閱「服務帳戶角色」。
為什麼要使用車隊追蹤功能？
將車隊追蹤功能整合至車隊營運後，您就能享有全方位的車輛監控體驗，並取得近乎即時的位置更新資訊。您可以在地圖上查看一或所有車隊車輛的位置，包括停靠站或路線控點詳細資料，協助您瞭解車隊的運作情形。
車隊追蹤功能有哪些用途？
您可以運用車隊追蹤程式庫中的資訊，透過下列功能建立豐富的車隊營運檢視畫面：
根據需求自訂車隊追蹤地圖 UI。
查看一輛、多輛或所有車輛沿著路線行駛時的目前位置，位置資訊會定期更新。
計算行程或外送的預計到達時間和剩餘距離。
查看車輛進度，包括已完成的行程或工作狀態。
元件
下表說明車隊追蹤使用的元件及其功能。
隨選行程
| 元件 | 說明 |
|---|---|
| 旅程分享地圖檢視畫面 | 行程分享地圖檢視畫面會顯示車輛位置和行程。如果 Fleet Engine 知道車輛的路線，地圖檢視元件會沿著預測路徑，以動畫顯示車輛移動。 |
| 車輛位置供應商 | 車輛位置資訊提供者會顯示單一車輛的位置資訊。其中包含車輛位置、路線控點，以及指派給車輛的行程等資訊。 以下是車輛和路線控點標記的顯示規則：
|
| 自訂選項 | 車輛位置供應商選項可讓您提供折線和標記自訂項目。您可以為折線設定顏色和樣式，顯示車輛的各種實際情境，例如行經路線和路況。您可以根據不同用途自訂標記。您也可以為折線和標記新增點擊處理。 |
| 車輛事件監聽器 | 事件監聽器可讓業者取得車輛完成行程的相關資訊。 |
| 車隊位置供應商 | 車隊位置資訊提供者會顯示多輛外送車輛的位置資訊。追蹤車隊時，您可以設定地理邊界，也可以選擇依車輛 ID 篩選。 |
排定的任務
| 元件 | 說明 |
|---|---|
| 旅程分享地圖檢視畫面 | 行程分享地圖檢視畫面會顯示外送車輛和工作的位置。如果 Fleet Engine 知道車輛的路線，地圖檢視元件會沿著預測路徑，以動畫顯示車輛移動。 |
| 配送車輛位置資訊供應商 | 貨車位置資訊提供者會顯示單一貨車的位置資訊。其中包含車輛位置、停靠點，以及配送車輛完成的工作等資訊。 以下是配送車輛、停靠點和相關工作的顯示規則：
|
| 自訂選項 | 您可以使用外送車輛位置資訊提供者選項，自訂折線和標記。您可以為折線設定顏色和樣式，顯示車輛的各種實際情境，例如車輛的有效路線。您可以根據不同用途自訂標記，例如用於外送車輛。您也可以為折線和標記新增點擊處理。 |
| 配送工作篩選器 | 工作篩選器可讓操作員篩選檢視畫面，查看在指定時間之前或之後完成的工作，以及篩選未完成或已完成的工作。 |
| 配送車輛事件監聽器 | 事件監聽器可讓業者取得外送車輛完成的行程區段相關資訊，以及車輛服務的工作清單。 |
| 外送車隊位置供應商 | 外送車隊位置資訊供應器會顯示多輛外送車輛的位置資訊。您可以篩選顯示特定配送車輛及其位置，也可以顯示整個車隊的車輛位置。 |
如何使用車隊追蹤功能
| 1 | 在 JavaScript 中設定車隊追蹤。 | 詳情請參閱「設定 JavaScript 車隊追蹤程式庫」。 |
| 2 | 載入程式庫並初始化地圖。 | 詳情請參閱「載入程式庫並初始化地圖檢視畫面」。 |
| 3 | 提供車輛位置並設定地圖檢視畫面。 | 如要開始追蹤車輛，請使用正確的車輛 ID 例項化位置供應器，並用來初始化地圖檢視畫面。詳情請參閱「提供車輛位置」。 |
| 5 | 更新車隊進度及處理行程錯誤。 | 詳情請參閱「更新機群進度」和「處理錯誤」。 |
| 5 | 當天工作結束後，請停止跟隨車隊車輛。 | 詳情請參閱「停止追蹤配送車輛」。 |