GTAmap 全球多年度行政区划数据集
Download

数据下载

两条路：按国家取完整时间序列（该国全部可用年份），或取全球锚点年 （2000 / 2010 / 2020 / 2025 × ADM0/1/2，全世界同一年对比）。 每个下载项都标注了格式、体积、适用软件与打开方式。

不确定该下哪个？先做下面的三步选择题（约 20 秒），或先去地图浏览页看看数据长什么样。

选择引导 / Choose your file

我该下哪个？

回答三个问题，直接给出推荐文件、体积、预计下载时间与打开方式。答错了随时点「重选」。

  1. 1Scope
  2. 2Years
  3. 3Software
  4. ✓Recommendation
下载前必读 / Before you download

三句话讲清：多大、打开用什么、下不动怎么办

不知道从哪开始？按这个顺序下（推荐度由高到低）

  1. 全球锚点年 2025（ADM0 + ADM1） 最推荐

    GeoJSON · 1.0 MB + 7.0 MB（共约 7.9 MB，50 Mbps 约 2 秒）· QGIS 拖入即可看 · 先用它确认数据是不是你要的，再决定要不要下大包。

  2. 你真正研究的那个国家包 按需

    GeoParquet（zip）· 26 KB（梵蒂冈）～ 6.8 GB（日本）· 需解压后用 QGIS 3.28+ / Python 打开 · 含该国全部年份与层级。常用大国快捷入口：

  3. 变更事件库 all_events.csv 可选

    CSV · 5.7 MB（50 Mbps 约 1 秒）· Excel / WPS / pandas 都能开 · 想知道“哪一年为什么变”时再下，是解释边界差异的依据。

更细的场景（QGIS / Python / 不写代码）见上面的三步选择题；每个下载项都标注了格式、体积、适用软件与打开方式。

要下多久

国家包从 26 KB（梵蒂冈）到 6.8 GB（日本）不等； 86 个包小于 1 MB，27 个包超过 100 MB，超过 1 GB 的只有 5 个（日本、巴西、中国、美国、印尼）。 表格里每一项都按 50 Mbps 宽带换算了预计耗时——6.8 GB 约 19 分钟，1 MB 约 0.2 秒。

整站数据合计约 24 GB（233 个国家包 + 全球 GeoJSON + 离线瓦片）； 不建议一次性全下，先下你研究的那几个国家。

用什么打开

  • QGIS / ArcGIS：全球数据直接下 .geojson 拖进窗口；国家包解压后 QGIS 3.28+ 可读 .parquet
  • Python：gpd.read_file("x.geojson") 或 gpd.read_parquet("X.parquet")
  • Excel：只能打开 .csv（事件表、清单）；边界数据请用上面两种工具
  • 不装软件：先去地图浏览页看边界，确认是你要的再下载

下载打不开

链接指向本站数据目录（默认 data/，可一行切到 R2）。点不动时不要怀疑自己—— 点击下载前页面会先探测文件是否存在，失败时当场给出替代路径与建议，见 「下载打不开？」。

下载后请核对体积（country_manifest.csv 有每个包的准确字节数）；研究级发布包另附 SHA-256 校验清单。

按国家下载

每个国家一个包，含该国全部可用年份的国家/省级/地级边界，另附该国变更事件 CSV（部分国家有）与 README.txt。 「层级」列显示实际包含的层级，「年份范围」为该国时间序列覆盖的真实年份区间—— 年份跨度因国而异（中国 27 年、巴西 18 年、美国 16 年、法国 10 年，多数小国只有 1–2 期）。

快速定位： 点国家名可看该包的文件清单与打开方式
解压后到底得到什么？看两个真实例子（阿富汗「小」、中国「大」）

AFG.zip（12 MB，5 个文件）解压 →

AFG_adm0_timeseries.parquet      853 KB
AFG_adm1_timeseries.parquet      3.5 MB
AFG_adm2_timeseries.parquet      7.7 MB
AFG_timeline_events.csv          1.3 KB
README.txt                       859 B

CHN.zip（1.9 GB，7 个文件）解压 →

CHN_adm0_timeseries.parquet      2.4 MB
CHN_adm1_timeseries.parquet      9.3 MB
CHN_adm2_timeseries.parquet      585 MB
CHN_adm3_timeseries.parquet      1.4 GB
CHN_south_china_sea_claim_line.gpkg  104 KB
CHN_timeline_events.csv          123 KB
README.txt                       944 B
  • 没有外层文件夹：解压后文件直接落在你选的目标目录里，所以代码里写 gpd.read_parquet("CHN_adm2_timeseries.parquet")； 若你解压进了 CHN/ 子目录，就在前面加上 CHN/。
  • 先读 README.txt：里面有该包每个文件的行数、字段清单和官方读取示例（utf-8，直接双击可看）。
  • 层级因国而异：上表是中国（含 ADM3 县级）；多数国家只有 ADM0–ADM2。
  • 体积差异来自几何精度：CHN 的 ADM3 有 27 年、每期 2 万多个县级单元，所以一个文件就 1.4 GB。

加载中…

GTAmap v1.0 国家/区域时间序列包清单（点国家名可预览文件清单）
国家 / 区域 洲 层级 年份范围 年数 行数 事件 体积 / 预计耗时 来源等级 打开方式 SHA-256 下载
正在加载国家清单…

「体积」为 zip 包的实际大小（数据来源：data/country_manifest.csv，含每个包的准确字节数）； 包内是已经压缩过的 GeoParquet，zip 基本不再减小体积—— 解压后占用空间与 zip 相差很小（例：CHN.zip 1.9 GB → 解压后约 1.9 GB，另见上面的包内文件清单）。 来源等级 A–D 的含义见首页说明与关于页的判据。 「预计耗时」按 50 Mbps 带宽估算（1 MB ≈ 0.16 秒），实际取决于你的网络。

全球数据（本站可直接下载）

全世界同一年、同一层级的边界，适合做跨国对比与全球制图。 下面 14 个 GeoJSON 文件就是本站实际提供的文件（已按网页浏览需要简化）， 点开即下；研究级未简化几何见研究级发布包。

全球锚点年 GeoJSON（EPSG:4326 · 含 conf_grade/src_name 属性）——按推荐度排序：先 2025（发布基准年、几何质量最好），再往前推
年份 层级 文件 单元数 格式 体积 / 预计耗时 打开方式 下载
2025 推荐起点ADM0 web/global_adm0_2025.geojson 232 GeoJSON 1.0 MB
50 Mbps 约 0.2 秒
 QGIS 拖入 / gpd.read_file() 下载
2025 推荐起点ADM1 web/global_adm1_2025.geojson 3,440 GeoJSON 7.0 MB
50 Mbps 约 1.1 秒
 QGIS 拖入 / gpd.read_file() 下载
2020ADM0 web/global_adm0_2020.geojson 232 GeoJSON 0.9 MB
50 Mbps 约 0.2 秒
 QGIS 拖入 / gpd.read_file() 下载
2020ADM1 web/global_adm1_2020.geojson 3,424 GeoJSON 6.9 MB
50 Mbps 约 1.1 秒
 QGIS 拖入 / gpd.read_file() 下载
2010ADM0 web/global_adm0_2010.geojson 232 GeoJSON 1.0 MB
50 Mbps 约 0.2 秒
 QGIS 拖入 / gpd.read_file() 下载
2010ADM1 web/global_adm1_2010.geojson 3,434 GeoJSON 10.8 MB
50 Mbps 约 1.7 秒
 QGIS 拖入 / gpd.read_file() 下载
2000ADM0 web/global_adm0_2000.geojson 232 GeoJSON 1.0 MB
50 Mbps 约 0.2 秒
 QGIS 拖入 / gpd.read_file() 下载
2000ADM1 web/global_adm1_2000.geojson 3,434 GeoJSON 6.8 MB
50 Mbps 约 1.1 秒
 QGIS 拖入 / gpd.read_file() 下载

2025 年 ADM2（地级）· 按大洲分文件

ADM2 单元数达 55,137 个，单文件过大会拖慢浏览器，故 2025 快照按大洲拆成 6 个文件。 其余年份的全球 ADM2 未在本站提供（发布包内有）。

2025 ADM2 GeoJSON（按大洲）
大洲 文件 格式 体积 / 预计耗时 打开方式 下载
欧洲 web/global_adm2_2025_europe.geojson GeoJSON 7.6 MB
50 Mbps 约 1.3 秒
 QGIS 拖入（18,135 个单元，建议先关底图） 下载
亚洲 web/global_adm2_2025_asia.geojson GeoJSON 3.6 MB
50 Mbps 约 0.6 秒
 QGIS 拖入 / gpd.read_file() 下载
北美洲 web/global_adm2_2025_north_america.geojson GeoJSON 2.8 MB
50 Mbps 约 0.5 秒
 QGIS 拖入 / gpd.read_file() 下载
南美洲 web/global_adm2_2025_south_america.geojson GeoJSON 2.8 MB
50 Mbps 约 0.5 秒
 QGIS 拖入 / gpd.read_file() 下载
非洲 web/global_adm2_2025_africa.geojson GeoJSON 2.2 MB
50 Mbps 约 0.4 秒
 QGIS 拖入 / gpd.read_file() 下载
大洋洲 web/global_adm2_2025_oceania.geojson GeoJSON 0.6 MB
50 Mbps 约 0.1 秒
 QGIS 拖入 / gpd.read_file() 下载

14 个文件合计约 55 MB。GeoJSON 是文本格式，同样的几何比 GeoParquet 大若干倍—— 这也是研究级发布包用 GeoParquet 的原因。

离线矢量瓦片（PMTiles）· 自建网页地图用

17 个 .pmtiles 文件，合计约 370 MB，是地图浏览页正在使用的同一套瓦片。 不能当普通图层打开：需要 MapLibre GL JS + pmtiles 库，或支持 PMTiles 的客户端。 只想看图请用 GeoJSON；想做自己的在线地图才下这套。

PMTiles 矢量瓦片（MVT · zoom 0–8 · 全属性 unit_id/iso3/name/conf_grade）
层级 / 年份 文件 格式 体积 / 预计耗时 打开方式 下载
ADM0 · 4 个锚点年 pmtiles/map/adm0_{2000,2010,2020,2025}.pmtiles PMTiles（MVT） 18–23 MB / 个
50 Mbps 约 3 秒
 MapLibre + pmtiles 协议 Placeholder — ADM0 2025 (empty file)
ADM1 · 4 个锚点年 pmtiles/map/adm1_{2000,2010,2020,2025}.pmtiles PMTiles（MVT） 32–40 MB / 个
50 Mbps 约 6 秒
 MapLibre + pmtiles 协议 下载 2025
ADM2 · 2025 分洲 pmtiles/map/adm2_2025_{africa,asia,europe,north_america,oceania,south_america}.pmtiles PMTiles（MVT） 4–32 MB / 个
50 Mbps 约 1–5 秒
 MapLibre + pmtiles 协议 下载欧洲
瓦片清单 pmtiles/index.json JSON 9 KB
<1 秒
 JSON；含每个瓦片包的文件名、单元数与 zoom 范围 下载

单元数（2025 快照）

ADM0 232 · ADM1 3,440 · ADM2 55,137

真实几何覆盖

ADM0 100% · ADM1 99.6% · ADM2 98.3%，其余为派生或回填，字段 conf_grade / geom_origin 可筛

坐标系

EPSG:4326；面积字段 area_km2 由 EPSG:6933 等积投影计算。

Events

变更事件库

记录行政区划的分合沿革：变更类型、生效日期、依据（批准文号/法规）、置信度。 事件是解释“为什么这一年的边界和上一年不同”的依据，也是 GTAmap 区别于静态区划数据集的核心资产。 只想快速试一下数据？先从这一个文件开始——5.7 MB，Excel 也能打开。

20,006
事件总数（条）
来自 data/all_events.csv 的实际行数
80
有事件的数据集（个）
其余数据集为空表（无可比对的第二个底图）；数量以 events_summary.csv 为准
5.7 MB
单文件体积
一个 CSV 装下全部事件；50 Mbps 约 1 秒

全量事件库（单文件，本站可直接下载）

all_events.csv 含全部 20,006 条事件，列包括 event_id / event_type / effective_date / date_precision / detail / source / legal_reference / confidence / dataset。 按 dataset 列过滤即可取出某一国（如 CHN_timeline）。 单国包内也可能带 <ISO3>_timeline_events.csv（不是每个包都有）。

全部事件库 · CSV（5.7 MB） 按数据集汇总 · CSV（1.7 KB） 国家包清单 · CSV（5.8 KB）
CSV · UTF-8（带 BOM） Excel / WPS 双击打开 Python: pd.read_csv(..., encoding="utf-8-sig")
事件数最多的 20 个数据集（完整清单见 events_summary.csv）
数据集 国家/区域 事件数 说明
加载中…

使用事件库前请注意：OSM 来源（标注 _osm）的事件日期是“OSM 映射时间”， 不是法律生效日；date_precision=interval 表示只知道落在一段区间内，不是精确日期。 单快照国家的空事件表表示“无第二个可比对的官方底图”，不等于界址无变更。

Research-grade release

研究级发布包（未简化几何 · 尚未上线）

本站上方提供的文件是可直接下载的网页版（全球为简化 GeoJSON；单国为完整 GeoParquet）。 如果你需要未简化的全球 GeoParquet / GPKG、全文件 SHA-256 清单， 请使用发布包——它比网页版大得多，目前仍在做上线前最后的数据修复与镜像同步。

发布包内容与状态（v1.0）
内容 格式 数量 / 体积 状态 替代方案（现在就能下）
逐国时间序列 GeoParquet（zip 打包） 233 个 · 约 24 GB 已上线 按国家下载（就是这一份）
全量事件库 CSV 20,006 条 · 5.7 MB 已上线 事件库
全球锚点年（网页版） GeoJSON 14 个 · 约 55 MB 已上线 全球数据
全球离线瓦片 PMTiles（MVT） 17 个 · 约 370 MB 已上线 全球数据 · PMTiles
全球锚点年（研究级） GeoParquet + GPKG 12 个 GeoParquet · 约 16 GB 待上线 先用网页版 GeoJSON；或按国家下 GeoParquet 自己并集
全文件校验清单 CSV（SHA-256） 全站文件 待上线 先用 country_manifest.csv 核对 zip 体积
DOI 与正式引用链接 Zenodo DOI 1 个 待上线 暂用引用方式里的占位模板

发布上线后如何切地址：本站所有下载链接都由一个基址常量拼出， 上线时把 download.html 里 <body data-download-base="data/"> 改成 R2 域名（如 https://data.gtamapdata.org/data/packages/）即可，页面无需其他改动。

Troubleshooting

下载打不开 / 失败了怎么办

下载链接都指向本站 data/ 目录下的真实文件。点击下载时页面会先探测一次， 确认文件存在才跳转；失败会当场给出原因和替代方案。

按顺序排查

  1. 确认你是通过网址访问的：直接双击本地 index.html（file://）时， 浏览器会禁止读取本地数据，页面只能显示内置快照。
  2. 先测一个小文件：events_summary.csv（1.7 KB）。 它能下说明网络与站点正常，问题多半出在超大文件上。
  3. 大文件用下载工具：日本包 6.8 GB、巴西 2.7 GB，浏览器中途断线很常见。 复制文件直链后用 curl -C - -O / IDM / aria2 续传。
  4. 看是不是文件确实没上线：见研究级发布包的状态列。
  5. 仍然不行：到反馈页告诉我们文件路径 + 你看到的提示，会优先修。

一键检测本站下载链接

点击后对若干代表性文件各发一次 HEAD 请求（不下载内容）， 结果显示每个文件是「可下载」还是「找不到 / 网络异常」。

  • 尚未检测。

检测只是辅助：即使这里显示正常，超大文件仍可能因为网络中断而失败，请优先保证断点续传。

命令行下载与续传（推荐用于 > 1 GB 的文件）

bash / Git Bash — 断点续传 
curl -C - -O -L data/countries/CHN.zip
PowerShell — 断点续传 
curl.exe -C - -L -o CHN.zip data/countries/CHN.zip

URL 前缀换成站点地址即可，例如 https://你的域名/data/countries/CHN.zip。

Citation

引用方式

使用本数据集时请注明版本号与年份，以便结果可复现、可核对。

BibTeX 
@dataset{gtamap_v1_0_2026,
  title     = {GTAmap v1.0: Global Multi-year Administrative Divisions Dataset (2000--2026)},
  author    = {{GTAmap Project}},
  year      = {2026},
  version   = {1.0},
  url       = {https://zenodo.org/},
  note      = {Zenodo record pending; URL is the Zenodo homepage}
}
纯文本 / Plain text（中英） 
GTAmap Project. (2026). GTAmap v1.0: Global Multi-year Administrative Divisions Dataset (2000–2026) [Data set]. Version 1.0.

引用要素 / Elements to cite

  • 版本号（如 v1.0）——不同版本的边界与事件会变化
  • 锚点年或国家年份——同一国家不同年不可互换
  • 访问日期——建议附上
  • 若仅用部分来源，请同时引用原始数据源（见要素字段 src_name / src_url）

DOI 与正式 URL 为占位值，待数据集正式发布后替换。正式发布前请以机构主页或联系邮箱获取为准。

License

许可协议

采用代码与数据分置的双许可方案。以下为占位方案，最终以正式发布为准。

双许可方案（占位，最终以发布为准）
对象 许可 你可以 条件
数据（几何 + 事件） CC BY 4.0 商用、修改、再分发、再许可 署名 + 标注版本 + 保留溯源字段
脚本与站点代码 Apache-2.0 商用、修改、再分发 保留版权与许可声明、标注修改

署名要求 / Attribution

  • 保留引用（见引用方式）与版本号
  • 不要剥离 src_id / src_name / src_url / src_license / conf_grade / geom_origin 字段——这是本数据集可核验性的前提
  • 若对几何做了修改（裁剪、投影、简化、聚合），请注明“已修改”

上游来源的额外限制（重要）

  • GADM 替代源（约 60 个实体）：GADM 许可限制非商业使用，商用前请核对各要素 src_license
  • OSM 来源（朝鲜、伊朗等）：需遵守 ODbL，衍生数据须以相同许可开放
  • 官方直采：多数要求署名，个别来源有传播限制，逐要素 src_license 为准

因此本数据集的整体许可不覆盖上游许可的限制条款；请按要素字段逐条判断。

Checksum

校验下载完整性

本站提供的文件目前以体积核对为主（country_manifest.csv 里有每个国家包的准确字节数）； 研究级发布包上线后会附 manifest.csv 全文件 SHA-256。

Linux / macOS / Git Bash

bash 
sha256sum CHN.zip
ls -l CHN.zip

Windows PowerShell

powershell 
Get-FileHash -Algorithm SHA256 .\CHN.zip
Get-Item .\CHN.zip | Select Length

Python（按清单批量核对体积）

python 
import os, pandas as pd

man = pd.read_csv("data/country_manifest.csv")   # iso3, zip_bytes, files, country_name
man["local"] = man.iso3.map(lambda s: os.path.getsize(f"data/countries/{s}.zip")
                            if os.path.exists(f"data/countries/{s}.zip") else -1)
bad = man[man.local != man.zip_bytes]
print(f"{len(man) - len(bad)}/{len(man)} files match the expected size")
print(bad[["iso3", "zip_bytes", "local"]])

注：单国包内附 README.txt，写明该包各层级的行数；也可用 unzip -l CHN.zip 或 python -m zipfile -l CHN.zip 列出包内文件。

Data interface

页面读取的数据接口

本站在纯静态、零后端的前提下工作：所有列表与数字都从 data/ 下的几个文件读取， 读取失败时自动回退到随站点内置的 v1.0 快照（不会报错，只会在页面顶部提示）。

站点使用的数据接口约定（供数据流水线对接）
文件 用途 关键字段 缺失时
data/stats.json 首页三个关键数字 countries timeseries_rows events_total grade_dist generated 用内置 v1.0 数字
data/country_manifest.csv 按国家下载清单（体积、文件数、国名） iso3 zip_bytes files country_name 用内置 233 国快照
data/index.json 全站文件索引（含体积） files[].path files[].bytes 用内置体积表
data/events_summary.csv 按数据集的事件数汇总 iso3 dataset events 用内置 Top-20 表
data/all_events.csv 全量事件明细（20,006 行） event_id event_type effective_date dataset detail —（纯下载文件，页面不读取）
data/pmtiles/index.json 离线瓦片清单（文件名 / 单元数 / zoom） files[].path files[].unit_count 地图页回退到 GeoJSON

统一下载基址（部署时改一行）

html · download.html 
<!-- Local / self-hosted (ready to use) -->
<body data-download-base="data/">

<!-- Recommended: choose the base from the domain -->
<body data-download-base="auto">

<!-- Set a Cloudflare R2 base URL explicitly -->
<body data-download-base="https://data.gtamapdata.org/data/packages/">

<!-- Optional: set a separate base for page metadata -->
<body data-download-base="auto" data-meta-base="data/">

改这一行，全站下载地址一起切换，包括两类链接： JS 生成的（countries/<ISO3>.zip）和页面里手写的 （每个 <a> 带 data-dl-path="web/global_adm0_2025.geojson"， 由 assets/js/download.js 在加载时改写成 基址 + 相对路径； 保留的 href="data/..." 是没有 JS 时的回退）。

注意 data-meta-base：country_manifest.csv、index.json 这几个文件只用于渲染页面（不下载），默认始终取站点的 data/， 所以切换到 R2 后表格与数字照常工作；若你把整棵 data/ 树也镜像到了 R2， 再加上 data-meta-base 指向同一基址即可。部署细节见 deploy/cloudflare.md。

本地打开说明：直接双击 index.html（file://）时， 浏览器出于安全策略会禁止读取本地 JSON/CSV，页面会自动使用内置快照并提示。 要看到实时数据，请在站点根目录启动任意静态服务器（如 python -m http.server 8000）后访问。