常见问题 / FAQ
没找到答案？请到反馈页提问，我们会把高频问题补充到本页。
1. 数据多久更新？
不定期，以"版本"发布。当前正式版本 v1.1（2026-09-29）。v1.1 收录 244 个逐国/区域包目录，实际年份与层级因国家而异；后续工作见 changelog。被纠错的数据会在下一个小版本更正，每条更正都记入 changelog。
2. 为什么某国只有 1 个年份？
两种原因，看 geom_origin 即可区分：
- 官方源只拿到一个年份的底图：多数国家没有公开的"逐年版"区划，只能拿到当前官方底图。这类国家不是错误，而是全球现状。请在下载页按国家查看
country_manifest.csv中的实际年份和层级覆盖。 - GADM 回退包（
geom_origin=official_via_gadm_anchor）：只有 ≈2018 / ≈2022 两个版本锚点（date_precision=version_year），本来就不是逐年序列。
3. 面积为何与官方公布的数字不同？
area_km2 是 GTAmap 按 EPSG:6933 等积投影统一计算的，与官方口径可能有三类差异：
- 投影口径：官方常用阿尔伯斯/兰伯特等投影或椭球面计算，数值会差千分之几；
- 水域与潟湖：是否含内水、潟湖、河口，各国口径不一（如含潟湖的国家面积会明显偏大）；
- 海岸线概化程度：简化参数不同。
每处的具体口径差异都写在要素的 conf_note 里。需要与官方对表时，请以 src_url 指向的原始官方数据为准。
4. 能商用吗？
大体可以，有一处例外。 数据集整体按 CC BY 4.0 发布（可商用、需署名），但：
geom_origin = official_via_gadm_anchor的 14,921 个要素（63 个实体）受 GADM 原始许可约束（学术免费、商用受限），商用请过滤掉或另获授权；src_type = osm的 27 国按 ODbL，衍生数据库需继续开放。
详见 attribution §4。
5. 有 API 吗？
没有在线 API——GTAmap 是纯静态文件分发（GeoParquet / GPKG / CSV），这保证了零门槛、可离线、永远可复现。等价用法：
- Python：
gpd.read_parquet(...)读单国包通常只需数秒； - 严格的服务需求：把包放到对象存储后用 DuckDB / GeoParquet 的 HTTP Range 直接查询，无需下载全量。
6. 如何反馈数据错误？
两个入口：
- 反馈页：填表后会生成预填好的 GitHub Issue；
- 直接在 GitHub 仓库提 Issue，建议附上：国家、层级、
unit_id或code、年份、正确边界/名称的官方来源 URL。
带官方来源 URL 的纠错会被优先处理，更正记入 changelog 并随下个版本发布。
7. ADM2 是什么？
GTAmap 沿用国际通用的 ADM（administrative level）记法：
| 层级 | 含义 | 例子 |
|---|---|---|
| ADM0 | 国家/地区 | 中国、法国 |
| ADM1 | 一级（省级） | 省、州、大区 |
| ADM2 | 二级（地级） | 地级市、县、郡、市镇 |
| ADM3 | 三级（县级，仅中国包提供） | 县、县级市、区 |
注意 ADM 层级是"国家级—第 n 级"的相对记法，与各国具体建制名称不必一一对应。
8. 为什么中国的层级是省/地/县（ADM1/ADM2/ADM3）？
中国包来自 CTAmap v2.1，提供 2000–2026 共 27 个年份的省—地—县三级逐年边界，是全国少有的逐年县级序列。为了不把"县级"错误压缩进国际通用的 ADM2 槽位，中国包使用 ADM3 表示县级（CHN_adm3_timeseries.parquet），省级仍为 ADM1、地级为 ADM2。全国其他国家的层级统一停在 ADM2。
9. unit_id 会变吗？
设计上不会。unit_id 是按单元身份生成的稳定 ID（如 u_b648f09a0282），同一行政单元跨年份共用同一 ID，即使边界微调、更名、代码变更也不变。可以放心用它做跨年面板数据的主键。只有"行政区划建制本身撤并/新设"时才会出现新 ID 或 ID 消失——这类变化同时会记录一条事件（见事件库）。
10. GADM 回退包为什么只有两个年份？
GADM 项目本身约两年发布一个版本。对官方源不可达的 63 个实体，GTAmap 用 GADM 相邻两个版本（≈2018 / ≈2022）作为锚点，并诚实标注 date_precision=version_year。请勿把它们当作逐年序列使用；v1.1 起将逐国替换为官方源。
11. geom_origin = current_carried_back 是什么意思？
表示"该国/该层暂时拿不到真实历史几何，用 2026 基准几何回填了历史年份"。当前共影响 9 个实体的部分层级（ARM、CYP、MCO、MKD、NIU、PLW、SGP、STP、TUV）。回填行不能用于研究该时期真实边界，仅保证空间覆盖连续；补齐官方源后会在新版本中替换并记入 changelog。
12. 事件日期可信吗？
分三档，看事件表的 confidence 与 date_basis：
- high：官方序列直接对比得出，或有法律文号（如中国 408 条事件带民政部批准文号）；
- medium：单一来源或第三方（多数官方序列 diff 属此档）；
- low：推断。
特别注意：OSM 来源的日期是 "OSM 映射时间"而非法律生效日，不宜作为法定变更日期引用。v1.1 事件库共 20,006 条记录；法国市镇合并、巴西沿革、日本平成大合并等事件可回溯到 source / legal_reference 字段。
13. 和 GADM / geoBoundaries 有什么区别？
一句话：它们是单一时点（或双版本）的全球边界，GTAmap 是带时间维度的边界序列，且每个要素带溯源。详细对比见 methods §5。
14. 数据是官方数据吗？可以用于法律用途吗？
不是官方发布，不可以。GTAmap 是科研整理成果，边界与名称不构成主权立场，不做任何准确性担保；法定、测绘、勘界用途请直接使用各国官方发布。