車輛位置

車輛位置可用來提供系統針對車輛位置自動產生的相關資訊,例如車上 GPS 裝置提供的資訊。凡是可提供車輛位置資訊的車輛,都必須提供一項這類資訊。

車輛目前提供服務的行程,應透過行程描述元指定。您也可以提供車輛描述元,指定提供的更新資訊中涉及的確切實體車輛。下方提供相關說明文件。

時間戳記代表可提供系統擷取位置讀數的時間。請注意,這與動態饋給標題中的時間戳記不同,後者是伺服器產生這則訊息的時間。

您也可以提供目前通行狀態 (stop_sequencestop_id),這是指車輛正在前往或目前停留的停靠站。

位置

position 欄位包含 VehiclePosition 內的地點資料。經緯度為必要欄位,其他則為選用欄位。這些類型的資料如下:

  • Latitude (緯度) - 往北的度數 (WGS-84 座標系統)
  • Longitude (經度) - 往東的度數 (WGS-84 座標系統)
  • Bearing (方位角) - 車輛朝向的方向
  • Odometer (里程表) - 車輛行駛的距離
  • Speed (速度) - 車輛測量到的瞬時速度 (以公尺/秒為單位)

壅塞程度

車輛位置也可讓運輸公司指定車輛目前所在地的壅塞程度。壅塞可分為下列類別:

  • 壅塞程度不明
  • 順暢
  • 有點壅塞
  • 壅塞
  • 嚴重壅塞

壅塞程度屬於哪個類別,是由運輸公司決定。我們建議只有在交通堵塞到乘客離開車輛的程度,才視為嚴重壅塞。

承載狀態

車輛位置也可讓運輸公司指定車輛的乘客承載程度。承載狀態可分為下列類別:

  • 空車
  • 空位很多
  • 空位有限
  • 只有站立空間
  • 站立空間擁擠
  • 滿載
  • 不接受乘客

這個欄位仍在實驗階段,因此可能會有變更,但日後可能就會正式採用。

車輛停靠狀態

車輛停靠狀態代表的意義比車輛狀態更豐富,是指車輛相對於停靠站的狀態:即將進站或已經到站。這個狀態可設為以下任何一個值:

  • Incoming at (即將抵達) - 車輛即將抵達所參照的停靠站
  • Stopped at (目前停靠) - 車輛停在所參照的停靠站
  • In transit to (正在前往) - 所參照的停靠站是車輛的下一個停靠站 - 預設

車輛描述元

車輛描述元用於描述確切的實體車輛,且可包含下列任一屬性:

  • ID - 車輛的內部識別資訊系統,必須專屬於該車輛
  • Label (標籤) - 使用者可見標籤,例如火車名稱
  • License plate (車牌):車輛的實際車牌