---
reviewed_by:
  rd:
  pm: James
---
# 地方政府預算 — `tw.openfun~bulk~budget-local`

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

---

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

資料形式：**Google Sheets 公開試算表，直接下載 CSV 使用，無需帳號或 API Token。**

試算表網址：https://docs.google.com/spreadsheets/d/10tIve836nK74oMcxVknwc5SWHgMdY4URHm2QXBxVhrc/

禁止抓取 HTML 頁面（試算表頁面有 bot 保護），請只使用下方提供的 CSV 匯出 URL。

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／各縣市主計」

**回應使用者時須附原始單筆查詢 URL** — 讓使用者可驗證 agent 回答內容：
將紀錄之 `縣市` 與 `年度` 值代入：`https://budget.openfun.app/budget/show/{縣市}/{年度}`
例：紀錄 `縣市=臺北市, 年度=115` → `https://budget.openfun.app/budget/show/臺北市/115`（頁面含 treemap 視覺化 + 全細項表 + Search/Filter，可在頁面找特定機關／計畫／科目驗證）

> **中央政府預算**請參考 [`tw.openfun~bulk~budget-central`](../tw.openfun~bulk~budget-central/skill.md)。

---

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

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

- 「臺北市 114 年度的教育支出預算是多少？」
- 「各縣市歷年社福預算的趨勢為何？」
- 「哪些縣市的決算超過法定預算（超徵）？」
- 「南投縣的歲入主要來源有哪些？」
- 「各縣市在特定業務計劃的預算規模比較」

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

- 「中央政府的預算」→ 請用 [`tw.openfun~bulk~budget-central`](../tw.openfun~bulk~budget-central/skill.md)
- 「特定預算項目的逐筆支出明細」（只到科目層級）
- 「所有縣市完整資料」（目前涵蓋 19 個縣市，部分縣市資料可能不完整）

### ⚠️ 資料粒度限制：搜尋不到具體活動是正常的

**資料最細只到「工作計劃」層級**，不包含活動、措施、業務名稱等細項。

常見使用者問的概念**不會直接出現在欄位中**，例如：
- 「廚餘」→ 不是獨立科目，屬於「資源回收業務」或「廢棄物處理及再利用業務」
- 「路燈」→ 屬於「道路養護業務」或「照明設備維護」
- 「太陽能板」→ 屬於「節能減碳」或「建築及設備業務」

**遇到這類概念查詢的正確做法：**
1. 先用關鍵字搜尋（`str.contains`）找相關工作計劃或業務計劃名稱
2. 如果直接搜尋關鍵字為 0 筆，換想「這件事屬於哪個政府業務？」（環保 / 交通 / 衛生 / 教育 / 建設）
3. 先列出該機關（如環保局）所有業務計劃，再從中判斷哪些與使用者問的概念相關
4. 不要重複下載同一份 CSV，一次載入後反覆篩選

```python
import pandas as pd

# 一次載入，反覆使用
url = "https://docs.google.com/spreadsheets/d/10tIve836nK74oMcxVknwc5SWHgMdY4URHm2QXBxVhrc/export?format=csv&gid=0"
df = pd.read_csv(url)
for col in ['預算案', '法定預算', '決算']:
    df[col] = pd.to_numeric(df[col].astype(str).str.replace(',', ''), errors='coerce')

# 搜尋不到時，先列出相關機關的所有工作計劃
agency_plans = df[(df['縣市'] == '臺中市') & (df['機關名'].str.contains('環保', na=False))]['名稱'].unique()
print(agency_plans)  # 看看有哪些工作計劃，再決定要查哪個
```

---

## 涵蓋縣市與年份範圍

各縣市資料係分開收集，年份覆蓋差異較大：

| 縣市 | 歲出年份範圍 |
|------|------------|
| 臺南市 | 民國 98–115（18 年，最完整） |
| 臺北市 | 民國 106–115（10 年） |
| 基隆市 | 民國 104–114（11 年） |
| 桃園市、臺中市、雲林縣、高雄市 | 民國 110–115（6 年） |
| 南投縣 | 民國 111–115（5 年） |
| 嘉義市 | 民國 110–113（4 年） |
| 其餘縣市（嘉義縣、屏東縣、新北市、新竹市、新竹縣、臺東縣、花蓮縣、苗栗縣、連江縣、金門縣） | 民國 110–114（5 年） |

> 歲入年份範圍與歲出大致相同，臺南市歲入自民國 102 年起。

**使用前請注意**：跨縣市比較歷年趨勢時，需確認各縣市是否均有該年份資料，避免因資料缺漏產生誤判。

---

## 四個資料表說明

| 資料表 | 類型 | 年份範圍 | 列數 | 下載 URL |
|--------|------|---------|------|---------|
| 業務計劃 | 歲出（支出） | 各縣市不同（最早民國 98） | 約 30,000 | [CSV](https://docs.google.com/spreadsheets/d/10tIve836nK74oMcxVknwc5SWHgMdY4URHm2QXBxVhrc/export?format=csv&gid=469854288) |
| 工作計劃 | 歲出（支出） | 各縣市不同（最早民國 98） | 約 37,000 | [CSV](https://docs.google.com/spreadsheets/d/10tIve836nK74oMcxVknwc5SWHgMdY4URHm2QXBxVhrc/export?format=csv&gid=0) |
| 歲入子目 | 歲入（收入） | 各縣市不同（最早民國 102） | 約 40,000 | [CSV](https://docs.google.com/spreadsheets/d/10tIve836nK74oMcxVknwc5SWHgMdY4URHm2QXBxVhrc/export?format=csv&gid=1340531824) |
| 歲入細目 | 歲入（收入） | 各縣市不同（最早民國 102） | 約 57,000 | [CSV](https://docs.google.com/spreadsheets/d/10tIve836nK74oMcxVknwc5SWHgMdY4URHm2QXBxVhrc/export?format=csv&gid=1578529706) |

**選哪個表？**
- 查歲出（支出）→ 用「業務計劃」（概覽）或「工作計劃」（明細）
- 查歲入（收入）→ 用「歲入子目」（概覽）或「歲入細目」（明細）

---

## 欄位說明

### 共用欄位（四個資料表均有）

| 欄位名稱 | 說明 | 範例 |
|---------|------|------|
| `縣市` | 縣市名稱 | `臺北市`、`高雄市`、`南投縣` |
| `編號` | 預算科目編號 | `33010010101` |
| `主管機關` | 主管機關名稱（含「主管」二字） | `縣議會主管`、`教育局主管` |
| `機關名` | 執行機關名稱 | `南投縣議會`、`臺北市教育局` |
| `名稱` | 預算項目名稱 | `行政管理`、`一般行政` |
| `年` | 民國年份 | `114`（= 西元 2025 年） |
| `預算案` | 行政機關送議會審議的金額（千元） | `109,190` |
| `法定預算` | 議會通過的法定預算金額（千元） | `105,470` |
| `決算` | 實際執行決算金額（千元），次年公布 | `104,584` |
| `預算差異` | 法定預算 − 預算案 | `0` |
| `決算差異` | 決算 − 法定預算 | （負值代表執行不足） |
| `與去年差異` | 本年法定預算 − 上年法定預算 | `886` |

### 業務計劃 專有欄位

| 欄位名稱 | 說明 | 範例 |
|---------|------|------|
| `政事別` | 政事分類 | `立法支出`、`教育科學文化支出` |

### 工作計劃 專有欄位

| 欄位名稱 | 說明 | 範例 |
|---------|------|------|
| `業務計劃` | 上層業務計劃名稱 | `一般行政`、`研究發展` |
| `政事別` | 政事分類 | `立法支出` |

### 歲入子目 專有欄位

| 欄位名稱 | 說明 | 範例 |
|---------|------|------|
| `歲入來源` | 收入來源大類 | `稅課收入`、`罰款及賠償收入` |

### 歲入細目 專有欄位

| 欄位名稱 | 說明 | 範例 |
|---------|------|------|
| `來源` | 收入來源大類 | `稅課收入` |
| `子目` | 子目名稱（上一層分類） | `地價稅`、`房屋稅` |

---

## 使用範例

### Python（pandas）載入並分析

```python
import pandas as pd

# 載入歲出業務計劃資料
url = "https://docs.google.com/spreadsheets/d/10tIve836nK74oMcxVknwc5SWHgMdY4URHm2QXBxVhrc/export?format=csv&gid=469854288"
df = pd.read_csv(url)

# 金額欄位去除千分位逗號，轉為數值
for col in ['預算案', '法定預算', '決算', '預算差異', '決算差異', '與去年差異']:
    df[col] = pd.to_numeric(df[col].astype(str).str.replace(',', ''), errors='coerce')

# 過濾有效年份（民國 90–115）
df = df[df['年'].astype(str).str.isdigit()]
df['年'] = df['年'].astype(int)
df = df[df['年'].between(90, 115)]

# 查詢臺北市 114 年各業務計劃的法定預算
result = df[(df['縣市'] == '臺北市') & (df['年'] == 114)]
print(result[['政事別', '機關名', '名稱', '法定預算']].sort_values('法定預算', ascending=False).head(20))
```

### 各縣市歷年社福預算比較

```python
# 篩選社會福利支出
welfare = df[df['政事別'].str.contains('社會福利', na=False)]
# 各縣市各年法定預算合計（單位：千元）
summary = welfare.groupby(['縣市', '年'])['法定預算'].sum().unstack()
print(summary)
```

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.openfun~bulk~budget-central`](../tw.openfun~bulk~budget-central/skill.md) | 中央政府預算統計（Google Sheets CSV） | 查中央各部會預算，格式與本資料集相同但無 `縣市` 欄位 |
| [`tw.openfun~bulk~budget-detail`](../tw.openfun~bulk~budget-detail/skill.md) | 政府預算詳情（靜態 CSV/JSON） | 需要計畫內容文字、用途別明細、調整後預算，或需要宜蘭縣、彰化縣、澎湖縣資料時使用 |

---

## 注意事項

1. **金額單位為千元**：欄位值 `109,190` 代表新台幣 1億 919萬元。
2. **年份為民國年**：`年=114` 對應西元 2025 年。歲出資料最早自民國 99 年，歲入自民國 90 年。
3. **最近年度決算為空**：決算於次年公布，115 年（2026）的決算欄通常為空。
4. **金額含逗號**：CSV 下載後金額欄位含千分位逗號（如 `109,190`），使用前需先轉換為數值。
5. **少數列格式異常**：歲入資料有少數列（約 800–1,100 列）的年份欄位為空或格式錯誤，載入後請過濾 `年` 欄位為有效民國年份（90–115 的整數）。
6. **縣市覆蓋不完整**：目前涵蓋 19 個縣市，部分縣市（如宜蘭縣、彰化縣、澎湖縣）資料尚未收錄。
7. **地方 vs 中央**：地方政府收支與中央政府分開，不可加總（地方補助款計算方式不同）。

---

## 資料來源與更新頻率

| 項目 | 說明 |
|------|------|
| 原始資料 | 立法院預決算知識庫 |
| 整理來源 | 歐噴資料庫（data.openfun.tw） |
| 涵蓋縣市 | 19 個縣市 |
| 歲出年份 | 民國 99–115 年（西元 2010–2026 年） |
| 歲入年份 | 民國 90–115 年（西元 2001–2026 年） |
| 更新頻率 | 每年（預算通過後，約 1–2 月） |
| 格式 | Google Sheets 公開試算表，可直接匯出 CSV |

---

## 快速參考

| 項目 | 說明 |
|------|------|
| 資料形式 | Google Sheets 公開試算表，免帳號直接下載 CSV |
| 業務計劃 CSV | `...export?format=csv&gid=469854288` |
| 工作計劃 CSV | `...export?format=csv&gid=0` |
| 歲入子目 CSV | `...export?format=csv&gid=1340531824` |
| 歲入細目 CSV | `...export?format=csv&gid=1578529706` |
| 涵蓋縣市 | 19 個縣市（缺宜蘭縣、彰化縣、澎湖縣） |
| 年份 | 各縣市不同，最早民國 98 年（臺南市），多數約 5–6 年 |
| 金額單位 | 千元，含千分位逗號，使用前需轉換 |
| 唯一識別碼 | `{縣市}_{編號}_{年}` 組合 |
| 載入方式 | `pd.read_csv(url)` 直接讀取，無需 Token |
| 年份過濾 | 歲入有少數列年份格式異常，需過濾 `年` 為 90–115 的整數 |