---
reviewed_by:
  rd: Ronny
  pm: Zoe
---
# `tw.gov.ris~ref~geo-county` — 戶役政縣市代碼表

> **給 AI 閱讀的資料集說明。**
> 詳細資料知識見 [knowledge.md](knowledge.md)。

---

## 使用建議

**一般查詢行政區代碼，請優先使用 `tw.openfun~entity~geo`**（結構完整、已清整，API slug 同名）。

本系列（`tw.gov.ris~ref~geo-county/town/village`）照搬自戶役政資訊系統官方代碼清單，主要供查證原始代碼使用，含有非純地理代碼（機關代碼等），使用前請留意。

---

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

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

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

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

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／內政部戶役政資訊系統」

---

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

**可以回答：**
- 「戶役政系統的縣市代碼有哪些？」
- 「舊臺北縣的代碼是什麼？」

**無法回答：**
- 「新北市各區的代碼？」→ 請查 `tw.gov.ris~ref~geo-town`
- 「現行行政區代碼」→ 通用用途請改用 `tw.openfun~entity~geo`

---

## 欄位說明

| 欄位 | 型別 | 說明 |
|------|------|------|
| `id` | keyword（_id） | 縣市代碼（5 碼數字，如 `10001`、`63000`） |
| `name` | text（_name） | 縣市名稱（如 `臺北縣`、`新北市`） |

---

## 查詢範例

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

# 查特定縣市
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.ris~ref~geo-county/records?id=63000"
```

---

## 注意事項

1. **共 29 筆，含歷史縣市**：包含已廢除的舊縣市（臺北縣、高雄縣、桃園縣等），需要現行代碼時請留意
2. **代碼與 `tw.openfun~entity~geo` 不同體系**：兩者長度相同（5 碼）但用途不同，戶役政相關資料用本表，通用行政區查詢用 `tw.openfun~entity~geo`
3. **本表是 reference**：搭配 `tw.gov.ris~ref~geo-town` 使用，`geo-town` 代碼前 5 碼對應本表

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.ris~ref~geo-town`](../tw.gov.ris~ref~geo-town/skill.md) | 鄉鎮市區代碼 | 代碼前 5 碼對應本表 |
| [`tw.gov.ris~ref~geo-village`](../tw.gov.ris~ref~geo-village/skill.md) | 村里代碼 | 透過 geo-town 間接關聯 |
| [`tw.openfun~entity~geo`](../tw.openfun~entity~geo/skill.md) | 通用行政區代碼 | 不同體系，通用場合使用 |

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.ris~ref~geo-county/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 總筆數 | 29（含歷史縣市） |
| 主鍵 | `id`（5 碼） |
| 篩選器欄位 | `id` |
| 更新頻率 | 靜態 |