中国卫星影像下载与专题制图技能
- 2026-11-21 09:34:20
中国卫星影像下载与专题制图技能
CN Satellite Imagery Download & Thematic Mapping·cn-satellite-imagery·v1.7.9
INFORMATION | 信息 输入中国区县级及以下地名或 6 位 adcode,自动下载卫星影像、拼接为带地理参考的 GeoTIFF,并可一键生成 ArcGIS 风格专题图(比例尺 / 指北针 / 经纬网 / 图例 / 区界红线)。既是 WorkBuddy Skill,也可作独立命令行工具。默认 zoom=17、最高 18,原生 EPSG:3857。 |
一、核心能力Core Capabilities
能力 | 说明 |
地名解析 | china-division 区划索引 + DataV v3 边界;GCJ-02 → WGS84 反算,与 Esri 底图对齐 |
同名消歧 | 多候选时列出并要求 --parent 或直接用 adcode,不静默选错 |
并发下载 | 请求连接池 + 多线程 + 本地瓦片缓存;超时 / 重试 / 坏缓存自动重下 |
安全护栏 | 瓦片数上限(默认 6 万)+ --dry-run 预检(张数 / 块尺寸 / 像元体量) |
拼接 | 窗口化写入、内存与面积解耦;匀色 / 消拼缝(feather)/ 失败瓦片空洞填充 |
输出 TIF | JPEG q90 + tiled 256×256 + 金字塔概览,体积约为无压缩的 1/9 |
专题制图 | 椭球真值比例尺、罗盘指北针、DMS 经纬网、图例、研究区区界红线、数据来源注记 |
血缘元数据 | 逐产物记录 skill_version / source / adcode / zoom / bbox_wgs84 / failed_tiles 等 |
二、核心规则(硬性)Hard Rules
• 行政区级护栏:仅区县级及以下;省 / 地级市一律拒绝(退出码 3)并列出其下辖区县,无 --force 绕过;更大范围走 bbox 模式。
• 同名不静默选错:命中多个候选须 --parent 或 adcode 消歧。
• 坐标系:默认 3857(Esri 瓦片原生、零重采样);与 cn-dem 叠加用 --epsg 4326。
WARNING | 注意 影像版权归原始提供方(Esri World Imagery / Google 等)所有,本技能仅提供下载与拼接的技术实现。下载影像仅供学习、科研与内部评估使用,商业用途须自行取得数据授权;请勿高频大量抓取。 |
三、架构与数据流Architecture & Data Flow
地名/adcode → ① resolve_region(区划索引 + DataV 边界,GCJ-02→WGS84)→ WGS84 bbox → ② download_imagery(瓦片网格规划 + 并发下载 + 缓存 ↔ scripts/_tiles)→ 窗口化拼接 / 匀色 / 消拼缝 / 精确裁切 → GeoTIFF (EPSG:3857) → ③ make_map(降采样读 + warp 4326 + Agg 渲染)→ 专题图 PNG/PDF。
脚本 | 职责 |
satellite_imagery_cn.py | 一键入口:解析地名 → 下载 → 写血缘元数据 →(可选)出专题图 |
resolve_region.py | 地名 / adcode → WGS84 bbox(区划索引 + DataV v3 边界) |
download_imagery.py | bbox + zoom → GeoTIFF(窗口化落盘、匀色 / 消拼缝 / 多源 / 重投影) |
make_map.py | GeoTIFF → ArcGIS 风格专题图 PNG / PDF(自动注册系统 CJK 字体) |
四、快速上手Quick Start
pip install rasterio matplotlib numpy pillow requests mercantile # 1) 地名 → 影像(默认 zoom=17、EPSG:3857) python scripts/satellite_imagery_cn.py 五华区 # 2) adcode + 18 级 + 指定输出 python scripts/satellite_imagery_cn.py 530102 --zoom 18 --output d:/img/wh.tif # 3) 一键出专题图(区界红线 + 300 DPI) python scripts/satellite_imagery_cn.py 五华区 --map --title "五华区遥感影像专题图" --map-dpi 300 # 4) 已有 TIF 只重出图(改标题 / 图例不用重下影像) python scripts/make_map.py 五华区_satellite_z17.tif --output 五华区_专题图.png |
五、输出规格Output Spec
项 | 值 |
坐标系 | EPSG:3857 默认;--epsg 4326 可选(与 DEM 叠加对齐) |
波段 / 压缩 | 3 波段 RGB uint8;JPEG(YCbCr) + tiled 256 + 金字塔概览 |
地理参考 | 完整,精确裁切到请求 bbox |
元数据标签 | skill_version / source / region_name / adcode / admin_level / zoom / bbox_wgs84 / generated_at / failed_tiles / blank_tiles |
命名 | <区划名>_satellite_z |
六、常用参数Key Parameters
参数 | 默认 | 说明 |
--zoom | 17 | 最高 18;z19 需 --force(可能 GB 级文件) |
--epsg | 3857 | 4326 重投影 WGS84 |
--parent | — | 同名区划消歧 |
--pad | 0.10 | 下载范围相对包围盒外扩比例(研究区留白) |
--source | esri | google 需代理 / 境外 |
--balance-mode | none | offset 亮度偏移 / percentile 5–95% 拉伸 |
--feather | 24 | 消拼缝像素宽,建议 16–32 |
--mem-budget-mb | 2048 | 超出自动转流式(峰值内存与面积解耦) |
--max-workers | 12 | 并发下载线程数 |
--dry-run | off | 只预检不下载 |
--legend-pos | se | se 固定右下 / auto 避让区界 / sw,ne,nw… |
--panel-alpha | 1.0 | 比例尺 / 图例衬底不透明度(0 = 不要面板) |
七、性能与稳健性Performance & Robustness
• 实测优化:降采样核 bilinear→average(1.41×);PNG zlib 6→3(1.21×);GDAL warp 多线程 num_threads=8(3.6×,逐像素差 = 0)。端到端出图 2.20 s → 1.64 s(−25%)。
• 版式稳健:四角装饰件位置固定 + 白色衬底面板;面板尺寸与字号由实测文字宽度反推,标题按实测宽动态收字号,窄图幅自动避让。
TIP | 建议 本机环境(闫老师机器):技能文档内的 Python 路径为原作者机器路径,本机无效。已建隔离环境 C:/Users/yl/.workbuddy/skills/cn-satellite-imagery/.venv310(Python 3.10 + rasterio 1.4.4 等),后续直接复用。实测样例:530102 五华区 z17,21220×47897 px、454 MB、失败瓦片 0、纯色瓦片 153。 |
数据来源:卫星影像 Esri World Imagery(默认);行政边界 DataV.GeoAtlas(GCJ-02,已反算 WGS84)。当前版本 v1.7.9,发版三处同步:SKILL.md version、脚本 __version__、产物元数据 skill_version。