方法论

數字如何從 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-08-23
「最新估計」卡片	UNHCR 即時推估	`/nowcasting/` — 統計推估，明確標示為估計	CC BY 4.0	2026-06-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 / 整數。
驗證 — 發布前須通過 15 條不變量，包括：三組碰撞碼正確歸屬；無負值或非有限值；每個指標、每一年皆滿足可上色總和 + 無法顯示總和 = 全球總計；年度總計與前一快照差異不超過 20%；三個黃金數字（土耳其 2024 難民、敘利亞 2016 IDP、全球 2024 難民）誤差須在 1% 內。
晉升 — 各來源獨立晉升。任一來源失敗即保留其前一份快照，網站顯示「部分資料更新延遲」；連續三天失敗會寄送告警。
發布 — 資料檔提交至版本庫（永久稽核軌跡：git log -- public/data/v1/country/SYR.json 能回答「這個數字在某日的快照是多少」），再以靜態檔案部署。瀏覽器永不直接呼叫上游 API。

4. 定義

难民

依 1951 年《难民地位公约》/1967 年议定书、1969 年《非洲统一组织公约》或 UNHCR 章程被认定为难民者，以及获得补充性/辅助性保护或临时保护者；含「类难民处境」人口。不含 UNRWA 职权下的巴勒斯坦难民。

年末存量（12 月 31 日）。
不含约 600 万 UNRWA 登记的巴勒斯坦难民。

庇护申请者

已提出国际保护申请、但难民身份尚待决定者（待审个案）。

年末待审个案，以人数计。

境内流离失所者（IDP）

因冲突或暴力而在本国境内流离失所者（由 IDMC 汇总、UNHCR 转载）。计入其本国（来源国＝庇护国）。

来源：IDMC（经 UNHCR）。不含灾害所致的流离失所。
两种视角下数字相同（境内流离失所没有庇护国）。

无国籍者

依任何国家法律皆不被视为其国民者，含国籍未定者。

仅按居住国报告；许多国家未报告。

其他受关注者

不直接属于其他类别、但获 UNHCR 延伸保护或协助者。

回返难民

于该年度内自行或经安排返回来源国的前难民。

年度流量，非存量。

回返境内流离失所者

于该年度内返回原居地的前境内流离失所者。

年度流量，非存量。

其他需要国际保护者

身在来源国境外、很可能需要国际保护、但身份尚未确定者（2018 年起使用，主要为境外委内瑞拉人）。

自 2018 年起报告；多为流落境外的委内瑞拉人。

接待社区

受惠于 UNHCR 方案的接待社区成员（仅少数行动报告）。

非流离失所人口；不计入总数。

受关注者总数

难民、庇护申请者、境内流离失所者、无国籍者、其他受关注者与其他需要国际保护者之总和（不含接待社区与回返者）。

由前端自各组成指标加总；仅当至少一个组成有报告时，null 组成才视为 0。

所有存量皆為年末（12 月 31 日）數字；「回返」為年度流量。

5. 未報告不等於零

UNHCR 區分未報告（"-"）與報告為零。本站全程保留這個區別：地圖上（灰色 vs 最淺的藍）、圖表中（折線中斷 vs 落到零）、CSV（空欄位 vs 0）與 JSON（null vs 0）。灰色國家可能收容許多流離失所者，只是該年度未報告。

6. 兩種視角：現居地與來源地

每個數字都有兩種地理歸屬。庇護國（「他們現在在哪裡」）按人們目前所在的國家計數；來源國（「他們從哪裡逃離」）按人們離開的國家計數。境內流離失所者在兩種視角中都計入其本國。「流向」分頁與 flows/ 檔案提供雙邊矩陣。

7. 每千人

比率 = 人數 ÷ UN WPP 年中總人口 × 1,000。兩點注意：分子是 12 月 31 日的存量、分母是 7 月 1 日的人口；WPP 估計基準年之後的年份為中推計預測值。缺人口資料時不顯示比率。

8. 色階

全站僅使用單色藍階（ColorBrewer Blues）——不用紅/橙暖色，避免在視覺上把流離失所者呈現為「威脅」。七個級距。分級預設為分位數，且跨全部年份計算（針對目前顯示的國家）：拖動時間軸時顏色代表「量級」而非每年重排的「名次」，不同年份的截圖可以互相比較。零有自己的最淺色；未報告為灰色。

9. 邊界與名稱

邊界取自 Natural Earth，經簡化以利顯示。國名跟隨被引用的資料來源（UNHCR），另有小型覆寫表以利閱讀（如「Syrian Arab Rep.」→「敘利亞」）；原始名稱一律並列。爭議地區、科索沃與台灣皆有明確處理——詳見邊界、名稱與爭議地區。

10. 更新頻率與故障處理

UNHCR 約在每年 6 月發布上年度數字、10/11 月發布年中數字。管線每日執行，但只在內容變動時提交。三種時間戳嚴格分開：data_as_of（資料涵蓋到哪天）、retrieved_at（我們何時擷取——只在內容變動時前進）、資料集快照snapshot_id（整份資料的內容雜湊，目前為 21506b7d）。大宗 CSV 的 snapshot_id 欄位帶的是母體來源的內容雜湊前 8 碼，可經 sources.json 回溯驗證。

11. 即時事件層的處理原則

「近期境內流離失所事件」層轉載 IDMC 的初步事件估計。基於尊嚴與安全考量：衝突事件的座標一律對齊約 25 公里的網格（絕不標示到聚落層級）；少於 100 人的事件不單獨繪點；彈窗顯示數字、類型與日期，並連往 IDMC 的原始報告，而非轉貼敘述文字。此層的事件定義與年度 IDP 存量不同（後者不含災害）。

12. 引用

每個檢視都有固定連結，可重現年份、指標、視角、篩選、選取國家與地圖位置（分享與引用產生的連結會固定年份）。「引用」按鈕提供 APA 7、芝加哥（作者–年份）、BibTeX（@dataset，含 version）與「引用本頁」四種格式；出版年份採用資料年份而非點閱年份，並附上資料快照代碼以利精確回溯。請同時引用上游來源。

有疑問或指正：見关于。