雙鐵API資料使用注意事項.md

雙鐵API資料使用注意事項.md

雙鐵API動靜態資料

1. 台鐵列車到離站動態即時電子看板資料(Liveboard)，目前延遲時間為2分鐘，該資料與台鐵官網的列車動態資料來源一致，但與車站或月台上即時顯示的TIDS看板並非一致，會有時間上的延遲，故加值業者在該項資料使用上，請注意並請勿直接與車站或月台上的TIDS看板進行比對，並提醒民眾進入車站主體後，即請以車站內部系統顯示的動態資訊為主。

2. 雙鐵臨時加班資訊： 雙鐵僅提供前一天異動資訊，目前尚無法提供當日臨時加班資訊。

3. 「列車即時準點/誤點資料」與「車站別列車即時到離站電子看板資料」之差異：

   「列車即時準點/誤點資料」為台鐵提供的原始資料，由於該項資料當初僅提供[車次代碼]與[誤點時間]兩欄位，本平台為利各加值單位方便應用，透過台鐵提供的每日列車時刻表，轉換成每日站別時刻表，並將其與「列車即時準點/誤點資料」進行關聯，產製全台各車站之前後30分鐘之「車站別列車即時到離站電子看板資料」，由於本項資料為加值轉換所得，非由台鐵各車站直接介接取得，故請各位加值者審慎使用，或自行設計演算邏輯轉換處理。 另台鐵為提高前述轉換邏輯之準確性，已於「列車即時準點/誤點資料」中新增[最近停靠車站代碼]欄位，本平台後續會將此欄位納入轉換邏輯中，並將已通過各車站之車次資訊過濾，使「車站別列車即時到離站電子看板資料」更符合實際真實的狀況。

4. 定期時刻表與每日時刻表之差異：

   為確保時刻表的正確性及即時性，台鐵提供近60天每日時刻表、高鐵提供近45天每日時刻表，然而考量國內外旅客對於在臺旅行常需在數個月前規劃行程，若超過此段期間之時刻表資料則可參考定期時刻表，提供未來數個月之後之旅運規劃服務(通常國外旅客來台觀光較需要使用定期時刻表資料)。

5. 車站代碼(StationID)與車站簡碼(StationCode)之差異：

   StationID通常為列車排點系統的車站代碼系統，時刻表資料中即以此代碼為主；

   StationCode主要是票務系統如訂票系統用的車站簡碼，加值業者使用時必須先了解其差異與使用時機。