---
reviewed_by:
  rd: yo
  pm: Zoe
---
# 地段代碼表 — `tw.gov.moi.land~ref~cadastral-sections`

> **給 AI 閱讀的使用指引。**
> 人類可在 https://data.openfun.tw/datasets/tw.gov.moi.land~ref~cadastral-sections 看到同份內容的網頁版。
> 詳細資料知識見 [knowledge.md](knowledge.md)。

---

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

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

最簡查詢範例：curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~cadastral-sections/records?per_page=20"

**Token 是必要條件，沒有 Token 就無法查資料。**
如果使用者沒有 Token，請停止並告訴使用者：「請先前往 https://data.openfun.tw/user 免費申請帳號與 API Token，取得後告訴我，我再幫您查詢。」

禁止抓取 HTML 頁面（本平台有 bot 保護，WebFetch 讀 HTML 頁面會失敗）。

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

---

## 資料來源與更新頻率

| 項目 | 說明 |
|------|------|
| 原始來源 | 內政部地政司「地段查詢系統」（lisp.land.moi.gov.tw） |
| 授權 | 政府資料開放授權條款－第1版 |
| 更新頻率 | 不定期 |
| 涵蓋範圍 | 全國地段（含已註銷段；即時筆數見資料集頁面） |

---

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

以下問題，這份資料集**可以回答**：

- 「地段代碼 `AD01-0600` 是哪個地段？」（→ 臺北市松山區西松段一小段）
- 「臺北市松山區有哪些地段？」
- 「某地段是現行還是已註銷？」
- 「把『縣市＋鄉鎮＋段名』找出對應的地段代碼」（供查實價登錄／地號用）

以下問題，這份資料集**無法回答**：

- 「某地段內有哪些地號、各筆面積」（本表只到地段層，不含地號）
- 「土地的價格、所有權人」（應查實價登錄等資料）

---

## 欄位說明

| 欄位名稱（API 參數） | 型別 | 說明 |
|---------------------|------|------|
| `地段代碼` | keyword（_id） | 鄉鎮代碼-段號（如 FH18-1818） |
| `地段代碼.縣市代碼` | keyword（ref: tw.gov.moi.land~ref~cadastral-counties） | 前 1 碼 |
| `地段代碼.事務所代碼` | keyword（ref: tw.gov.moi.land~ref~cadastral-offices） | 前 2 碼 |
| `地段代碼.鄉鎮代碼` | keyword（ref: tw.gov.moi.land~ref~cadastral-towns） | 前 4 碼 |
| `地段名稱` | text（_name） | 段+小段 |
| `地段名稱.段` | text | 段 |
| `地段名稱.小段` | text | 小段 |
| `縣市名稱` | keyword（篩選器） | 縣市名稱 |
| `鄉鎮名稱` | keyword（篩選器） | 鄉鎮名稱 |
| `事務所名稱` | keyword（篩選器） | 事務所名稱 |
| `備註` | text | 異動類型 |
| `是否現行` | boolean（篩選器） | 是否非註銷 |

12 個欄位由上方 schema 自動列出。地段代碼結構（`{鄉鎮代碼}-{段號}`）、`是否現行`、「跨越」段等語意見 [knowledge.md](knowledge.md)。

---

## 標準流程：由段名／位置找到地段代碼，再查實價登錄等土地資料

本表最主要的用途——你知道地段的位置與名稱，要拿到地段代碼，去查以地段／地號定位的土地資料：

### Step 1：用縣市＋鄉鎮＋段名反查地段代碼

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~cadastral-sections/records?縣市名稱=臺北市&鄉鎮名稱=松山區&q=西松&是否現行=true"
```

段名會跨縣市重複（多地有同名段），務必帶 `縣市名稱`／`鄉鎮名稱` 確認後，取出 `地段代碼`（如 `AD01-0600`）。

### Step 2：拿地段代碼去查土地資料

把 Step 1 取得的地段代碼帶入實價登錄等以地段／地號定位的資料查。本表只到地段層、不含地號與交易明細，後續資料需查對應資料集。

---

## API 呼叫範例

> 以下為各自獨立的查法，無先後關係。

### 範例 1：由地段代碼 decode 成地段名稱與階層

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~cadastral-sections/records?地段代碼=AD01-0600"
```

回應自帶 `地段名稱` 與 `縣市名稱`／`鄉鎮名稱`／`事務所名稱`，不必再查上層表即可解讀（地段代碼 `AD01-0600`：首碼 `A`＝縣市、前 2 碼 `AD`＝事務所、前 4 碼 `AD01`＝鄉鎮）。

### 範例 2：列出某鄉鎮的現行地段

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~cadastral-sections/records?縣市名稱=臺北市&鄉鎮名稱=松山區&是否現行=true&per_page=100"
```

### 分頁查詢

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~cadastral-sections/records?page=1&per_page=20"
```

---

## 注意事項與限制

1. **只到地段層、不含地號**：本表是地段對照，不含個別地號或土地交易資料。
2. **含已註銷段**：只要現行段請加 `?是否現行=true`。
3. **段名會跨縣市重複**：用 `縣市名稱`／`鄉鎮名稱` 縮小範圍再取代碼。
4. **「跨越」段**：同名段在不同鄉鎮**各有一筆獨立紀錄**（前 4 碼鄉鎮代碼不同、後 4 碼段號相同，`備註=跨越`），真實地號通常只屬其中一個鄉鎮（詳見 knowledge.md）。
6. **`備註` 不是 filter 欄位**：不能 `?備註=跨越` 或 `agg?group_by=備註`，要找特定異動類型請改用 `q=` 搜段名後 client-side 過濾。
5. **地段代碼查不到時**：手上的（舊）代碼可能已重編，改查 [`cadastral-sections-mapping`](../tw.gov.moi.land~ref~cadastral-sections-mapping/skill.md) 的 `舊地段代碼` 取得新代碼。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~cadastral-sections/records` |
| Agg URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~cadastral-sections/agg` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | 免費申請：https://data.openfun.tw/user |
| 精確篩選 | `?地段代碼=AD01-0600`、`?縣市名稱=臺北市`、`?鄉鎮名稱=松山區`、`?事務所名稱=松山地政事務所`、`?是否現行=true` |
| 全文搜尋 | `?q=西松`（段名） |
| 分頁 | `?page=1&per_page=20` |