reviewed_by: rd: Ronny pm: James
全國行政區代碼（tw.openfun~entity~geo）
版本：2026-05 最後更新：2026-05-17 來源：內政部 SEGIS（segis.moi.gov.tw） 授權：政府資料開放授權條款－第 1 版
資料集概述
本資料集收錄台灣全國行政區的官方代碼與名稱，涵蓋縣市、鄉鎮市區、村里三個層級，同時包含現行及歷史已廢止行政區（含縣市合併升格前的舊代碼）。
主要用途：
- 把代碼「翻譯」成名稱（其他資料集只有代碼沒有名稱時）
- 確認某個代碼屬於哪個層級、哪個縣市
- 追蹤行政區改制沿革（哪些舊代碼對應到現在的哪個代碼）
資料來源
原始資料來自內政部社會經濟資料服務平台（SEGIS），具體為三種界圖資料集：
| 界圖 | 產品代碼 | 說明 |
|---|---|---|
| 縣市界圖 | 140006 | 縣市層級行政區邊界 |
| 鄉鎮市區界圖 | 140005 | 鄉鎮市區層級行政區邊界 |
| 村里參考界圖 | 140004 | 村里層級行政區邊界 |
原始格式為 Shapefile，有新版本時更新（每日自動檢查）。
行政區層級與代碼格式
縣市（level = county）
- 代碼格式：5 位數字
- 直轄市（六都）：
63000–68000 - 省轄縣市：
09007、09020、10002–10020
現行 22 縣市代碼：
| 代碼 | 名稱 | 代碼 | 名稱 |
|---|---|---|---|
| 63000 | 臺北市 | 10002 | 宜蘭縣 |
| 65000 | 新北市 | 10004 | 新竹縣 |
| 66000 | 臺中市 | 10005 | 苗栗縣 |
| 67000 | 臺南市 | 10007 | 彰化縣 |
| 64000 | 高雄市 | 10008 | 南投縣 |
| 68000 | 桃園市 | 10009 | 雲林縣 |
| 10017 | 基隆市 | 10010 | 嘉義縣 |
| 10018 | 新竹市 | 10013 | 屏東縣 |
| 10020 | 嘉義市 | 10014 | 臺東縣 |
| 09007 | 連江縣 | 10015 | 花蓮縣 |
| 09020 | 金門縣 | 10016 | 澎湖縣 |
鄉鎮市區（level = town）
- 代碼格式：8 位數字
- 前 5 碼 = 所屬縣市代碼
- 例：
65000010（新北市板橋區）— 前 5 碼65000= 新北市
村里（level = village）
- 代碼格式：
{8碼}-{3碼}（含破折號） - 前 8 碼 = 所屬鄉鎮市區代碼
- 例：
65000010-001（新北市板橋區第 001 里）
注意：村里代碼含破折號，與縣市、鄉鎮的純數字格式不同，字串比對或儲存時需注意。
現行代碼 vs 歷史廢止代碼
本資料集同時收錄現行與已廢止的行政區代碼。判斷方式：
end_date為空 → 現行有效end_date有日期值 → 已廢止，廢止日期即為該欄位值
目前縣市層級共 29 筆，其中 7 筆為歷史廢止（臺北縣 10001、桃園縣 10003、臺中縣 10006、臺南縣 10011、高雄縣 10012、臺中市 10019、臺南市 10021）。
API 查詢注意：
end_date欄位目前無法透過=空值直接篩選（date 型別不支援空值過濾）。有兩種做法：
- 使用
_as_of參數（推薦）：?_as_of=now或?_as_of=YYYY-MM-DD，API 會自動回傳該時間點有效的記錄，詳見 skill.md。- 取回後在程式端判斷：取得所有記錄後，判斷
end_date是否為空以區分現行與歷史代碼。
行政區改制沿革
縣市合併升格等改制資訊記錄在以下欄位：
| 欄位 | 說明 | 範例 |
|---|---|---|
from |
此代碼由哪些舊代碼合併改制而來（陣列） | 新北市 65000 的 from = ["10001"] |
to |
此代碼被哪個新代碼取代（陣列） | 臺北縣 10001 的 to = ["65000"] |
log |
變動紀錄，格式 "日期:說明" |
"2010-12-25:臺北縣改制為新北市" |
name_alias |
歷史名稱 / 別名（陣列） | 那瑪夏區的 name_alias = ["三民鄉"] |
追蹤跨改制時期的資料時，可透過 from/to 串接新舊代碼。
常見使用方式
1. 把代碼翻譯成名稱
當你手上有縣市或鄉鎮代碼（例如 tw.gov.fia.eip~ref~business-tax 的 營業地址.縣市 = 65000），查本資料集取得對應名稱：
代碼 65000 → 查 tw.openfun~entity~geo → full_name = "新北市"
代碼 65000010 → 查 tw.openfun~entity~geo → full_name = "新北市板橋區"2. 確認某代碼屬於哪個縣市
鄉鎮代碼前 5 碼即縣市代碼，可直接截取，不需額外查詢。
3. 取得某縣市所有鄉鎮
使用 county_id 欄位篩選（有 filter: true）：
?level=town&county_id=65000 → 新北市所有鄉鎮市區與其他代碼標準的關係
本資料集代碼直接沿用 SEGIS 原始欄位（COUNTY_ID、TOWN_ID、V_ID）。
待確認：SEGIS 代碼是否與戶政司（CIAS）、主計總處的行政區代碼標準完全一致尚未驗證，跨資料集 JOIN 時請留意代碼來源。
更新頻率與版本記錄
| 版本 | 更新日期 | 說明 |
|---|---|---|
| 初版 | 2026-05-17 | 建立知識文件，確認欄位結構、代碼格式、改制案例 |
相關資料集
| 資料集 | 說明 | 關聯 |
|---|---|---|
tw.gov.fia.eip~ref~business-tax |
全國稅籍登記 | 營業地址.縣市（5碼）、營業地址.鄉鎮市區（8碼）使用本資料集代碼 |
tw.gov.dgpa~ref~gov-org |
政府機關代碼 | 機關地址欄位可搭配縣市代碼查詢 |
tw.gov.ris~ref~geo-county |
戶政司縣市代碼 | 內政部戶政司版本的行政區代碼，與本資料集（SEGIS）來源不同，跨資料集 JOIN 前須確認代碼一致性 |
tw.gov.ris~ref~geo-town |
戶政司鄉鎮代碼 | 同上，鄉鎮市區層級 |
tw.gov.ris~ref~geo-village |
戶政司村里代碼 | 同上，村里層級 |
AI 使用指引
AI agent 使用指引（含 _as_of 時間點查詢、欄位篩選語法、批次代碼翻譯流程）見 skill.md。