# LiveTRA

> 為通勤族設計的台灣鐵路（台鐵）即時時刻表與誤點查詢服務。提供車站時刻表、單車次完整停靠站、誤點即時動態與最長 90 日的歷史誤點統計，並整合台北捷運即時到站與中央氣象署天氣資訊。支援 8 種語言。

LiveTRA is a real-time Taiwan Railway (TRA) timetable and delay tracking service designed for commuters. It provides station timetables, full stop-by-stop train details, live delay information, and historical delay statistics going back up to 90 days, and integrates Taipei Metro arrivals and Central Weather Administration weather data. Available in 8 languages.

## Unique Data

LiveTRA is not just a live lookup tool — it continuously collects TRA real-time operation data (liveboard polled every 2 minutes, snapshotted to database every 30 minutes) to build a historical delay record per train.

- Per-train historical delay statistics: 7-day daily breakdown, or 30/90-day average trend
- Multi-train delay comparison: overlay delay curves for up to 3 trains on the same date (`/delay-compare`)
- Delay data goes back up to 90 days per train

## Core Pages

- [Home / 首頁](https://livetra.app/): Site introduction, station search, recent and favorite stations
- [Liveboard / 誤點列表](https://livetra.app/liveboard): All currently delayed TRA trains, color-coded by delay
- [Delay Compare / 誤點比較](https://livetra.app/delay-compare): Compare delay trends across multiple trains
- [National Railway Museum / 國家鐵道博物館](https://livetra.app/nrm): Museum train timetable
- [Compensation Rules / 誤點補償](https://livetra.app/compensation): TRA delay compensation policy
- [Emergency Guidelines / 緊急應變](https://livetra.app/emergency): What to do in train emergencies

## URL Patterns

- `/{stationId}-{stationName}` — Station timetable. Example: `/1001-基隆`, `/1080-板橋`. Routing only validates `stationId` (the dash-prefixed name is decorative)
- `/train/{trainNo}` — Single train detail with all stops. Example: `/train/123`
- `/{lang}/...` — Localized variant. Locale prefixes: `jp` (日本語), `ko` (한국어), `en` (English), `th` (ไทย), `vi` (Tiếng Việt), `in` (Bahasa Indonesia), `id` (हिन्दी). Default 正體中文 has no prefix.

## Data Sources

- TDX (Ministry of Transportation, Taiwan) — TRA timetable, real-time delays, alerts, suspensions
- TRTC (Taipei Rapid Transit Corporation) — Taipei Metro real-time arrivals
- CWA (Central Weather Administration) — Per-station weather forecasts

## Update Frequencies

- TRA delay liveboard: every 2 minutes (cron) → 20s client polling
- TRA alerts and suspensions: every 5–10 minutes
- Taipei Metro arrivals: every 10 seconds
- TRA timetable: rebuilt nightly for the next 7 days

## Common Questions

Q: Which trains are currently delayed?
A: `/liveboard` — all currently delayed TRA trains, color-coded by delay severity.

Q: How delayed is a specific train, and what are all its stops?
A: `/train/{trainNo}` — full stop-by-stop detail with live delay for one train.

Q: How does a train's delay compare across dates, or against other trains?
A: `/delay-compare` — pick up to 3 train numbers and a date to overlay their delay curves; supports 7/30/90-day historical windows.

Q: What's the coverage and freshness of the delay data?
A: All TRA stations and lines nationwide (via TDX), live data updated every 2 minutes, historical data retained up to 90 days per train.

## About

- [About LiveTRA / 關於](https://livetra.app/aboutus)
- [Privacy / 隱私權](https://livetra.app/privacy)
- [Terms / 服務條款](https://livetra.app/terms)