---
reviewed_by:
  rd: tmonk
  pm:
---
# 實價登錄（停車場附表）— `tw.gov.moi.land~ref~plvr-park`

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

---

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

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

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

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

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

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

---

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

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

- 「這筆交易（編號 XXXXX）包含幾個車位？各是什麼類型？」
- 「這筆交易的車位面積各是多少？」
- 「全台坡道平面車位的交易量有多少筆？」

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

- 「這個車位賣了多少錢？」（多數記錄 `車位價格` 為 0，價格包含在主表總價）
- 「台北市的車位行情是多少？」（本表無縣市欄位，需 JOIN 主表）
- 「某停車場有幾個車位？」（本表只記錄成交交易中的車位，非停車場整體）

---

## 資料來源與更新頻率

| 項目 | 說明 |
|------|------|
| 原始來源 | 行政院內政部地政司（[實價登錄開放資料下載](https://plvr.land.moi.gov.tw/DownloadOpenData)） |
| 授權 | 政府資料開放授權條款－第1版 |
| 更新頻率 | 每週更新 |
| 總筆數 | 約 253 萬筆（2026-05-28） |

---

## 關聯主表的方式

本資料集為主表 `tw.gov.moi.land~ref~plvr` 的**一對多附表**。

- 主表的 `編號` = 本表的 `編號`
- 本表的 `id` = `{編號}-{序號}`，例如 `RPWPMLSKQHKFFCA56CC-1`
- 查詢流程：先用主表取得目標交易的 `編號`，再用 `?編號=XXXXX` 查本表取車位明細

---

## 欄位說明

> `filter: true` 的欄位支援精確篩選（`?欄位名稱=值`）。

| 欄位名稱（API 參數） | 型別 | 說明 |
|---------------------|------|------|
| `id` | keyword（_id） | 實價登錄交易編號 + 序號 |
| `編號` | keyword（ref: tw.gov.moi.land~ref~plvr） | 對應實價登錄交易編號 |
| `車位類別` | keyword（篩選器） |  |
| `車位價格` | number |  |
| `車位面積平方公尺` | number |  |
| `車位所在樓層` | text |  |

| 欄位名稱 | 型別 | filter | 說明 |
|---------|------|--------|------|
| `id` | keyword | — | 唯一識別碼，格式 `{編號}-{序號}` |
| `編號` | keyword | — | 對應主表（`tw.gov.moi.land~ref~plvr`）的 `編號` 欄位 |
| `車位類別` | keyword | ✅ | `坡道平面`、`坡道機械`、`一樓平面`、`升降機械`、`升降平面`、`塔式車位`、`其他` |
| `車位價格` | number | — | 個別車位價格（元）；**多數為 0**，代表已包含在主表總價中 |
| `車位面積平方公尺` | number | — | 車位面積（㎡）；部分為空值 |
| `車位所在樓層` | text | — | 車位樓層；多數為空字串 |

---

## API 呼叫範例

**Records URL：** `https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~plvr-park/records`

### 範例 1：查詢某筆交易的所有車位明細

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~plvr-park/records?編號=RPWPMLSKQHKFFCA56CC"
```

用途：取得特定交易的所有車位記錄。`編號` 從主表取得。

---

### 範例 2：篩選特定車位類別

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~plvr-park/records?車位類別=坡道平面&per_page=20"
```

用途：取得坡道平面車位的交易記錄。

---

### 分頁查詢

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~plvr-park/records?page=2&per_page=50"
```

回應中 `"total"` 欄位是符合條件的總筆數。

---

## 統計聚合（/agg 端點）

**Agg URL：** `https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~plvr-park/agg`

可分組的欄位：`車位類別`

### 各車位類別筆數分布

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~plvr-park/agg?group_by=車位類別"
```

回應格式：
```json
{
  "total_records": 2530960,
  "total_groups": 8,
  "groups": [
    { "key": "坡道平面", "stats": { "count": 2088974 } },
    { "key": "坡道機械", "stats": { "count": 226396 } }
  ]
}
```

---

## 注意事項與限制

1. **`車位價格` 多數為 0**：車位價格通常未單獨揭露，包含在主表 `總價(額)元` 中。本表 `車位價格` 為 0 不代表車位免費。
2. **本表無縣市欄位**：無法單獨依縣市篩選，需搭配主表 JOIN 使用。
3. **主表也有車位彙總欄位**：主表的 `車位類別`、`車位(移轉)總面積平方公尺`、`車位總價(額)元` 記錄整筆交易車位的彙總，本附表提供多車位交易的逐筆明細。
4. **面積單位為平方公尺（㎡）**：換算坪數請除以 3.3058。

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| `tw.gov.moi.land~ref~plvr` | 主表 | 透過 `編號` JOIN，取得交易價格、地址、縣市、類型等資訊；含車位彙總欄位 |
| `tw.gov.moi.land~ref~plvr-build` | 建物附表 | 同一交易的建物移轉明細 |
| `tw.gov.moi.land~ref~plvr-land` | 土地附表 | 同一交易的土地移轉明細 |

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~plvr-park/records` |
| Agg URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.moi.land~ref~plvr-park/agg` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | https://data.openfun.tw/user |
| Records 回應格式 | JSON，含 `total`、`page`、`per_page`、`records[]` |
| Agg 回應格式 | JSON，含 `total_records`、`total_groups`、`groups[].key`、`groups[].stats.count` |
| 依交易查車位 | `?編號=XXXXX`（從主表取得 `編號`） |
| 車位類別篩選 | `?車位類別=坡道平面`（filter: true） |
| 分頁 | `?page=1&per_page=20`（預設 page=1, per_page=20） |
| 面積換算 | 1 坪 ≈ 3.3058 ㎡ |