S19 即時位置追蹤

概述

在行程執行期間（M4），司機端 App 自動開始上傳 GPS 座標，乘客/家長端與管理員後台即時顯示司機位置與預估到達時間（ETA）。本流程定義 GPS 上傳機制、地圖顯示、自動開始/停止邏輯，以及離線處理。

執行者：系統（自動觸發）/ 司機 App（GPS 上傳）/ 乘客端（地圖檢視）/ 管理員（後台監控）

前置條件：行程已確立（M3 完成），司機已綁定

觸發條件

觸發時機	說明
司機點擊「開始行程」	M4 步驟 1，自動啟動位置上傳
乘客開啟追蹤頁面	從 App 或 LINE 通知連結進入
管理員開啟監控頁面	M6 即時監控功能

Happy Path

步驟 1：自動啟動位置上傳（司機端）

司機在 M4 點擊「開始行程」後，系統自動啟動 GPS 位置上傳：

使用瀏覽器 navigator.geolocation.watchPosition() 或原生 GPS API
每 5 秒上傳一次座標至即時資料庫
每筆記錄包含：

欄位	說明
latitude	緯度
longitude	經度
timestamp	時間戳
accuracy	定位精度（公尺）
tripId	關聯行程 ID
driverUid	司機 UID

步驟 2：乘客/家長端即時檢視

乘客或家長進入追蹤頁面：

系統即時監聽司機座標更新
在地圖上顯示：
- 司機位置圖標（車輛圖示），隨座標更新即時移動
- 乘客的上車/下車站點標記
- 司機行駛軌跡（已通過路線）
顯示輔助資訊：
- 預估到達時間（ETA），依據司機當前位置與下一站距離即時計算
- 司機與乘客站點的直線距離
- 行程狀態（前往中 / 接近中 / 已到站）

進入方式：

App 內行程詳情頁 → 「查看司機位置」
LINE 通知中的追蹤連結（免安裝 App，瀏覽器開啟）

步驟 3：管理員後台監控（B2B 場景）

管理員在後台監控畫面：

地圖總覽：同時顯示所有執行中行程的司機位置
可點擊個別司機查看詳細資訊：
- 當前位置與行駛方向
- 各站完成狀態（已完成 / 進行中 / 未開始）
- 上車人數統計（已上車 / 未到 / 總人數）
異常警示：與 S16 異常偵測整合，路線偏離或超速時在地圖上以紅色標記

步驟 4：自動停止位置上傳

以下任一條件觸發停止：

條件	說明
行程完成	司機在 M4 標記「行程完成」
行程取消	行程被取消（M4 WC-11）
手動停止	司機手動關閉位置分享（非預期操作，記錄事件）

停止後：

不再上傳新座標
乘客端地圖顯示「行程已結束」
歷史軌跡資料保留供事後查閱

Worst Case

代碼	情境	系統行為
S19-WC1	GPS 訊號不佳	座標精度標記降低，地圖上以虛線圈表示不確定範圍；ETA 計算切換為估算模式
S19-WC2	網路斷線（司機端）	GPS 座標暫存於手機本地，恢復連線後批次上傳；乘客端顯示「位置更新暫停」
S19-WC3	網路斷線（乘客端）	地圖凍結在最後已知位置，恢復連線後自動重新同步
S19-WC4	司機未授權 GPS 權限	App 提示需開啟定位權限，無法啟動位置上傳；通知管理員處理
S19-WC5	電池耗盡	GPS 上傳中斷，乘客端顯示「最後更新時間」；管理員收到警示
S19-WC6	位置異常跳動	系統過濾精度 > 100 公尺的座標點，不更新地圖顯示

場景差異表

功能	C2C 共乘	活動接駁	企業接駁	校車	旅遊包車
GPS 上傳	行程開始後自動啟動	同左	同左	同左	同左
乘客追蹤	App 內查看	App + LINE 連結	App + LINE 連結	家長透過 LINE 連結查看	App 內查看
管理員監控	不適用	後台多車即時監控	後台多車即時監控	後台多車即時監控	不適用
ETA 顯示	對乘客顯示	對乘客 + 管理員顯示	對乘客 + 管理員顯示	對家長 + 管理員顯示	對乘客顯示
異常偵測整合	無	路線偏離、超速	路線偏離、超速	路線偏離、超速、異常停留	無
歷史軌跡保留	保留供爭議處理	保留供報表	保留供報表	保留供報表與家長查閱	保留供爭議處理

所屬主流程

主流程	關聯	說明
M4 行程執行	被呼叫	步驟 1 啟動上傳、步驟 6 乘客追蹤、步驟 5 管理員監控
M6 管理者營運	被呼叫	後台即時監控功能
S16 異常偵測	協作	GPS 資料供異常偵測使用
S13 LINE 通知	協作	透過 LINE 發送追蹤連結

S19 即時位置追蹤 ​

概述 ​

觸發條件 ​

Happy Path ​

步驟 1：自動啟動位置上傳（司機端） ​

步驟 2：乘客/家長端即時檢視 ​

步驟 3：管理員後台監控（B2B 場景） ​

步驟 4：自動停止位置上傳 ​

Worst Case ​

場景差異表 ​

所屬主流程 ​