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

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

---

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

資料集 slug：tw.gov.moi.land~ref~cadastral-sections-mapping
API 端點：https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~cadastral-sections-mapping/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-mapping/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版 |
| 更新頻率 | 不定期 |
| 涵蓋範圍 | 有異動記錄的地段（含舊＝新的現況列） |

---

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

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

- 「這個舊地段代碼現在對應到哪個新代碼？」
- 「某地段是否曾因段重編／事務所改制而換代碼？」
- 「把歷史土地資料的舊地段代碼轉成現行代碼」

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

- 「地段現在的完整資訊（是否現行、小段）」（轉得新代碼後查 `cadastral-sections`）
- 「異動的日期、原因細節」（本表僅有代碼對照與簡略備註）

---

## 欄位說明

| 欄位名稱（API 參數） | 型別 | 說明 |
|---------------------|------|------|
| `識別碼` | keyword（_id） | 舊地段代碼_新地段代碼_備註 |
| `地段名稱` | text（_name） | 段+小段 |
| `地段名稱.段` | keyword | 段 |
| `地段名稱.小段` | keyword | 小段 |
| `縣市` | keyword（篩選器） | 縣市名稱 |
| `事務所` | keyword（篩選器） | 事務所名稱 |
| `區名` | keyword（篩選器） | 鄉鎮市區名稱 |
| `舊地段代碼` | keyword（ref: tw.gov.moi.land~ref~cadastral-sections） | 異動前地段代碼 |
| `新地段代碼` | keyword（ref: tw.gov.moi.land~ref~cadastral-sections） | 異動後地段代碼 |
| `舊所碼` | keyword（ref: tw.gov.moi.land~ref~cadastral-offices） | 異動前事務所代碼 |
| `新所碼` | keyword（ref: tw.gov.moi.land~ref~cadastral-offices） | 異動後事務所代碼 |
| `舊區碼` | keyword | 異動前鄉鎮代碼後 2 碼 |
| `新區碼` | keyword | 異動後鄉鎮代碼後 2 碼 |
| `舊段代碼` | keyword | 異動前段代碼 |
| `新編段碼` | keyword | 異動後段代碼 |
| `備註` | text | 異動類型 |

16 個欄位由上方 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-mapping/records?舊地段代碼=BA02-0065"
```

取回應中的 `新地段代碼`（若 `新地段代碼` 與舊碼相同，代表沒換過）。

### Step 2：用新代碼回地段表查現況

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

---

## API 呼叫範例

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

### 範例：找某地區真正有異動的地段

```bash
# 依縣市／事務所／區名縮小，再於結果中挑出 舊地段代碼 ≠ 新地段代碼 的列
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~cadastral-sections-mapping/records?縣市=臺中市&區名=中區&per_page=100"
```

> 部分列 `舊地段代碼` 與 `新地段代碼` 相同（現況列、無實際異動），需自行過濾出兩者不同的列才是真正的代碼變更。

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.moi.land~ref~cadastral-sections`](../tw.gov.moi.land~ref~cadastral-sections/skill.md) | 地段代碼主表 | 轉得新代碼後查地段現況 |
| [`tw.gov.moi.land~ref~cadastral-offices`](../tw.gov.moi.land~ref~cadastral-offices/skill.md) | 事務所代碼 | 解讀舊所碼／新所碼 |

---

## 注意事項與限制

1. **舊＝新 ≠ 有異動**：兩代碼相同的列只是現況，要找真正變更請過濾 `舊地段代碼 ≠ 新地段代碼`。
2. 本表只有代碼對照與簡略 `備註`，無異動日期等細節。
3. 轉得新代碼後，地段是否現行、小段等資訊需查 `cadastral-sections`。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~cadastral-sections-mapping/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | 免費申請：https://data.openfun.tw/user |
| 精確篩選 | `?舊地段代碼=...`、`?新地段代碼=...`、`?縣市=臺中市`、`?事務所=中山`、`?區名=中區` |
| 全文搜尋 | `?q=繼光`（段名） |
| 分頁 | `?page=1&per_page=20` |