地图基础设施与地理编码

​

R2 CDN — maps.worldmonitor.app

​

为什么选择 R2 而不是 Vercel？

• Cloudflare 带宽免费；Vercel 在大规模使用时按 GB 计费
• CF 缓存规则在边缘节点缓存 /data/、/assets/、/textures/ 等路径 30 天
• 大型文件（GeoJSON、PMTiles）不会膨胀 Vercel 部署

​

R2 上的文件

​

上传到 R2

# 单个文件
rclone copyto <local-path> r2:worldmonitor-maps/<filename>

# rclone 配置说明：设置 no_check_bucket = true（token 缺少 CreateBucket 权限）

​

CORS

​

国家几何服务

​

数据流

countries.geojson (/data/)  ──►  Parse & Index (rebuildCountryIndex)  ──►  countryIndex Map
                                         │
country-boundary-overrides.geojson      │
  (R2 CDN, 3s timeout)     ──►  applyCountryGeometryOverrides  ──►  replace matching polygons

1. countries.geojson — 带有 ISO 代码和名称的基础多边形，从 /data/ 提供（Vercel）
2. country-boundary-overrides.geojson — 来自 Natural Earth 的可选更高分辨率多边形，从 R2 CDN（maps.worldmonitor.app）提供。通过 ISO3166-1-Alpha-2（或 ISO_A2）代码匹配；匹配到的要素替换基础几何数据
3. 基础文件先加载并立即构建国家索引（服务变为可用）。覆盖文件随后获取，带 3 秒超时 — 失败会被静默忽略。覆盖查找使用 Map<code, Feature> 实现 O(1) 匹配

​

索引数据结构

​

关键导出

​

名称别名

'dr congo' → CD, 'czech republic' → CZ, 'uae' → AE, 'uk' → GB, 'usa' → US, ...

​

政治覆盖

​

国家边界覆盖

​

工作原理

1. 加载基础 countries.geojson 后，应用从 R2 CDN 获取 country-boundary-overrides.geojson，带 3 秒超时
2. 对于覆盖文件中的每个要素，按 ISO Alpha-2 代码匹配 countries.geojson 中的国家（使用 Map 进行 O(1) 查找）
3. 覆盖几何数据替换基础几何数据（在用于地图渲染的原始 GeoJSON 和索引的点对多边形数据中都会替换）
4. 覆盖文件可以包含任意数量的国家 — 只有匹配的代码会被应用

​

添加新的国家覆盖

1. 从 Natural Earth 50m Admin 0 获取边界（描绘的是事实边界 — 实际领土控制 — 而非外交主张）
2. 按 ISO 代码提取国家要素并保存为 GeoJSON
3. 合并到或替换 country-boundary-overrides.geojson
4. 上传到 R2：
   rclone copyto public/data/country-boundary-overrides.geojson r2:worldmonitor-maps/country-boundary-overrides.geojson
   
5. 无需代码更改 — 应用会自动获取新的几何数据

​

地缘政治敏感性

• Natural Earth 显示的是事实边界（谁实际控制该领土），而非外交主张
• 这是大多数地图平台使用的相同标准
• 为争议领土添加覆盖时，请在 PR 描述中记录来源和理由
• 覆盖系统不会增加或减少领土 — 它用来自同一权威来源的更高分辨率轮廓替换低分辨率轮廓

​

回退边界

​

底图切片

​

常见错误