reviewed_by: rd: yo pm: Zoe

tw.gov.cec~txn~votes-geo — 中選會各選區投票概況

版本：2026-05　最後更新：2026-05-29　維護：歐噴資料（data.openfun.tw）　授權：CC-BY 4.0 International　原始資料授權：政府資料開放授權條款－第 1 版

資料集概述

中央選舉委員會所公開之各選區、各行政區的投票概況：選舉人數、投票數、有效票數、廢票數。每筆紀錄是「某次選舉 × 某選區（選票別）× 某行政區（或彙總層）」的投票統計。這是計算投票率、廢票率的基礎資料。

本資料集為交易型（txn）資料，可串接：

資料來源

項目 說明
原始資料 中央選舉委員會選舉資料庫 https://db.cec.gov.tw
整理來源 歐噴資料庫（data.openfun.tw）
原始授權 政府資料開放授權條款－第 1 版
引用標示 資料來源：歐噴資料庫（data.openfun.tw）／中央選舉委員會
總筆數 見 Portal 資料集頁面（隨新選舉持續增加）
涵蓋範圍 中選會選舉資料庫所載歷屆各級選舉的投票概況 [來源: of-scripts-選舉資料庫-knowledge.md]；場次隨新選舉增加，目前涵蓋以 agg?group_by=選舉代碼 或 tw.gov.cec~ref~election-event 為準
更新頻率 不定期，每有新選舉資料釋出時新增

⭐ 核心概念：選區代碼 區分選票別

同一場立委選舉其實同時有 區域／平地原住民／山地原住民／不分區 多張選票（議員、代表也分區域與原住民），它們各自獨立計票、選舉人數不同（原住民票只有原住民選民能投）。本表用 選區代碼 區分這些選票 [來源: of-scripts-選舉資料庫-knowledge.md]：

選區代碼 選票別 說明
00 區域（彙總） 該縣市區域票彙總；總統、縣市長、村里長等單一選票選舉多為 00
01、02… 區域（各選區） 區域票的各選區
平地原住民 平地原住民票 僅平地原住民選民可投
山地原住民 山地原住民票 僅山地原住民選民可投
不分區 不分區政黨票 立委政黨票（第二票）

數字選區代碼（01、02…）的數量依各選舉的選區數而定，會隨新選舉增加；目前實際出現的選區代碼值請用 agg?group_by=選區代碼 查詢 [來源: api-agg-by-district-code.json]。

範例（109 年立委、台北市 63000）[來源: of-scripts-選舉資料庫-knowledge.md]：

ELC-L0-10:00:63000         選舉人數 2,142,067   區域（全市 8 選區彙總）
ELC-L0-10:01:63000         選舉人數   275,438   區域第 1 選區
ELC-L0-10:不分區:63000      選舉人數 2,166,479   不分區政黨票
ELC-L0-10:平地原住民:63000   選舉人數     7,129
ELC-L0-10:山地原住民:63000   選舉人數     4,865

不分區政黨各黨的「得票數」在 tw.gov.cec~txn~party-votes；本表仍保留 不分區 選票，是因為不分區票的選舉人數／投票數／廢票與區域票不同，而 party-votes 沒有這些欄位 [來源: of-scripts-選舉資料庫-knowledge.md]。

行政區層級（行政區層級）

投票概況依行政區層級分層儲存，由細到粗為 [來源: api-agg-by-level.json]：

行政區層級 說明
village 村里層（筆數最多）
town 鄉鎮市區層
county 縣市層
national 全國層

national 層 行政區代碼 為空字串 [來源: api-example-11-partyballot-national.json]。

查全國總計

篩 行政區代碼 為空，每種選票在全國層剛好一筆：

  • 區域票：選區代碼 為數字的那筆（唯一一筆）。多選區選舉（區域立委、議員、代表）是 00；單一選區選舉（總統、縣市長、村里長、立委補選）就是它那個唯一的數字代碼（如總統為 01）。
  • 原住民／不分區票：對應的 選區代碼（平地原住民／山地原住民／不分區）。

欄位說明

識別碼

主鍵（_id），格式 {選舉代碼}:{選區代碼}:{第三段}。第三段在 village 層為 投開票所識別碼（如 ELC-L0-4:01:ELC-L0-4:09007:0003），其餘層級為 行政區代碼；national 層行政區代碼為空，結尾為 :（如 ELC-L0-11:不分區:）。

選舉代碼

對應 tw.gov.cec~ref~election-event 的 vote_id。為篩選器欄位。

選區代碼

區分選票別，見上節。為篩選器欄位。值為中選會選區代碼（數字）；原住民／不分區選票無實際選區，改填 平地原住民／山地原住民／不分區 [來源: api-schema-and-sample.json]。

行政區層級 與 行政區代碼

  • 行政區層級：village / town / county / national（篩選器）
  • 行政區代碼：對應 tw.openfun~entity~geo，5/8/12 碼。town／county 層填該層代碼、national 層為空。village 層：當該列帶有 投開票所識別碼 時 行政區代碼 留空，地理歸屬改由 投開票所識別碼 串接取得；行政區代碼 只是「沒有 投開票所識別碼 時」的 fallback（少數無票所資訊的村里列才會在此填入村里代碼）（篩選器）。

投開票所識別碼

該村里層投票概況對應的投開票所，對應 tw.gov.cec~ref~polling-station 的 識別碼，格式 {選舉代碼}:{縣市代碼}:{投開票所代號}（如 ELC-P0-11:63000:0580）。僅 village 層有值，town／county／national 層為空。近年選舉的村里層投票概況實為「以投開票所為單位」：每列即一個投開票所、行政區代碼 留空，須以本欄串 polling-station 才能得知其涵蓋的村里（一所可涵蓋多村里）。為篩選器欄位。

選舉人數

有投票權的人數（整數）[來源: api-schema-and-sample.json]。

投票數

= 有效票數 + 廢票數（整數）[來源: api-schema-and-sample.json]。投票率 = 投票數 ÷ 選舉人數。

有效票數

有效票數（整數）。

廢票數

廢票數（整數）。廢票率 = 廢票數 ÷ 投票數。

村里層＝投開票所層（投開票所合併的處理）

實務上多個人口不足的村里會共用同一投開票所（如馬祖、屏東市部分里）時，中選會的原始資料顯示的就是合併後的投票概況。本資料集該列為投開票所的整體投票概況（選舉人數／投票數／廢票數為全所總計、未拆分），投開票所識別碼 為其鍵、行政區代碼 留空。要得知該所涵蓋哪些村里，以 投開票所識別碼 串 tw.gov.cec~ref~polling-station 的 村里代碼（多值）。

因此無法取得「合併投開票所」內各村里的個別投票概況——最細真實粒度是投開票所，不是村里。

資料特性與限制

常見誤用與注意事項

  1. 務必先選對 選區代碼：同場立委選舉同時有區域／原住民／不分區多張選票，選舉人數各不同。算投票率前先確認要哪張票。
  2. 層級不可相加：village/town/county/national 是同統計的不同粒度。
  3. 全國區域票＝唯一的數字選區代碼列：篩 行政區層級=national、行政區代碼 空，區域票即 選區代碼 為數字那筆（多選區選舉為 00，總統等單一選區為其唯一代碼）。
  4. 只有投票概況，沒有得票數：候選人得票在 tw.gov.cec~txn~candidates-votes，政黨得票在 tw.gov.cec~txn~party-votes。
  5. 少數歷史村里沒有村里層投票概況：部分歷年改名、裁併或用罕用字的村里地名無法對應到現行行政區代碼，這些村里的村里層會缺漏；全國／縣市／鄉鎮彙總不受影響 [來源: of-scripts-選舉資料庫-knowledge.md]。
  6. 立委補選：補選選區常為「數個村里」的範圍描述，這些村里的村里層投票概況可能缺漏 [來源: of-scripts-選舉資料庫-knowledge.md]。

相關資料集

資料集 關聯說明
tw.gov.cec~ref~election-event 投票事件，選舉代碼 引用其 vote_id
tw.openfun~entity~geo 行政區代碼，行政區代碼 引用
tw.gov.cec~txn~candidates-votes 候選人得票（同行政區）
tw.gov.cec~txn~party-votes 不分區政黨得票（選區代碼=不分區 對應）

更新頻率與版本記錄

版本 更新日期 說明
2026-05 2026-05-29 知識文件初始建立；schema、層級分布、選區代碼語意、第11屆不分區全國概況經 API 實查驗證，選區代碼語意與全國總計取法引自 open-forest-scripts 整理文件
2026-06 2026-06-06 資料改版：移除 合併票數 / 合併票數.村里，改為村里層即投開票所層（新增 投開票所識別碼、行政區代碼 於村里層留空為 fallback），同步改寫合併處理與加總說明

AI 使用指引

AI agent 使用指引見 skill.md。