reviewed_by: rd: Ronny pm: Zoe

`tw.gov.ris~ref~geo-village` — 戶役政村里代碼表

⚠️ 使用建議

一般用途請改用 tw.openfun~entity~geo。

本系列（tw.gov.ris~ref~geo-county/town/village）照搬自戶役政資訊系統資料代碼內容清單，主要供查證行政區主管機關的官方原始代碼。tw.openfun~entity~geo 是歐噴在此基礎上清整完成的版本，涵蓋範圍更完整、結構更易用，一般查詢行政區代碼應優先使用。

資料集概述

內政部戶役政資訊系統（RIS）所使用的村里層級地理代碼，共 7,770 筆。

代碼格式

village_id：11 碼，結構為 [town_id 8 碼][村里序號 3 碼]
town_id：8 碼，對應 tw.gov.ris~ref~geo-town 的 id

範例：

village_id: 09007010001
town_id: 09007010（連江縣鄉鎮代碼）
村里序號：001（第 1 村里）

欄位說明

欄位	型別	說明
`village_id`	keyword（_id）	村里代碼（11 碼）
`town_id`	keyword	所屬鄉鎮市區代碼（8 碼），對應 tw.gov.ris~ref~geo-town
`name`	text（_name）	村里名稱（僅村里名，不含縣市與鄉鎮）

注意事項

name 不含上層地名：僅記錄村里名稱（如 介壽村），不含縣市或鄉鎮。完整地名需透過 town_id JOIN tw.gov.ris~ref~geo-town 取得。
7,770 筆涵蓋歷史與現行村里：含已廢除的舊村里代碼，非只有現行行政區。
town_id 對應 geo-town 的主代碼：連結到末位為 0 的主地理代碼，不會對應到機關代碼（末位 6）或多版本代碼（末位 1、2）。
與 tw.openfun~entity~geo 的村里代碼格式不同：本資料集 village_id 為 11 碼純數字（如 09007010001），entity~geo 為 {8 碼}-{3 碼}（如 09007010-001）。兩者村里序號相同，但字串格式有別，跨資料集 JOIN 時需先統一格式（去除破折號，或加上）。

相關資料集

資料集	關聯說明
`tw.gov.ris~ref~geo-town`	鄉鎮層級，`town_id` 欄位引用此表
`tw.gov.ris~ref~geo-county`	縣市層級
`tw.openfun~entity~geo`	通用行政區代碼（不同代碼體系）

資料來源

項目	說明
原始資料	內政部戶役政資訊系統資料代碼內容清單
整理來源	歐噴資料庫（data.openfun.tw）
總筆數	7,770
更新頻率	靜態（行政區制度調整時才更新）