reviewed_by: rd: yo pm: Zoe

各級選舉投開票所(tw.gov.cec~ref~polling-station

版本:2026-06 最後更新:2026-06-06 維護:歐噴資料(data.openfun.tw) 授權:CC-BY 4.0 International 原始資料授權:政府資料開放授權條款 OGDL-Taiwan-1.0


資料集概述

本資料集收錄歷次各級選舉與公投的投開票所,並記錄每個投開票所對應的縣市、鄉鎮、村里 行政區代碼,作為其他選舉資料集(得票數等)以 投開票所識別碼 串接的對照基準。

資料以「選舉 × 投開票所」為單位,同一實體投開票所在不同選舉各有一筆。筆數隨新選舉增加;總筆數見 Portal 資料集頁面,目前涵蓋之選舉代碼以 agg?group_by=選舉代碼 為準(亦可對照 tw.gov.cec~ref~election-event)。

本資料集只存代碼、不含投開票所名稱或地址。 它回答的是「某投開票所屬於哪個 縣市/鄉鎮/村里」,而非投開票所的實際名稱或所在地點。


資料來源

項目 說明
原始來源 中央選舉委員會,發布於政府資料開放平台 - 選舉資料庫(含選舉區資料)(data.gov.tw/13119)
原始授權 政府資料開放授權條款 OGDL-Taiwan-1.0
歐噴取得方式 定期下載選舉資料庫 ZIP 解析
更新頻率 每週更新
涵蓋範圍 歷次各級選舉與公投的投開票所;總筆數見 Portal 資料集頁面,目前涵蓋之選舉代碼以 agg?group_by=選舉代碼 為準

法源依據

本資料由中央選舉委員會發布於政府資料開放平台(data.gov.tw),採「政府資料開放授權 條款-第 1 版」(OGDL-Taiwan-1.0)授權,任何人皆可自由使用、重製及公開散布。歐噴 資料依此授權條款取用,並依條款要求標示資料來源。


資料特性與限制

資料準確性

代碼與行政區對應直接取自中選會選舉資料庫;行政區代碼(縣市/鄉鎮/村里)對應 tw.openfun~entity~geo

涵蓋範圍說明

以「選舉 × 投開票所」為單位:同一實體投開票所在每次選舉各有一筆記錄,識別碼 含選舉代碼,故跨選舉的同一票所代號不會合併。

常見誤用與注意事項

  • 無投開票所名稱/地址。 本資料集僅有代碼欄位,欲取得投開票所的地理歸屬(縣市/ 鄉鎮/村里)可用本資料集,但票所的名稱、地址不在此。
  • 村里代碼 為多值陣列。 一個投開票所可對應一個以上村里代碼。人口密集區多為單一 村里,但外島/小型行政區常見一所涵蓋多村里:實測連江縣(09007)334 筆中有 228 筆 為多村里,例如 ELC-L0-4:09007:0003 一所涵蓋 6 個村里(09007010-004009)。串接時 務必以陣列處理,勿假設恰為一個值。
  • 投開票所識別碼 含選舉代碼。 要找「同一票所跨選舉」需自行比對縣市代碼+投開票所 代號,不能直接用 識別碼 比對。

與其他資料來源的差異

對比 說明
tw.gov.cec~txn~votes-geo 各投開票所的得票地理彙整,以 投開票所識別碼 對應本資料集的 識別碼
tw.openfun~entity~geo 行政區代碼(縣市/鄉鎮/村里)的名稱對照來源

欄位說明

共 6 個欄位,皆為代碼(keyword)。

識別碼

投開票所識別碼(keyword,_id)。格式為 {選舉代碼}:{縣市代碼}:{投開票所代號}, 例如 ELC-P0-15:10009:0350。精確查詢用 ?識別碼=ELC-P0-15:10009:0350

選舉代碼

選舉代碼(keyword,可篩選),對應 tw.gov.cec~ref~election-event。例如 ELC-P0-15

縣市代碼

縣市層級行政區代碼(keyword,可篩選,5 碼),對應 tw.openfun~entity~geo。例如 10009

投開票所代號

投開票所代號(keyword,可篩選),縣市內部編號,實測各年代皆為 4 碼零補(如 0350)。 同一代號在不同縣市/選舉會重複,需搭配 縣市代碼選舉代碼 才唯一。

鄉鎮代碼

鄉鎮市區層級行政區代碼(keyword,可篩選,8 碼),對應 tw.openfun~entity~geo。例如 10009110

村里代碼

村里層級行政區代碼(keyword,可篩選,多值陣列),對應 tw.openfun~entity~geo。 例如 ["10009110-018"]。一個投開票所可涵蓋一個以上村里(外島/小區常見,如連江縣 ELC-L0-4:09007:0003 涵蓋 6 個村里)。


更新頻率與版本記錄

版本 更新日期 說明
2026-06 2026-06-06 初始建立(API 查詢驗證 519,892 筆、6 欄 schema)

相關資料集

資料集 關聯說明
tw.gov.cec~ref~election-event 選舉代碼 對應的選舉事件清單
tw.gov.cec~txn~votes-geo 各投開票所得票地理彙整,以 投開票所識別碼 串接本資料集
tw.gov.cec~txn~candidates-votes 候選人得票,含 投開票所識別碼
tw.openfun~entity~geo 縣市/鄉鎮/村里代碼的名稱與層級對照

AI 使用指引

AI agent 使用指引(含 curl 範例、跨資料集對照流程)見 skill.md