ymgis

面向桌面 GIS 小工具的轻量组件库：画布 + 图层管理 + 图层树 + 基础绘制 + 在线地图服务预览 + 动态重投影。

不依赖 QGIS。基于 PyQt6 + rasterio + Shapely + pyproj，可发布到 PyPI，供 QuickAnno、下载器、质检工具等复用。

能力概览

在线服务图层自身为 EPSG:3857，叠到其它视图 CRS 时会动态重投影（AABB 近似）。高德/百度存在国内加密坐标偏移，适合底图预览，不宜与精密测绘数据直接叠合量测。

安装

# 开发态（本仓库）
pip install -e .

# 发布后
pip install ymgis

快速开始

from PyQt6.QtWidgets import QApplication, QMainWindow, QSplitter
from ymgis import MapCanvas, RasterLayer, VectorLayer, LayerTreeWidget, PanTool, DrawPolygonTool

app = QApplication([])
win = QMainWindow()
canvas = MapCanvas()
tree = LayerTreeWidget(canvas.layer_manager)

# 第一个带 CRS 的图层决定视图坐标系（无需手动 set_crs）
raster = RasterLayer(r"D:\data\demo.tif")
canvas.layer_manager.add_layer(raster)
canvas.zoom_to_full_extent()

# 普通图片预览（无地理参考，像素坐标）：
# from ymgis import ImageLayer
# canvas.layer_manager.add_layer(ImageLayer(r"D:\data\photo.jpg"))
# canvas.zoom_to_full_extent()

# 标注层自动继承视图 CRS；绘制坐标为画布 CRS
annos = VectorLayer("标注")
canvas.layer_manager.add_layer(annos)

tool = DrawPolygonTool()
tool.polygon_drawn.connect(
    lambda g: annos.add_feature(g, {"class": "demo"}, source_crs=canvas.crs)
)
canvas.set_map_tool(tool)

split = QSplitter()
split.addWidget(tree)
split.addWidget(canvas)
win.setCentralWidget(split)
win.resize(1200, 800)
win.show()
app.exec()

多坐标系叠加

from ymgis import MapCanvas, RasterLayer, VectorLayer, create_amap
from shapely.geometry import Point

canvas = MapCanvas()

# 先加载 CGCS2000 / 任意投影影像 → 视图 CRS = 该影像 CRS
canvas.layer_manager.add_layer(RasterLayer(r"D:\data\cgcs2000.tif"))

# 再叠加 WGS84 矢量 → 渲染时自动重投影到视图 CRS
pts = VectorLayer("点", crs="EPSG:4326")
pts.add_feature(Point(116.4, 39.9))
canvas.layer_manager.add_layer(pts)

# 在线底图（EPSG:3857）也会重投影到当前视图
canvas.layer_manager.add_layer(create_amap(), to_top=False)

canvas.zoom_to_full_extent()

添加数据（数据源 / 图层）

from ymgis import AddDataMode, browse_add_data

# 只选数据源（文件夹 / GDB / MDB / PostGIS），不进入图层
src = browse_add_data(mode=AddDataMode.SOURCE, multiselect=False)

# 选图层：可双击进入 GDB/MDB，支持多选
layers = browse_add_data(mode=AddDataMode.LAYER, multiselect=True)
if layers:
    for item in layers.items:
        print(item.kind, item.path, item.layer_name)

在线底图 / 地图服务预览

from ymgis import (
    MapCanvas,
    create_amap,
    create_baidu,
    create_google,
    create_tianditu,
    WmsLayer,
    ArcGisRestLayer,
    SuperMapRestLayer,
)

canvas = MapCanvas()

canvas.layer_manager.add_layer(create_amap(), to_top=False)
# canvas.layer_manager.add_layer(create_baidu(), to_top=False)
# canvas.layer_manager.add_layer(create_google(), to_top=False)
# canvas.layer_manager.add_layer(create_tianditu("你的天地图tk"), to_top=False)

# WMS / ArcGIS / 超图
# canvas.layer_manager.add_layer(WmsLayer("https://host/wms", "workspace:layer"))
# canvas.layer_manager.add_layer(
#     ArcGisRestLayer("https://host/arcgis/rest/services/Demo/MapServer")
# )
# canvas.layer_manager.add_layer(
#     SuperMapRestLayer("http://host:8090/iserver/services/map-demo/rest/maps/Demo")
# )

canvas.zoom_to_full_extent()

自定义 XYZ：

from ymgis import XyzTileLayer

layer = XyzTileLayer(
    "https://tile.example.com/{z}/{x}/{y}.png",
    name="自定义瓦片",
    subdomains=["a", "b", "c"],  # 对应模板 {s}
)

运行示例：

pip install -e .
python examples/basic_viewer.py
# 可选传入 GeoTIFF：
python examples/basic_viewer.py D:\data\demo.tif

# 在线底图 / WMS / ArcGIS / 超图预览：
python examples/online_basemap.py
# 天地图也可：set TIANDITU_TOKEN=你的tk

模块

设计约定

• 视图 CRS：由第一个加载且带有 CRS 的图层自动设定；canvas.set_crs(...) 可显式指定并锁定。
• 动态重投影：后续图层 CRS 不同时，在渲染/combined_extent 时转换到视图 CRS（依赖 pyproj；栅格用 WarpedVRT）。
• 无 CRS 的图层（如空标注层）加入后自动继承当前视图 CRS；绘制工具产出的几何为画布 CRS。
• 图层树默认展开图例：矢量按点/线/面样式，栅格显示缩略图，在线底图/服务显示通用符号；LayerTreeWidget(show_legend=False) 可关闭。
• 在线切片/WMS 图层原生多为 EPSG:3857；瓦片异步加载并带内存缓存。
• 栅格按视口读取并缩放到控件尺寸，避免整图进内存。

与 QGIS / GeoD 的关系

• 不是 QGIS 替代品：无工程文件、无复杂符号、无拓扑规则。
• 可预览常见在线底图与 OGC/REST 地图服务，但不是 GeoD 那种批量网图下载器。
• 目标：多个内部小工具共用同一套画布/图层树，安装包体积远小于捆绑 qgis_runtime。

发布到 PyPI

包名：ymgis（见 PyPI）。版本号只改一处：src/ymgis/__about__.py 中的 __version__（pyproject.toml 通过 hatch 动态读取，无需再改）。

1. 准备 API Token

1. 登录 PyPI → Account settings → API tokens
2. 新建 token（建议 scope 限定到项目 ymgis）
3. 复制以 pypi- 开头的完整 token（不是 Recovery Codes）

本地保存（勿提交仓库）：

copy scripts\publish.local.ps1.example scripts\publish.local.ps1
# 编辑 publish.local.ps1：
#   $PyPiToken = 'pypi-你的完整token'

scripts/publish.local.ps1 已在 .gitignore 中。

2. 升高版本并发布（推荐）

# 1) 编辑版本，例如：
#    src/ymgis/__about__.py  →  __version__ = "0.1.13"

# 2) 一键构建 + 上传
.\scripts\publish.ps1

# 其它用法：
# .\scripts\publish.ps1 -Token "pypi-你的完整token"   # 不写本地文件时临时传入
# .\scripts\publish.ps1 -SkipBuild                    # 仅上传已有 dist/
# .\scripts\publish.ps1 -TestPyPI                     # 上传到 TestPyPI

脚本会设置 TWINE_USERNAME=__token__、TWINE_PASSWORD=...，执行 python -m build 与 twine upload，结束后清理进程内的敏感环境变量。

3. 手动发布（可选）

pip install -e ".[dev]"
# 先改 __about__.py 版本
python -m build
# 交互上传时：Username 填 __token__ ，Password 填 pypi-...
twine upload dist/*

或使用环境变量：

$env:TWINE_USERNAME = "__token__"
$env:TWINE_PASSWORD = "pypi-你的完整token"
twine upload dist/*

4. 安装验证

# 官方源（发布后立即可用）
pip install -U ymgis==0.1.13 -i https://pypi.org/simple

# 国内镜像（如清华）可能延迟同步，找不到新版本时改用官方源，或稍后再试
pip install -U ymgis -i https://pypi.tuna.tsinghua.edu.cn/simple

5. 常见问题

注意： 不要把 API token、Recovery Codes 提交进 git；同一版本号在 PyPI 上不可覆盖，只能发新版本。

目录

ymgis/
├── pyproject.toml
├── README.md
├── LICENSE
├── examples/
│   ├── basic_viewer.py
│   └── online_basemap.py
├── src/ymgis/
│   ├── crs.py          # 动态重投影
│   ├── canvas/
│   ├── layers/
│   │   └── services/   # XYZ / WMS / ArcGIS / 超图 / 厂商预设
│   ├── tools/
│   └── widgets/
└── tests/

License

MIT