reviewed_by: rd: tmonk pm: James
立法委員個人編號對照表（tw.gov.ly~ref~legislator-bioid）
版本：2026-05 最後更新：2026-05-29 維護：歐噴資料（data.openfun.tw） 授權：CC-BY 4.0 International 原始資料授權：OGDL-Taiwan-1.0
資料集概述
本資料集是立法委員跨屆唯一識別碼（bioId）與最新姓名的對照表，共 772 筆。每筆記錄代表一位曾任立法委員，不論任職幾屆都只有一筆。主要用途是作為 tw.gov.ly~ref~legislator-by-term-name（歷屆名單）的關聯表，透過 bioId 跨屆識別同一位委員。
資料來源
| 項目 | 說明 |
|---|---|
| 原始來源 | 立法院（資料集頁面） |
| 原始授權 | OGDL-Taiwan-1.0 |
| 歐噴取得方式 | 從 tw.gov.ly~ref~legislator-by-term-name 衍生，每位委員取最新屆次姓名 |
| 更新頻率 | 每日（與歷屆名單同步） |
| 涵蓋範圍 | 第 2 屆至第 11 屆所有曾任立委，共 772 位 |
資料特性與限制
資料結構
每筆記錄只有兩個欄位：bioId（委員唯一識別碼）和 latestName（最新屆次的姓名）。沒有黨籍、選區、屆次等詳細資訊，這些需查 tw.gov.ly~ref~legislator-by-term-name。
主要用途
作為跨資料集的關聯鍵。tw.gov.ly~ref~legislator-by-term-name 的每筆記錄都有 bioId 欄位，指向本資料集。當需要「這個 bioId 對應的委員叫什麼名字」時，可查本資料集。
latestName 的語意
latestName 是該委員最新服務屆次的姓名。少數委員歷年有改名，較早屆的姓名記錄在歷屆名單（name 欄位），本資料集只保留最新姓名。
無法做統計聚合
兩個欄位均無 filter: true，無法使用 /agg 端點做分組統計。
欄位說明
bioId
委員個人唯一識別碼，跨屆固定不變。字串型別（keyword）。同時也是記錄的 _id，可用於直接查單筆（/records/{bioId}）。
latestName
委員最新屆期的中文姓名。文字型別（text），支援全文搜尋。
更新頻率與版本記錄
| 版本 | 更新日期 | 說明 |
|---|---|---|
| 初版 | 2026-05-29 | 建立知識文件（依 API 實際資料格式與查詢驗證） |
相關資料集
| 資料集 | 說明 | 關聯 |
|---|---|---|
tw.gov.ly~ref~legislator-by-term-name |
委員歷屆任職記錄 | 每筆記錄的 bioId 欄位指向本資料集；詳細任職資訊的主要來源 |
使用範例
已知 bioId，查委員姓名
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-bioid/records/22"已知姓名，反查 bioId
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.ly~ref~legislator-bioid/records?q=王金平"AI 使用指引
AI agent 使用指引（含 bioId ↔ 姓名查詢流程、與歷屆名單搭配使用方式）見 skill.md。