方法論
數字如何從 UNHCR、IDMC 與聯合國人口司來到這張地圖 — 以及它們代表什麼、不代表什麼。
1. 資料來源
本站呈現的一切都是國際組織公開發布的群體層級統計。本站永不處理個人層級資料。
| 用途 | 來源 | 端點/檔案 | 授權 | 資料截至 |
|---|---|---|---|---|
| 各國歷年存量（難民、庇護申請者、IDP、無國籍者、其他受關注者、回返者、OIP） | UNHCR Refugee Population Statistics Database | api.unhcr.org/population/v1/population/ （庇護國、來源國、雙邊矩陣）, /footnotes/ | CC-BY-4.0 | 2025-12-31 |
| 年齡與性別 | UNHCR | /demographics/（2010 起，庇護國） | CC BY 4.0 | 2025-12-31 |
| 持久解決方案、庇護申請 | UNHCR | /solutions/ (2000+), /asylum-applications/ （2015 起，僅以人數計） | CC BY 4.0 | 2025-12-31 |
| 境內流離失所（年度存量） | IDMC（經 UNHCR） | /idmc/ (2009+) | CC BY-IGO | 2025-12-31 |
| 近期流離失所事件（延遲 ≤ 24 小時） | IDMC Internal Displacement Updates | Helix API，近 180 天 | CC BY-IGO | 2026-10-02 |
| 「最新估計」卡片 | UNHCR 即時推估 | /nowcasting/ — 統計推估，明確標示為估計 | CC BY 4.0 | 2026-08-01 |
| 居民人口（每千人分母） | UN DESA World Population Prospects 2024 | WPP2024_TotalPopulationBySex.csv，中推計 | CC BY 3.0 IGO | 2023-07-01（估計基準年；其後年份為中推計預測值） |
| 邊界 | Natural Earth 1:50m （經 world-atlas） | 簡化後的 TopoJSON | 公有領域 | — |
各來源的完整出處（端點、內容雜湊、擷取時間、注意事項）以機器可讀形式存於 sources.json。未採用：ACLED（授權禁止儀表板再發布）、IOM DTM（授權未確認）、UNHCR Operational Data Portal 與微資料（非商業條款）。
2. 這些數字是什麼、不是什麼
- 它們是各國政府與 UNHCR 行動「報告」的數字。國家有高報或低報的誘因——籌款訴求、主權主張、具爭議的法律身分。缺漏不代表沒有流離失所者；灰色不代表零。
- 各國、各年度的涵蓋範圍與定義並不一致；跨年比較請留意定義變動（如 OIP 自 2018 年起）。
- IDP 數字僅涵蓋衝突與暴力（IDMC）；年度存量不含災害所致的流離失所。
- 即時推估與 IDU 為估計/初步數字，明確標示，永不混入年度序列。
- 上色需要多邊形：少數統計對象（如馬提尼克、直布羅陀、「無國籍」「來源不明」）沒有可繪製的邊界，列於圖例並仍計入所有總計、表格與下載。
- UNHCR 數字不含 UNRWA 職權下的巴勒斯坦難民（約 600 萬），UNRWA 另有統計。
3. 資料管線：每日、靜態、可稽核
- 擷取 — 排程作業呼叫 UNHCR API（限流：並發 2、間隔 ≥ 300 ms、指數退避重試），並下載 WPP CSV 與 IDMC IDU。最新已發布年份自動偵測（目前為 2025）。
- 正規化 — 每一列以 ISO 3166-1 alpha-3（讀取 UNHCR 的
coo_iso/coa_iso欄位）為鍵。絕不使用 UNHCR 內部碼（coo/coa）：它們與真實 ISO3 碰撞（UNHCR 的「AUS」是奧地利、「ARE」是埃及、「MAR」是馬提尼克）。數值欄位的"-"（未報告）、"0"與數字分別轉為null/0/ 整數。 - 驗證 — 發布前須通過 18 條資料不變量（自動化檢查合計 24 項），包括：三組碰撞碼正確歸屬；無負值或非有限值；每個指標、每一年皆滿足可上色總和 + 無法顯示總和 = 全球總計；來源國×庇護國雙邊矩陣的行列加總與各國邊際總計一致；年度總計與前一快照差異不超過 20%；三個黃金數字（土耳其 2024 難民、敘利亞 2016 IDP、全球 2024 難民）誤差須在 1% 內。
- 晉升 — 各來源獨立晉升。任一來源失敗即保留其前一份快照，網站顯示「部分資料更新延遲」；連續三天失敗會寄送告警。
- 發布 — 資料檔提交至版本控制（逐日稽核軌跡），並按季以束包存入 Zenodo（DOI 永久公開，任何人可逐位元組驗證歷史快照），再以靜態檔案部署。瀏覽器永不直接呼叫上游 API。
4. 定義
- 難民
- 依 1951 年《難民地位公約》/1967 年議定書、1969 年《非洲統一組織公約》或 UNHCR 章程被認定為難民者，以及獲得補充性/輔助性保護或臨時保護者；含「類難民處境」人口。不含 UNRWA 職權下的巴勒斯坦難民。
- 年末存量（12 月 31 日）。
- 不含約 600 萬 UNRWA 登記的巴勒斯坦難民。
- 庇護申請者
- 已提出國際保護申請、但難民身分尚待決定者（待審個案）。
- 年末待審個案，以人數計。
- 境內流離失所者（IDP）
- 因衝突或暴力而在本國境內流離失所者（由 IDMC 彙整、UNHCR 轉載）。計入其本國（來源國=收容國）。
- 來源：IDMC（經 UNHCR）。不含災害所致的流離失所。
- 兩種視角下數字相同（境內流離失所沒有收容國）。
- 無國籍者
- 依任何國家法律皆不被視為其國民者，含國籍未定者。
- 僅按居住國報告；許多國家未報告。
- 其他受關注者
- 不直接屬於其他類別、但獲 UNHCR 延伸保護或協助者。
- 回返難民
- 於該年度內自行或經安排返回來源國的前難民。
- 年度流量，非存量。
- 回返境內流離失所者
- 於該年度內返回原居地的前境內流離失所者。
- 年度流量，非存量。
- 其他需要國際保護者
- 身在來源國境外、很可能需要國際保護、但身分尚未確定者（2018 年起使用，主要為境外委內瑞拉人）。
- 自 2018 年起報告；多為流落境外的委內瑞拉人。
- 接待社區
- 受惠於 UNHCR 方案的收容社區成員（僅少數行動報告）。
- 非流離失所人口；不計入總數。
- 受關注者總數
- 難民、庇護申請者、境內流離失所者、無國籍者、其他受關注者與其他需要國際保護者之總和（不含收容社區與回返者）。
- 由前端自各元件指標加總；僅當至少一個元件有報告時，null 元件才視為 0。
- 本站加總可能與 UNHCR 自行發布的整體數字（如《全球趨勢》報告）略有出入——UNHCR 採用其自身的彙整規則。
所有存量皆為年末（12 月 31 日）數字；「回返」為年度流量。
「被迫流離失所」與「受關注人口」不是同一件事
受關注人口（total_poc）是 UNHCR 的保護職責範圍，不是流離失所的定義。它包含無國籍者（按居住國計算，不必然離開過家園）與其他受關注者（無流離失所定義的剩餘類別)。兩者合計約占總數的 6%。
因此本站凡是寫「被迫流離失所」的數字——包括首頁「每 N 人中有 1 人」那一句——一律只由難民 + 庇護申請者 + 境內流離失所者 + OIP四項相加,與 UNHCR 自己認定為強制流離的人口群一致。收容社區與回返者從不計入。
更正紀錄:2026-09-05 之前,該句誤用 total_poc 為分子,數字約高出 6%。此後由FORCED_DISPLACEMENT_COMPONENTS 單一定義,並由資料驗證第 17 條不變量在每次發布前檢查。
有些指標只存在於一個視角
無國籍者與收容社區只有「他們現在在哪裡」的讀數。 無國籍者按居住國報告——一個從未被任何國家承認為國民的人,沒有「來源國」可言; 收容社區計算的則是本來就住在當地的人。上游檔案在兩個視角放同一個數字, 但那不代表它在來源國視角下有意義。
因此這兩個指標在「他們從哪裡逃離」下不再提供:指標選單不列出、網址若指定會被更正、 國家頁該欄顯示為未報告,而受關注人口總數在來源國視角下也會扣掉無國籍者(2025 年為 4,477,220 人)。
更正紀錄:此規則在 metrics.json 早有定義,但 2026-09-05 之前程式沒有任何地方讀取它——?m=stateless&v=origin會把居住國數字放在來源國標題下。現在由 METRIC_VIEWS單一規則控制,並由不變量第 18 條檢查其與 metrics.json 一致。
5. 未報告不等於零
UNHCR 區分未報告（"-"）與報告為零。本站全程保留這個區別：地圖上（灰色 vs 最淺的沙色）、圖表中（折線中斷 vs 落到零）、CSV（空欄位 vs 0）與 JSON（null vs 0）。灰色國家可能收容許多流離失所者，只是該年度未報告。
6. 兩種視角：現居地與來源地
每個數字都有兩種地理歸屬。庇護國（「他們現在在哪裡」）按人們目前所在的國家計數；來源國（「他們從哪裡逃離」）按人們離開的國家計數。境內流離失所者在兩種視角中都計入其本國。「流向」分頁與 flows/ 檔案提供雙邊矩陣。
7. 每千人
比率 = 人數 ÷ UN WPP 年中總人口 × 1,000。兩點注意：分子是 12 月 31 日的存量、分母是 7 月 1 日的人口；缺人口資料時不顯示比率。
估計值與預測值的分界：WPP 2024 中，1950–2023 年為估計值（依人口普查、調查、登記與官方統計重建而得）；2024 年 1 月 1 日起至 2100 年為預測值，由統計預測模型與人口假設推導。本站在地圖切換至每千人、且所選年份落在預測區間時，會直接於圖例顯示提示。此一分界與署名寫法已向 UN DESA 人口司查證確認（2026-08-28）。欲檢視各國估計值背後的實證來源，可查WPP 資料來源頁、方法文件資料夾，或以UN 人口司資料入口（提供開放 API 與底層實證資料點）逐一核對。
8. 色階
全站使用大地色連續色階（ColorBrewer YlOrBr：沙 → 赭 → 耕土的深褐），七個級距，色盲友善。原則不變：不把流離失所者在視覺上呈現為「威脅」——因此全站刻意沒有任何紅色，最深一級是土壤的褐，而非警報色；流向也以弧線而非箭頭呈現。選擇大地色是一個明確的設計主張：荒漠與土壤，是人們所跨越、也所失去的東西。此設計於 2026-08-25 取代早期版本的單色藍階（變更有紀錄可查），並由自動化測試守護：色階必須為暖土色系、逐級變暗，任何改為警報紅的嘗試都會使建置失敗。分級預設為分位數，且跨全部年份計算（針對目前顯示的國家）：拖動時間軸時顏色代表「量級」而非每年重排的「名次」，不同年份的截圖可以互相比較。零有自己的最淺色；未報告為灰色。
9. 邊界與名稱
邊界取自 Natural Earth，經簡化以利顯示。國名跟隨被引用的資料來源（UNHCR），另有小型覆寫表以利閱讀（如「Syrian Arab Rep.」→「敘利亞」）；原始名稱一律並列。爭議地區、科索沃與台灣皆有明確處理——詳見邊界、名稱與爭議地區。
10. 更新頻率與故障處理
UNHCR 約在每年 6 月發布上年度數字、10/11 月發布年中數字。管線每日執行，但只在內容變動時提交。三種時間戳嚴格分開：data_as_of（資料涵蓋到哪天）、retrieved_at（我們何時擷取——只在內容變動時前進）、資料集快照snapshot_id（整份資料的內容雜湊，目前為 f1a2b53a）。大宗 CSV 的 snapshot_id 欄位帶的是母體來源的內容雜湊前 8 碼，可經 sources.json 回溯驗證。
11. 即時事件層的處理原則
「近期境內流離失所事件」層轉載 IDMC 的初步事件估計。基於尊嚴與安全考量：衝突事件的座標一律對齊約 25 公里的網格（絕不標示到聚落層級）；少於 100 人的事件不單獨繪點；彈窗顯示數字、類型與日期，並連往 IDMC 的原始報告，而非轉貼敘述文字。此層的事件定義與年度 IDP 存量不同（後者不含災害）。
12. 引用
每個檢視都有固定連結，可重現年份、指標、視角、篩選、選取國家與地圖位置（分享與引用產生的連結會固定年份）。「引用」按鈕提供 APA 7、芝加哥（作者–年份）、BibTeX（@dataset，含 version）與「引用本頁」四種格式；出版年份採用資料年份而非點閱年份，並附上資料快照代碼以利精確回溯。請同時引用上游來源。
有疑問或指正：見 關於。