方法学摘要 / Methods
本文概述 GTAmap v1.1 的数据来源结构、事件驱动模型、置信度分级，以及与 GADM / geoBoundaries 的差异。
完整技术细节见发布包内docs/下的专题文档（数据规范、变更事件采集方案、基准年技术方案等）。
1. 设计目标
区划数据的核心问题不是"有没有"，而是哪一年、谁说的、能不能核。GTAmap 把这三个答案写进数据的每一行：
- 每行有
snapshot_year（哪一年）； - 每行有 6 个来源字段 +
src_url（谁说的，可一键回原始数据）； - 每行有
conf_grade/geom_origin/conf_note（可信到什么程度，绝不含糊）。
2. 数据来源：三层结构
按"离官方多近"分三层，逐要素标注：
| 层 | 等级 | 获取方式 | 规模 | 典型 |
|---|---|---|---|---|
| 第一层：官方直采 | A（52 个实体） | 直接采用国家统计/测绘机构发布的边界，保留逐要素来源记录 | 按发布版本与层级变化 | 巴西 IBGE、美国 TIGER、日本 MLIT、中国 CTAmap、法国 IGN、德国 BKG 等 |
| 第二层：官方经聚合器 / GADM 回退 | B（169 个实体） | 官方数据经 UN OCHA COD-AB、geoBoundaries 等可信聚合器转载；部分历史年份使用明确标记的替代来源 | 按发布版本与层级变化 | 多数非洲国家（OCHA COD-AB）、中东及部分拉美地区 |
| 第三层：OSM 与派生 | C（20 个实体）/ D（2 个实体） | OSM full-history 管线重建；或由其他层级并集/研究方法派生 | 按发布版本与层级变化 | 朝鲜、伊朗等 OSM 历史管线；印度、波多黎各的合成 ADM0 |
以上实体数以 v1.1 的 2025 全球快照为准：按实体跨层级采用最保守的 conf_grade 归类，A/B/C/D 分别为 52/169/20/2。要素层级的等级分布请直接筛选 conf_grade，不要把实体数当作要素数。
诚实性原则：拿不到真实历史的地方绝不用当前几何冒充——要么用 GADM 双锚点并标注 version_year，要么用 2026 基准几何回填并标注 current_carried_back（9 个实体的部分层级），用户一个 geom_origin 过滤就能得到严格子集。
3. 事件驱动模型：20,006 条事件如何产生
时间序列不是"堆 N 份底图"，而是以事件为骨架组织：相邻两个快照年做对比，识别出每一处建制变更，形成可核验的事件库。
3.1 三条采集通道
| 通道 | 做法 | 产出示例 |
|---|---|---|
| ① 官方序列 diff | 对同一机构的逐年官方底图做逐单元对比（ID 匹配 + 几何/面积/名称变化检测），自动生成候选事件，人工复核 | 巴西 3,876 条（IBGE 相邻版 diff）、法国市镇合并 3,782 起、日本平成大合并 1,097 起、爱沙尼亚 2017 改革 213→79 |
| ② 权威变更清单 | 从政府公报、法律文本、区划代码表整理变更记录，带生效日期与文号 | 中国 408 条（带民政部批准文号）、哈萨克阿拜州 2022 设立、马里 2023 改革 ADM2 从 53→160 |
| ③ OSM 历史管线 | 对 OSM full-history 数据做行政边界对象的时间回放 | 伊朗 1,586 条、朝鲜 275 条（日期为映射时间） |
3.2 事件的结构
每条事件 11 个字段（完整说明见 data-format §5）：event_id / event_type / effective_date / date_precision / date_basis / detail / source / legal_reference / confidence / from_snapshot / to_snapshot。
event_type覆盖：新设、撤销、合并、拆分、更名、边界调整、码变更；from_snapshot → to_snapshot把事件锚定到时间序列的具体两期，几何版本与事件一一对应；confidence：high（官方序列直接 diff 或有法律文号）/ medium（单源）/ low（推断）。
3.3 规模与口径
- v1.1 事件库包含 20,006 条记录、177 个数据集；逐国时间序列与事件表的可用性以当前发布清单为准；
- 事件日期可能代表法律生效日、官方版本差异日期或 OSM 映射日期，须结合
date_basis、date_precision、source与confidence解读。
4. 全球锚点年快照
逐国序列的年份集各国不同，跨國比较需要"全世界同一年"。GTAmap 提供 4 个锚点年：2000 / 2010 / 2020 / 2025 × ADM0/1/2：
| 锚点年 | ADM0 | ADM1 | ADM2 |
|---|---|---|---|
| 2000 | 243 | 3,486 | 57,085 |
| 2010 | 243 | 3,486 | 55,511 |
| 2020 | 243 | 3,476 | 54,942 |
| 2025 | 243 | 3,492 | 55,075 |
- 锚点年由各国"最接近该年的官方底图"拼合，
vintage_year / geom_year如实记录每个要素的真实几何年份（如 2000 锚点可能由某国 1999/2000/2001 三期拼合）； - 2025 快照共 58,810 个要素；三层均通过 v1.1 发布验收的几何有效性检查；
geom_origin=official_actual的比例：ADM0 95.5%（232/243）、ADM1 97.9%（3,420/3,492）、ADM2 98.3%（54,151/55,075）。其他来源由各要素的geom_origin明确标记。
5. 与 GADM / geoBoundaries 的差异
| 维度 | GADM | geoBoundaries | GTAmap v1.1 |
|---|---|---|---|
| 时间维度 | 无（单版本，约两年一发） | 基本单版本 | 2000–2026 时间序列 + 4 个锚点年 |
| 变更事件 | 无 | 无 | 20,006 条，带日期、依据、置信度 |
| 来源溯源 | 文档级 | 每国记录 boundarySource | 逐要素 6 字段 + src_url 直链 |
| 置信度标注 | 无 | 无（有层级注释） | A–D 逐要素分级 + conf_note |
| 几何来源透明度 | 混合、不逐要素声明 | 声明到国家级 | geom_origin 区分真实官方/派生/GADM 锚点/回填 |
| 稳定 ID | 有（GID） | 有 | unit_id 跨年稳定，支持面板数据 |
| 中国县级逐年 | 无 | 无 | 有（CTAmap，2000–2026，27 年） |
| 局限 | 时间维度缺失 | 历史版本少 | 单快照国家多（90 个）、GADM 回退部分非逐年 |
GTAmap 不试图"替代"GADM：63 个实体仍以 GADM 为回退锚点，并在字段里明说。差异在于：GTAmap 把"哪一年、谁说的、多可信"做成了可查询的字段。
6. 置信度分级判据（摘要）
| 等级 | 判据 |
|---|---|
| A | 数据直接来自官方机构下载，未经第三方几何加工 |
| B | 聚合器（OCHA/geoBoundaries 等）转载的官方源，几何未重制或简化程度已知；含 GADM 双锚点回退 |
| C | OSM 派生或第三方数字化，无官方背书 |
| D | 合成、推断回溯、简化严重或来源不明 |
等级与时间精度（date_precision）相互独立：A 级几何配 year 精度是常见组合；version_year 的数据（GADM 双锚点）即使几何可靠也不是逐年序列。
7. 已知局限（诚实清单）
- 90 个实体只有 1 个快照年——官方源现状如此，非数据缺陷；
- 16 个实体因官方源不可达或网络中断暂用替代方案（GADM 锚点或 2026 回填），其中回填 9 个实体的清单见 FAQ §11；
- OSM 来源 27 国的事件日期是映射时间，不是法律生效日；
- 单快照国家的空事件表表示"无第二个可比对的官方底图"，不等于"无边界变更"；
- 面积为 EPSG:6933 等积口径，与官方数字可能不同，差异写入
conf_note； - 同级相邻单元的缝隙/重叠尚未出具系统性 QC 报告（几何有效性已 100% 验证）。