車輛位置可用來提供系統針對車輛位置自動產生的相關資訊,例如車上 GPS 裝置提供的資訊。凡是可提供車輛位置資訊的車輛,都必須提供一項這類資訊。
車輛目前提供服務的行程,應透過行程描述元指定。您也可以提供車輛描述元,指定提供的更新資訊中涉及的確切實體車輛。下方提供相關說明文件。
時間戳記代表可提供系統擷取位置讀數的時間。請注意,這與動態饋給標題中的時間戳記不同,後者是伺服器產生這則訊息的時間。
您也可以提供目前通行狀態 (stop_sequence
或 stop_id
),這是指車輛正在前往或目前停留的停靠站。
位置
position
欄位包含 VehiclePosition
內的地點資料。經緯度為必要欄位,其他則為選用欄位。這些類型的資料如下:
- Latitude (緯度) - 往北的度數 (WGS-84 座標系統)
- Longitude (經度) - 往東的度數 (WGS-84 座標系統)
- Bearing (方位角) - 車輛朝向的方向
- Odometer (里程表) - 車輛行駛的距離
- Speed (速度) - 車輛測量到的瞬時速度 (以公尺/秒為單位)
壅塞程度
車輛位置也可讓運輸公司指定車輛目前所在地的壅塞程度。壅塞可分為下列類別:
- 壅塞程度不明
- 順暢
- 有點壅塞
- 壅塞
- 嚴重壅塞
壅塞程度屬於哪個類別,是由運輸公司決定。我們建議只有在交通堵塞到乘客離開車輛的程度,才視為嚴重壅塞。
承載狀態
車輛位置也可讓運輸公司指定車輛的乘客承載程度。承載狀態可分為下列類別:
- 空車
- 空位很多
- 空位有限
- 只有站立空間
- 站立空間擁擠
- 滿載
- 不接受乘客
這個欄位仍在實驗階段,因此可能會有變更,但日後可能就會正式採用。
車輛停靠狀態
車輛停靠狀態代表的意義比車輛狀態更豐富,是指車輛相對於停靠站的狀態:即將進站或已經到站。這個狀態可設為以下任何一個值:
- Incoming at (即將抵達) - 車輛即將抵達所參照的停靠站
- Stopped at (目前停靠) - 車輛停在所參照的停靠站
- In transit to (正在前往) - 所參照的停靠站是車輛的下一個停靠站 - 預設
車輛描述元
車輛描述元用於描述確切的實體車輛,且可包含下列任一屬性:
- ID - 車輛的內部識別資訊系統,必須專屬於該車輛
- Label (標籤) - 使用者可見標籤,例如火車名稱
- License plate (車牌):車輛的實際車牌