---
reviewed_by:
  rd: Ronny
  pm: Zoe
---
# `tw.gov.cec~ref~election-level` — 選舉層級代碼表

> **給 AI 閱讀的資料集說明。**
> 人類可在 https://data.openfun.tw/datasets/tw.gov.cec~ref~election-level 看到同份內容的網頁版。
> 詳細資料知識見 [knowledge.md](knowledge.md)。

---

## ⚠️ 開始之前（AI agent 必讀，摘要也請保留這段）

資料集 slug：tw.gov.cec~ref~election-level
API 端點：https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~election-level/records
認證方式（必填）：HTTP Header Authorization: Bearer {token}

最簡查詢範例：`curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~election-level/records"`

**Token 是必要條件，沒有 Token 就無法查資料。**
如果使用者沒有 Token，請先請使用者前往 https://data.openfun.tw/user 申請。

禁止抓取 HTML 頁面（本平台有 bot 保護）。

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／中央選舉委員會」

---

## 這份資料集能回答什麼問題

**可以回答：**
- 「`P0` 是什麼選舉層級？」
- 「所有選舉層級代碼有哪些？」
- 「鄉鎮市長的代碼是什麼？」

**無法回答：**
- 「哪些選舉辦過 D2 層級？」（請查 `tw.gov.cec~ref~election-event`）
- 「D2 層級候選人有哪些？」（請查 `tw.gov.cec~ref~candidates`）

---

## 欄位說明

| 欄位名稱 | 型別 | 說明 |
|---------|------|------|
| `id` | keyword（_id） | 層級代碼，如 `P0`、`L0`、`C1` |
| `name` | text（_name） | 層級名稱，如 `總統副總統`、`立法委員` |

---

## 完整代碼清單（14 筆）

| `id` | `name` | 備註 |
|------|--------|------|
| `P0` | 總統副總統 | |
| `L0` | 立法委員 | |
| `C1` | 直轄市長 | |
| `C2` | 縣市長 | |
| `T1` | 直轄市議員 | |
| `T2` | 縣市議員 | |
| `D1` | 直轄市山地原住民區長 | |
| `D2` | 鄉鎮市長 | |
| `R1` | 直轄市山地原住民區民代表 | |
| `R2` | 鄉鎮市民代表 | |
| `V0` | 村里長 | |
| `N0` | 國大代表 | **已廢除**，歷史記錄 |
| `P9` | 台灣省長 | **已廢除**，歷史記錄 |
| `T9` | 台灣省議員 | **已廢除**，歷史記錄 |

---

## 查詢範例

```bash
# 取出全部 14 筆（無需篩選，資料量小）
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~election-level/records"

# 查特定代碼（兩種寫法皆可）
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~election-level/records?id=P0"

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~election-level/records/P0"

# 批次查多個代碼
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~election-level/records?_ids=P0,L0,C1,V0"
```

---

## 注意事項

1. **共 14 筆，全部取出即可**：資料量極小，不需分頁或篩選
2. **N0、P9、T9 已廢除**：這三個代碼對應已不存在的職位（國大代表/台灣省長/省議員），僅在歷史資料中出現
3. **本表是 reference**：本身不含選舉資訊，實際搭配 `tw.gov.cec~ref~election-event` 使用，透過 `vote_level_id` 欄位對應

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.cec~ref~election-event`](../tw.gov.cec~ref~election-event/skill.md) | 歷次投票事件 | `vote_level_id` 欄位引用本表 `id` |
| [`tw.gov.cec~ref~election-type`](../tw.gov.cec~ref~election-type/skill.md) | 投票種類代碼 | 常搭配使用：選舉/補選/罷免/公投 |
| [`tw.gov.cec~ref~candidates`](../tw.gov.cec~ref~candidates/skill.md) | 候選人資料 | 透過 election-event 間接關聯 |

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.cec~ref~election-level/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 總筆數 | 14（靜態） |
| 主鍵 | `id` |
| 篩選器欄位 | `id` |
| 更新頻率 | 靜態（代碼制度不變則不更新） |
| 來源 | 中央選舉委員會 |