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