本專案旨在提供方便視覺化的臺灣行政區域與村里界線圖資。

為了減輕讀取負擔與減小單一檔案大小，本專案會將政府資料開放平台提供的原始圖資（Shapefile 格式，.shp）轉檔為 TopoJSON 格式，並切割成三個層級：

• topojson/counties.json：全國各直轄市與縣市邊界。
• topojson/towns/*.json：各直轄市與縣市獨立一份檔案，檔名為其行政區代碼。包含其轄區下的各個鄉鎮市區邊界。
• topojson/villages/*.json：各鄉鎮市區獨立一份檔案，檔名為其行政區代碼。包含其轄區下的各個村里邊界。

若是想要自行填入各行政區與村里對應的資料，僅需修改 csv/ 目錄下的檔案，並自行添加所需欄位。再修改 Makefile 檔，在 SPLIT_COUNTIES_OPTS、SPLIT_TOWNS_OPTS 或 SPLIT_VILLAGES_OPTS 的 -filter-fields 後加上要包含的欄位名稱（以逗號隔開）。最後重新生成 TopoJSON 檔即可（建置方法請見下節）。

註：欲查詢行政區域與村里代碼請參考這裡。

topojson/ 目錄下已有預建置好的基本圖資（資料僅有行政區／村里代碼與名稱）。

要重新生成 TopoJSON 檔，請先從下節「資料來源」下載所需的原始檔案，並解壓縮到 raw/ 目錄中。

接著，安裝 mapshaper，並執行以下命令：

$ make split-all topojson-all

也可以將 -all 改成 -counties、-towns 或 -villages，僅生成特定層級的圖資。如：

$ make split-towns topojson-towns

僅會生成各直轄市與縣市的 TopoJSON 檔。

若是僅需特定行政區域或村里的 TopoJSON 檔，則直接指定生成的檔案名稱。舉例來說，如欲生成臺北市中正區（代碼 6300500）的各村里邊界檔，則需執行：

$ make villages/villages-6300500.json

• 直轄市、縣市界線(TWD97經緯度) | 政府資料開放平台
• 鄉鎮市區界線(TWD97經緯度) | 政府資料開放平台
• 村里界圖(TWD97經緯度) | 政府資料開放平台