Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

MetroPulse|台北捷運推薦使用說明書

MetroPulse 幫助你決定「搭捷運,下一站去哪?」。選擇出發站、時段與偏好後,網站會推薦前 5 個站點(Top 5),並說明推薦理由與評分依據。

這是從台北捷運人流研究延伸的學術/專題展示作品,使用 PageRank 分析站點在旅運網路中的相對重要性,再結合人流連結、興趣偏好與旅行成本產生推薦。推薦依據是歷史資料,不是即時人潮或擁擠度預測。

開始使用:開啟 MetroPulse。直接使用網站不需要安裝開發工具,也不需要登入。

這份說明書怎麼讀

  • 第一次使用:從「快速開始」讀起。
  • 想知道推薦怎麼判讀:閱讀「看懂推薦結果」與「資料範圍與限制」。
  • 想在自己的電腦操作:閱讀「在本機啟動」。
  • 想開發、部署或更新資料:前往文件總覽,依工作選擇手冊。

快速開始

  1. 開啟首頁。
  2. 在「出發站」輸入中文站名、英文站名或站碼,例如「西門」或 BL11,從建議清單選取一個站點。按 Enter 會選清單第一筆;完整輸入唯一的站名或站碼(如「台北車站」)後直接按「查看推薦」也可以。想瀏覽全部站點,可在空白欄位按方向鍵,或按「從路線圖選站」。
  3. 選擇時段。預設為「下午 14:00–17:00」。
  4. 選擇偏好:不限、景點、美食、購物、夜生活或親子。預設為「不限」。
  5. (選填)展開「資料期間」。預設是「最新月份(自動)」,也可以指定已匯入月份、完整年度或連假;收合時會顯示目前的選擇。
  6. 按「查看推薦」,閱讀前 5 名站點與推薦理由。手機與平板上,這個按鈕會固定在畫面底部。

例如,選擇 BL11 西門、夜間、美食,再查詢某個可用月份,就能比較適合聚餐探索的站點。改選月份或偏好可能改變結果;網站不保證每次都出現相同的五站。

輸入的文字對到多個站點(如「台北」)或找不到時,網站會說明原因,請從清單選一站。修改已選站的文字後,需要重新確認,避免使用舊站碼查詢。

轉乘站以實體站為單位顯示:例如「台北車站」只有一筆,並列出 BL12/R10 與兩條路線徽章。建議清單會把完全符合站名或站碼的站點排在最前面。推薦結果不會包含出發站本身(含它在其他路線的站碼);用 R10 出發與用 BL12 出發會得到相同結果。

選擇時段與偏好

時段 分析時間 代碼(供 API 使用)
晨峰 07:00–09:00 morning_peak
上午 09:00–12:00 morning
午間 12:00–14:00 noon
下午 14:00–17:00 afternoon
晚峰 17:00–19:00 evening_peak
夜間 19:00–23:00 night

以上區間包含起始時間,不包含結束時間。例如夜間使用 19、20、21、22 時的資料;23:00 與 00:00–06:00 不在目前模型內。特殊通宵營運事件屬於未來獨立分析項目。

偏好 怎麼選
不限 先探索整體推薦,使用現有標籤的平均分數
景點 偏重站點的景點標籤
美食 偏重站點的美食標籤
購物 偏重站點的購物標籤
夜生活 偏重站點的夜生活標籤
親子 偏重站點的親子標籤

偏好是站點層級的分類,不是即時店家清單;推薦理由中的地點也不代表網站已確認當天營業狀態。

選擇資料範圍

資料範圍收在表單的「資料期間」折疊區,位於偏好之後;不展開時使用最新月份。

模式 操作方式 適合用途
月份 保留最新月份,或從清單選擇特定月份 依某個月的歷史旅運模式探索站點
年度 選擇已完整計算的年度 查看全年累積旅運網路的推薦與排名
連假 先選節日,再選可用年份 查看該段連假的旅運模式

選單依資料服務回傳的可用範圍產生。年度需要全年資料完整;連假需要整段假期每天的六個時段完整,才會成為可選項。沒有選項時,請改用其他範圍。

目前不能自行輸入任意起訖日,也沒有分開的平日/週末篩選。

查詢完成後,請以結果摘要顯示的實際資料範圍與資料來源判讀。若之後修改條件,舊結果會標示「條件已變更,請重新查詢」;按「查看推薦」才會更新結果。

看懂推薦結果

每筆推薦提供名次、站名、路線代碼、排序分數、「主要加分」、分數組成條、推薦理由,以及「查看評分依據」。

  • 主要加分:三項加分中貢獻最大的一項;和它差距在一成以內的項目會一起列出,例如「主要加分:「美食」偏好、夜間熱門度」。
  • 結果路網縮圖:桌機在清單右側;手機為了讓第一屏先看到推薦卡,放在五張卡之後。它用路網示意圖標出出發站與 5 個推薦站的位置,數字是名次,並自動縮放到這幾站的範圍。它只標位置,不畫搭乘路線,也不代表實際距離。
  • 分數組成條:依序以三種顏色顯示熱門度、人流連結與偏好的加分。五張卡共用同一尺度,滿格是最高可能分數,所以可以直接比較名次之間差在哪裡。旅行成本另從總分扣除,不畫在長條上。
評分項目 權重 判讀方式
時段熱門度(PageRank) 0.30 站點在所選歷史範圍與時段的相對重要性
人流連結性 0.25 出發站與候選站的相對人流連結強度
偏好匹配 0.30 站點標籤與所選興趣的匹配程度
旅行成本 0.15,扣分 現有交通成本資料經換算後的負向項

「查看評分依據」會列出每一項的原始值、換算值(0–1)、權重與加權分數。

  • 0.xx 是本次查詢的排序分數,不是你喜歡該站的機率,也不適合直接跨不同查詢比較。
  • 連結強度百分比可能是候選間正規化結果,不等同實際旅客比例。
  • 旅行成本、站數、轉乘與時間資訊是既有估計資料,不能直接當成已核實的搭乘路線或班表。
  • 顯示「未知」或「資料不足」表示缺少證據,不表示流量或熱門度真的等於零。

網站上的推薦方法頁說明公式與資料來源;研究細節見研究與推薦方法。

從路線圖選站

電腦寬螢幕會在查詢表單旁顯示路線圖;手機與平板可按「從路線圖選站」。

  1. 使用「放大/縮小/重設全圖」調整視野,放大後可拖曳查看路網。
  2. 點選站點,點在站點附近也可以(會選離點擊位置最近的站)。同名轉乘站(如台北車站)會直接選取,不需要再挑路線站碼。推薦結果的名次只標在結果旁的路網縮圖,上方路線圖只負責選出發站。
  3. 手機/平板的點選只會預選;按「使用此站」才會更新出發站。
  4. 按「返回查詢」、取消預選或按 Escape,可退出地圖並保留原本出發站。

地圖是路線示意圖(SVG),不代表真實地理距離,也不提供導航。站名搜尋是完整的鍵盤選站方式;不需要操作地圖才能取得推薦。

查看站點詳情

從推薦結果進入站點詳情,可查看站點身分、特徵、推薦關係,以及 PageRank、偏好與人流連結證據。圖表另有文字或同源資料表可閱讀。

  • 「返回本次推薦」會依原條件重新查詢並回到結果區。
  • 「改以此站出發」會替換出發站,保留原時段與偏好;你仍需按「查看推薦」。
  • 直接開啟站點網址,例如 /station/BL12,會顯示站點內容,不會假造先前的推薦關係。
  • 年度/連假查詢的詳情會嘗試使用同一範圍的證據;無法取得時會說明原因。

詳情頁的熱門度與人流連結使用和推薦、旅運量分析相同的真實資料:從推薦進入時沿用該次的月份/年度/連假,直接開啟時使用最新月份。頁首「資料範圍」會標示實際使用的資料;該範圍沒有資料時會改用研究初版樣本資料並說明原因,這時數字僅供示意。技術出處收在頁尾「資料來源細節」。

使用旅運量分析中心

開啟旅運量分析。

排名與圖表比較

  1. 選擇月份、年度或連假範圍。
  2. 選擇時段與 Top 10/20/30,預設為晨峰與 Top 20。
  3. 按「更新分析」。
  4. 在「站點排名」與「圖表比較」頁籤查看同一組資料。

單站月份資料

切到「月份資料」,輸入明確站碼或沒有歧義的站名,選擇時段,再按「查看月份資料」。同名轉乘站可能需要改用站碼。

只有兩個以上實際有資料的月份才顯示跨月趨勢。中間缺少的月份會保留空值、斷開折線,並在表格標示資料缺失,不會補成零。

歷年同連假比較

切到「連假比較」,選擇連假、站點與時段,再按「比較這個連假」。

比較以同一個節日代碼對齊年份,例如不同年份的春節,不要求國曆日期相同。圖表呈現各年份的 PageRank 與平均每日人流;表格保留假期日期、天數與總流量。不完整、尚未計算或站點資料不可用的年份會標示原因。

平均每日人流=該連假所選時段的總流量 ÷ 假期天數,可協助比較長度不同的連假;它不是完整 24 小時的流量。

鍵盤操作

操作位置 按鍵
站名建議清單 上/下方向鍵移動,Enter 選取,Escape 收起
表單與按鈕 Tab/Shift+Tab 移動,Enter 或空白鍵依控制元件操作
手機地圖視窗 Tab/Shift+Tab 在視窗內移動,Escape 取消並關閉
分析頁籤 方向鍵切換,Home/End 到第一個/最後一個頁籤

中文輸入法組字期間,Enter 不會直接送出推薦。

常見問題

輸入站名後仍提示選站? 代表文字對到多個站點或找不到站點,請依提示從建議清單選一站。

條件變了,結果沒有變? 網站保留上一次查詢結果並提示過期,請重新按「查看推薦」。

某個年度或連假找不到? 可能尚未登錄、尚未計算或資料不完整;請以選單與頁面訊息為準,改選可用範圍。

載入失敗怎麼辦? 使用頁面提供的「重試推薦」「重新載入資料」等按鈕。詳情與分析請求有等待上限;服務失敗不等於確定沒有資料。

結果標示合成資料? 表示該次查詢使用展示用的既有資料,請勿把它視為真實旅運觀測。實際來源以結果摘要為準。

圖表沒有出現? 先閱讀清單或資料表;圖表使用外部 Chart.js 資源,網路環境可能影響載入。

「熱門」等於現在很擠? 不等於。PageRank 描述歷史旅運網路中的相對重要性,不提供即時擁擠度。

資料範圍與限制

月份、年度與連假清單以網站當次載入的結果為準。版本庫保存的最近完整正式發布紀錄為 2026-09-19:當時已匯入 2025-01~2026-08,共 20 個月,2025 全年完整;2026 中秋與國慶僅登錄假期資料,等待對應月份匯入後計算。這是歷史快照,不代表今天的線上資料一定相同。

原始旅運資料來自台北捷運公開 OD 統計(Origin–Destination,起訖站流量)。偏好與交通成本則使用既有站點資料;即使摘要標示真實資料,也不代表每個站點、每個評分欄位都有真實觀測。

已完成的歷史聚合結果會保留;逐日明細依 18 個月政策人工清理。歷史查詢仍可用,不表示所有舊日期都還能重新計算。更詳細的來源、資料涵蓋快照與維運流程見資料維運手冊。

在本機啟動

若只想使用網站,直接開啟正式網址即可。若想在自己的電腦試用本地版本,請先準備 Node.js、npm 與 Python 3;專案 workflow 使用 Node.js 20、Python 3.11 作為執行環境。

在專案根目錄依序執行:

npm ci
python3 scripts/bootstrap_db.py --local
npm run build
npm run dev:sandbox

啟動後開啟 http://localhost:3000。保持終端機運作,結束時按 Ctrl+C。

這個流程建立本地 D1 與展示用種子資料,不會把正式網站的旅運資料下載到你的電腦。本地沒有真實月份時,推薦可使用合成資料,分析中心則可能沒有可用月份。需要真實資料時,依開發指南匯入本地月份。

進一步閱讀

需求 文件
找到所有文件與報告 文件總覽
了解專案架構、現況與未來方向 專案概覽
修改程式、準備本地環境與驗證 開發指南
呼叫推薦與分析 API API 參考
研究公式、分數與來源界線 研究與推薦方法
更新月份、連假與資料保留 資料維運手冊
本地預覽與正式部署 部署操作手冊
查看開發、驗收與發布過程 歷程與文件整理紀錄

文件整理日期:2026-10-13。使用說明依此版本的程式撰寫;歷史報告保留各自的日期與驗證範圍。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages