以交通部民用航空局公開統計資料整理台灣航空載客率、載客人數、飛行架次與航點變化，聚焦中華航空、長榮航空、星宇航空與台灣虎航的每月航線表現。
正式站：https://taiwanairlinedata.com/
- 航空公司切換 — 中華航空 / 長榮航空 / 星宇航空 / 台灣虎航，逐一分析各自表現
- KPI 卡片 — 航線數、飛行架次、座位數、載客人數、平均載客率、月增長率（MoM）
- D3 橫向長條圖 — 各航點載客率、載客人數、飛行架次
- D3 折線趨勢圖 — 已匯入多月份時顯示月均載客率走勢，單月時顯示空狀態
- 航點月份矩陣 — 快速查看航點在各月份是否有班次
- 同期比較與航點異動 — 對照去年同月、新增航點、停飛與增減班情形
- 可排序航點明細表 — 含入境/出境人數
- 全球地圖 — D3 Natural Earth 投影，顯示從 TPE / TSA / KHH / RMQ 出發的所有航線弧線
- 月份切換 — 使用多月份資料重算指定月份的航點、航司排名與載客率
- 航線選取 — 點擊地圖弧線或左側卡片即可聚焦航線，非相關航線自動淡出
- 多維篩選 — 依出發機場、目的地、航空公司、國家/地區、視角指標（載客人數／載客率／飛行架次）篩選
- 航空公司比拼 — 跨航點彙總各航空公司的規模與載客率排名
- 航點詳情 — 地圖右側浮層顯示飛行架次、座位數、入境/出境旅客比較圖
/airline-battle為舊網址相容 redirect，自動導向首頁/。
本專案使用交通部民用航空局公開統計頁面：
資料主要取自民航局每月公開 ODS 統計表（36 系列工作表）。
| 工作表 | 出發機場 | 資料類型 |
|---|---|---|
| 36-1 | TPE 桃園 | 航點 × 航空公司（含入出境） |
| 36-2 | KHH 高雄 | 同上 |
| 36-3 | TSA 松山 | 同上 |
| 36-4 | RMQ 台中 | 同上 |
解析後分別存於：
src/data/monthlyAirlineRoutes.json— 航運四雄多月份資料，供分析頁與地圖頁使用src/data/realRoutes.json— 既有航點座標與顯示名稱 metadata，供地圖補座標使用
- 本專案不是交通部民用航空局或任何航空公司的官方網站。
- 本專案資料由公開 ODS 檔自行解析、整理與視覺化，可能因原始資料更新、解析規則、航點代碼映射、四捨五入、系統處理、更新時差或資料清理方式而與原始公告產生遺漏、延遲或差異。
- 正式數據、最新版本與資料定義，請以交通部民用航空局原始公告頁面與下載檔案為準。
- 本專案內容僅供資料探索、研究與視覺化展示，不構成投資建議、營運建議、交易建議、訂票建議或任何形式的決策保證。
- 使用者依據本專案內容所作之判斷、引用、投資、交易、營運或其他行動，其結果與風險由使用者自行判斷與承擔。
資料錯誤、功能建議或合作洽詢，請來信：taiwanairlinedata@gmail.com
目前收錄月份與筆數以 src/data/*.ods 及 src/data/monthlyAirlineRoutes.json 為準。
ODS 檔案新增後執行 parser 即自動更新，不需手動修改程式碼。
# 新增或更新單一月份
mise exec -- python scripts/parseOds.py src/data/116年1月_xxxx_xxxx.ods
# 全量重建（重新解析 src/data/ 下所有 ODS）
mise exec -- python scripts/parseOds.py --all全量重建：直接清空並重寫整份 JSON，適合初次建立或需要修正所有月份時使用。
單檔更新：只移除同月份舊資料，再寫入新解析結果，不影響其他月份。
| 層級 | 技術 |
|---|---|
| UI 框架 | Vue 3 (<script setup>) + Vue Router 4 |
| 狀態管理 | Pinia |
| 地圖與資料視覺化 | D3 v7、TopoJSON、world-atlas |
| 語言 | TypeScript 5 |
| 建置工具 | Vite 6 |
| Runtime 管理 | mise（.mise.toml） |
src/
├── composables/
│ └── useArcPath.ts # 大圓弧線路徑計算
├── router/
│ └── index.ts # Vue Router（雜湊路由模式）
├── views/
│ ├── AirlineGrowthView.vue # 航運四雄分析頁（首頁 /）
│ └── RouteExplorerView.vue # 航點探索地圖頁（/routes）
├── components/
│ ├── NavBar.vue # 全站導覽列
│ ├── airline/
│ │ ├── MetricBarChart.vue # D3 橫向長條圖（可重用）
│ │ └── TrendChart.vue # D3 折線趨勢圖
│ ├── RouteMap.vue # D3 地圖（重建與選取更新分離）
│ ├── RouteFilter.vue # 篩選列
│ ├── RouteCard.vue # 航點卡片
│ ├── RouteDetailPanel.vue # 地圖右側詳情浮層
│ ├── AirlineComparison.vue # 航司比拼列表
│ ├── AirlineRouteItem.vue # 單一航司排名列
│ └── PassengerCompareChart.vue
├── stores/
│ ├── routeStore.ts # 地圖頁 Pinia 狀態
│ └── airlineGrowthStore.ts # 分析頁 Pinia 狀態
├── utils/
│ ├── routeMetrics.ts
│ └── seo.ts # 路由切換時更新 title / meta / OG / Twitter
├── data/
│ ├── realRoutes.json # 航點座標與顯示名稱 metadata
│ └── monthlyAirlineRoutes.json # 四雄多月份資料（分析頁與地圖頁）
├── types/
│ ├── route.ts
│ └── airline.ts
scripts/
└── parseOds.py # ODS → JSON 解析器（支援多月份追加）
| 路徑 | 說明 |
|---|---|
/ |
台灣航空載客率分析（首頁） |
/airlines/china-airlines |
華航載客率分析 |
/airlines/eva-air |
長榮航空載客率分析 |
/airlines/starlux |
星宇航空載客率分析 |
/airlines/tigerair-taiwan |
台灣虎航載客率分析 |
/routes |
台灣航點探索地圖 |
/airline-battle |
redirect → /（舊網址相容） |
History mode 注意事項
專案目前使用
createWebHistory()，實際網址為/routes格式，不使用/#/routes。 Vercel 透過vercel.jsonrewrites 將所有路徑導回index.html，避免重新整理或直接開啟內頁時出現 404。
index.html：靜態 title / description / og / twitter / JSON-LD（預設首頁內容）src/utils/seo.ts：路由切換後動態更新所有 meta，canonical / og:url 依路徑產生- 主要目標關鍵字：
台灣航空載客率、台灣航空 載客率 - 正式網址目前設定為
https://taiwanairlinedata.com/，若改用自訂網域須同步更新SITE_BASE、sitemap.xml、robots.txt與og-image.svg
mise install # 安裝 .mise.toml 指定的 node / python 版本
npm install
npm run dev # http://localhost:5173
npm run build # 型別檢查 + 打包
npm run preview # 預覽打包結果程式碼授權尚未指定。資料來源與官方統計內容之權利歸原始資料提供單位所有；本專案僅進行二次整理與視覺化展示。