【系統公告】高鐵V2版動態剩餘位相關說明




PTX今日已上架 高鐵動態車次對號座剩餘座位資料服務(開發用測試版) 如下:
(1)取得當天動態對號座剩餘座位資料 : /v2/Rail/THSR/AvailableSeatStatusList/Train/Today
(2)取得指定[日期]動態對號座剩餘座位資料 : /v2/Rail/THSR/AvailableSeatStatusList/Train/TrainDate/{TrainDate}

新版API以車次為主體描述剩餘位資料與舊版API以站別為主體描述有所不同,其資料解讀方式如下:
(1)車次中每個停靠站的剩餘位狀態,皆為從出發站角度來供應,故車次的終點站不會有剩餘位狀態資料。
(2)若要從訂票的起迄站OD角度來應用,請務必進行加值轉換。
舉例: 某車次僅停靠 左營 -> 台南 -> 台中,若提供該車次的剩餘位狀態資料如下
左營站的 StdSeatStatus(標準車廂狀態)=O,BizSeatStatus(商務車廂狀態)=O
台南站的 StdSeatStatus(標準車廂狀態)=X,BizSeatStatus(商務車廂狀態)=O
表示: 左營 -> 台南 標準車廂 跟 商務車廂 皆還有空位, 但 左營 -> 台中 的 標準車廂已無空位, 商務車廂 還有空位
(因為[中間站]台南出發的標準車廂已無空位, 所以從[起始站]左營出發到台中的就一定沒有空位)
我們也將此說明加入至資料使用葵花寶典

高鐵目前提供為測試資料並高鐵預計8月初提供正式資料
另外 因高鐵不再維護舊版資料 故舊版服務預計於9/15下架