臺灣門牌地址查詢

本專案提供政府門牌座標資料，供程式依地址查詢座標。資料按縣市與道路分成 CSV，以下稱為「路檔」。程式碼採 BSD License。資料來源與使用限制見下方說明。

取得與查詢

下載本專案檔案後，可用自己的程式離線讀取 roads/ 下的路檔。road.csv 是道路索引，用來找到對應檔案。讀取前請先看資料格式，保留行政區代碼的前導零，並確認座標欄位與去重規則。

若要使用既有查詢頁面，在專案目錄啟動本機伺服器：

python -m http.server

開啟本機查詢頁面。頁面使用 address.html、address.js 與本機 CSV，不會更新門牌資料。jQuery 和 Bootstrap 從外部網站載入，因此頁面仍需要網路。

資料範圍與限制

截至 2026-10-14，本機道路索引涵蓋 22 個縣市，更新器設定其中 18 個縣市。宜蘭縣、南投縣、連江縣與嘉義市的既有路檔不經過更新器。各縣市來源與維護方式見政府資料更新。

使用資料時，請注意：

• 輸出 X 是經度，Y 是緯度。小數位數不代表定位精度，也不能證明每筆座標正確。
• 程式依門牌欄位與距離去重，仍可能保留同號多列。不要把地址文字當成已驗證的唯一識別值。
• 缺字修正依對照表套用。未列入對照的字元可能保留，部分罕用字也可能因字型而無法顯示。
• update_log.csv 的 last_updated 是本機執行日期，不是政府資料產製日期。

欄位與處理規則以資料格式為準。資料品質及更新中斷等限制見已知問題。

維護與文件

更新會改寫路檔、道路索引及更新紀錄。執行前請閱讀政府資料更新，確認命令的連線、寫檔及失敗影響。

來自 taiwan-lvr-geodata 的補充匯入目前暫停。supplements/ 與相關程式保留，狀態及重新啟用前的條件見地址補充層。

文件	用途
資料格式	解釋檔案、欄位與資料處理規則
政府資料更新	說明本機更新、維護命令與 GitHub Actions
已知問題	說明影響範圍、既有證據與待確認事項
地址補充層	說明暫停的補充流程
執行紀錄	保存各次操作、檢查與更正
歷史文件	保存已被取代的原文，不作現行操作依據

歷史紀錄包括文件整理、新竹澎湖金門重跑、缺字還原、全縣市缺字與門牌及村里處理。各項結果只代表紀錄所列的日期、版本與驗證範圍。