軌島 · 台灣鐵道即時軌跡

線上版：https://railisland.tw

在真實地圖上動畫化全台鐵道列車運行——台鐵（含每分鐘即時誤點）、高鐵，以及各捷運與輕軌， 依實際時刻表運行；可跟隨列車看待避交會、查平交道通過預測與附近火車班次。 （靈感來源：Brilliant Maps 的 NYC transport／倫敦地鐵 timelapse。） 全部前端都在 index.html 一個檔案；資料在 data/；抓／建資料腳本在 scripts/。

怎麼跑

cd 捷運小動畫
python3 -m http.server 5178      # 或用 .claude/launch.json 的 "static" 設定
# 開 http://localhost:5178

需要網路（OpenFreeMap／Esri 地圖圖磚）。資料檔已在 repo，離線也能載入列車。

涵蓋系統

系統選單以群組頁籤呈現：全台同框（預設）／國家鐵路（台鐵＋高鐵）／北北桃／中南部。

系統	模式	資料
台鐵	逐車次官方每日時刻表＋每分鐘即時誤點（TDX）	data/tra_schedule_dense.json、軌道幾何 data/tra.json
高鐵	逐車次時刻表（無逐車即時誤點，TDX v2）	data/thsr_schedule_dense.json、data/thsr_track.json
阿里山林鐵	本線／祝山／神木／沼平線定期與推算班次	data/afr_schedule_dense.json、TDX＋OSM 缺口補線 data/afr.json
台北捷運	當日實際逐班時刻表	data/trtc.json ＋ data/trtc_times.json（文湖線等無逐班時刻者以官方班距合成）
桃園機場捷運	當日實際逐班時刻表	data/tymc.json ＋ data/tymc_times.json
台中捷運	當日實際逐班時刻表	data/tmrt.json ＋ data/tmrt_times.json
高雄捷運（＋高雄輕軌）	實際時刻表／輕軌班距	data/krtc.json ＋ data/krtc_times.json
新北捷運・淡海輕軌	綠山線／藍海線分線，實際時刻表	data/ntdlrt.json ＋ data/ntdlrt_times.json
新北捷運・安坑輕軌	實際時刻表	data/ntalrt.json ＋ data/ntalrt_times.json
三鶯線	試營運（2026-06-30 通車），班距估算	data/sanying.json ＋ data/sanying_times.json
環狀線（Y）	新北捷運營運；幾何與班距為 OSM＋估算	來源保留於 data/mrt.json

SCHED_K = 1 → 速度 1× ＝ 真實速度，時鐘同步；開站即現在時刻、1×（可隨時調速快轉）。

主要功能

時刻與模擬

• 開站即現在時刻、1× 真實速度；台鐵每分鐘即時誤點（TDX）自動套用。
• 車種加減速模型：不同車種依實際加速／減速特性運行（出站漸加速、進站漸減速、中段等速巡航）， 站區位置更貼近真實，跟隨時的即時時速與速度曲線也隨之起伏。

跟隨列車

• 點任一列車跟車：鏡頭精準置中、全程路線高亮、旅程進度（km）、FR24 式速度曲線、停靠站名牌。
• 跟隨鎖（Google 導航式）：跟隨中可自由拖曳地圖瀏覽，按「回到列車」恢復置中。
• 捷運／輕軌示意車也可點擊跟隨（輕量資訊卡：線名／方向／下一站）。

探索與收集

• 旅程護照＋成就徽章；完乘章（乗りつぶし）：跟一班車到終點自動蓋章，統計趟數／里程／車種。
• 「探」今日亮點面板＋特別列車故事；車站時刻板（點站看未來停靠班次）。

放空模式

• 跟車視角／群車視角（鏡頭掛在當下最繁忙路段看群車交錯）、日夜天色、背景音樂、隨機換車。

平交道（工具列「平」鈕）

• 全台平交道位置依台鐵官方資料標示——可能與現場實際位置有落差，歡迎於 GitHub Issue 提出修改建議。
• 點擊查未來通過列車（車次／方向／預計時刻／倒數）；圖示依軌道數與電化分類（單線／雙線以上・電化，由 OSM 逐處推算）。
• 通過時刻為依時刻表推算，僅供參考，請以現場號誌為準。

附近火車（工具列「釘」鈕）

• 地圖落釘，查 1.5 公里內、未來 60 分鐘經過的列車與方向；並行路線分組全標；★ 可存為最愛地點。

分享與安裝

• 分享畫面：一鍵把目前地點／時間／路網（或正在跟隨的列車）打包成深連結，手機原生分享／桌面複製，對方開啟落回同一畫面。
• 縣市快速移動書籤；PWA 可安裝到主畫面；站內錄影（Beta）。
• 省電模式（降 30fps／手機預設開）、高速跟隨底圖預抓（加速播放不露白）。

其他

• 捷運營運告警橫幅：即時聚合北捷、桃捷、中捷、高捷、新北捷官方公告。

近日資料改正

• 山線改走現行新線：移除 1998 年停用的舊山線（勝興、舊泰安），泰安歸位新站， 補齊百福、南樹林、暖暖、精武、仁德、內惟、美術館、鼓山、三塊厝 9 個通勤車站。
• 成功站補登山線：成追線跨線班次（如 2234）不再繞行追分／彰化瞬移跳動，114 個受影響班次歸正。
• 臺東線玉里–三民段改走現行線（原 OSM 繞行樂合／安通舊線偏約 800m）。
• 淡海輕軌拆為綠山線／藍海線：Y 字路網不再壓成一條線，淡海新市鎮／崁頂端軌道與列車回歸。
• 機捷新北產業園區折返段移除（TDX 原始碎片同段重複收錄致列車繞圈）。
• 環狀線營運方正名為新北捷運（不再歸為台北捷運路線）。
• 平交道校正到官方現役資料，並移除已停用／貨運線上、本圖未繪軌道處的浮空道口。

資料管線（scripts/）

腳本	作用
fetch_tra.py	台鐵路線／站點（OSM；站座標以 TDX 覆寫）
fetch_tra_schedule.py	台鐵每日時刻表（官方 ODS，ods.railway.gov.tw，免金鑰）
densify_schedule.py	班表密化：快車經過的中途站補進 stops，列車才能沿軌跡跑
fetch_tra_station_info.mjs	台鐵車站地址／基本資料
fetch_station_class.mjs	台鐵車站分級（特等站等）
fetch_shapes.py	OSM 軌道幾何 → shape／里程 d（Overpass，有快取）
despike_shapes.mjs	清除 shape 折返毛刺（站場側線繞行）＋重投影站點里程
repair_shape_holes.mjs	補軌道折線斷洞
fetch_thsr.py ／ build_thsr_schedule.mjs	高鐵軌道幾何與逐車次時刻表
fetch_tdx.py	TDX 捷運原始資料（北捷／機捷／新北捷／中捷／高捷含輕軌）→ data/tdx/
build_tdx.mjs	data/tdx/* → 各捷運路網 JSON：碎片縫合、支線接合、去重疊、折返防呆、官方班距
build_metro_times.mjs	TDX StationTimeTable → 各系統當日實際逐班時刻 *_times.json
build_afr.mjs ／ fetch_afr_osm_fills.mjs	阿里山林鐵 TDX 路網／班表，並以 OSM active narrow-gauge 軌道補上 TDX 的 5 處線形缺口
repair_station_distances.mjs	重投影已發布資料中漏算接縫的站點里程（目前為淡海藍海線末三站）
build_crossings.mjs ／ enrich_crossings_osm.mjs	平交道資料建置＋OSM 軌道數／電化推算 → data/crossings.json

已知限制（誠實聲明）

• 位置皆為時刻表推演，非即時動態——僅台鐵有每分鐘即時誤點；高鐵與捷運無逐車即時車況。
• 部分捷運（文湖線等）無公開逐班時刻，以官方班距合成並標示。
• 環狀線與部分輕軌的幾何／班距為 OSM＋估算。
• 少數平行區段為直線近似；山線／海線平行段個別站對可能吸錯軌。
• 內灣線「千甲」與「北新竹」在資料源共用同一座標。
• 平交道位置依台鐵官方資料標示，可能與現場實際有落差；歡迎於 GitHub 提出修改建議。

授權與參與

軌島是原始碼公開（source-available），不是開源軟體——公開是為了讓任何人都能查證 軌島怎麼處理位置資料、以及地圖上的班表與軌道是怎麼算出來的，但未授權再散布、 製作衍生作品或另行發布。完整條款見 LICENSE。

data/ 的資料衍生自 OpenStreetMap（ODbL）、TDX、台鐵官方公開資料與內政部界線資料， suno musics/ 的音樂僅授權予作者本人——這兩者作者都無權轉授權，取用前請看 LICENSE 第三節。

歡迎回報問題與指正資料，這是目前最有價值的貢獻；想寫程式、做 Android 版或移植到其他平台， 請先開 Issue 談（有幾個從 repo 看不出來的障礙）。作法見 CONTRIBUTING.md。

部署

• 前端為純靜態單頁（index.html，無 build step）。
• 部署於 Cloudflare Workers（靜態資產），正式網域 railisland.tw。
• 安全標頭走 _headers 檔（靜態資產不經 Worker 計費）；設定見 wrangler.jsonc。
• 版本戳記 BUILD（index.html 內，字母序遞增）顯示於畫面時鐘徽章與 console，供比對線上是否為最新版。

檔案地圖

index.html                   全部前端（HTML+CSS+JS，無 build）
design-mock.html             設計打磨用自包含模型（見 DESIGN_BRIEF.md）
DESIGN_BRIEF.md              Claude Design 交接指示
data/tra*.json               台鐵：軌道幾何／時刻表／車站分級／站資訊／特別列車
data/thsr_*.json             高鐵：軌道幾何／時刻表
data/afr*.json               阿里山林鐵：軌道幾何／OSM 缺口補線／時刻表
data/{trtc,tymc,tmrt,krtc}*  北捷／機捷／中捷／高捷（含輕軌）路網＋實際時刻
data/{ntdlrt,ntalrt,sanying}* 淡海輕軌／安坑輕軌／三鶯線 路網＋時刻
data/mrt.json                OSM 北捷（環狀線來源保留）
data/crossings.json          全台平交道（位置＋軌道數／電化）
data/tdx/                     TDX 捷運原始資料（fetch_tdx.py 抓取）
scripts/                      上表抓／建資料腳本＋ dev_server.mjs
wrangler.jsonc / _headers     Cloudflare Workers 部署與安全標頭
.claude/launch.json          dev server 設定（static:5178 / dev:5179）