工具箱 / QGIS 插件 / Spatial Match & Topo Adjust
Spatial Match & Topo Adjust · QGIS 插件
在一个窗口里检查要素是否在容差内贴上参考图层，按空间关系写字段，或预览并写回整要素平移。作者：youyu。
本页介绍可在 QGIS 里安装的插件。插件在你自己的电脑上运行，不经过有余服务器。可下载 ZIP 手动安装；源码可在 GitHub 公开。页面含详细功能说明，便于搜索检索。
- 目录 spatial_match_topo_adjust
- 插件菜单 + 主工具栏
- English / 中文 / Español / Français / العربية / Italiano / Deutsch / 日本語 / 한국어
- 无额外依赖，不联网
也可在 QGIS「插件 → 从 ZIP 安装」选择该文件。线上只更新插件包时，用 upload_qgis_zip.ps1 替换 downloads 里的 ZIP 即可。
正式页面：https://yuyouhui.online/tools/qgis/spatial-match-topo-adjust/
这个插件解决什么问题
建库和质检里常要回答三件事：要素有没有在容差内贴到参考图层、附近的参考要素该把哪个值写进字段、 以及一整条要素要不要平移。这个插件把三件事放在同一个窗口里，计算在本机 QGIS 完成。
吸附检测
- 判断图层对参考图层，按容差和空间关系检查是否命中
- 默认是标准检测。特殊检测包括悬挂端点、交叉未打断、无效几何、面检测等，并按当前几何类型过滤
- 可以输出已命中或未命中的临时图层
字段命名
- 按空间关系，把参考要素的值写到被命名图层，或写进临时图层
- 多条参考要素同时符合时，按你选的多匹配规则处理
- 一条方案里可以放多条子任务
移动
- 先预览整要素平移，确认后才写回
- 移动的是整个要素，不是单个顶点
图层列表和方案
- 左边两列等宽。不按 Ctrl 时点哪一行就只选中这一行，已选中再点不会取消。Ctrl 多选，Shift 选一段，拖动选划过的行。点空白不清除。点刷新才清空并重新载入
- 行前有 ◆◆ 时，点这个标记才打开分类，不改变当前选择
- 特殊检测下拉只看判断图层。不需要参考图层的项会清掉参考选择并禁用参考列；需要参考图层时再打开，不恢复被清掉的选择
- 三个功能的方案库分开。顶栏导入、导出在任一功能下都可用。总包只含方案配置，不含图层数据
适合谁搜这些词
QGIS 吸附检测、拓扑容差、空间字段命名、要素平移、悬挂点、批量质检方案。
English summary
Version 1.0.2. One window for snap check, field naming, and whole-feature move. The window opens at 700 by 650 each time QGIS starts. Without Ctrl, the row you click is the only selection, and clicking it again does not clear it. Ctrl adds or removes one row, Shift selects a range, and dragging selects the rows you cross. Empty space does not clear the selection. A special check that does not use a reference layer clears and disables that list. English, 中文, Español, Français, العربية, Italiano, Deutsch, 日本語, and 한국어. Local files only. QGIS 3.28 through 4.99, Qt 5 and Qt 6.
源码
怎么用
- 下载本页 ZIP（1.0.2），在 QGIS「插件 → 从 ZIP 安装」
- 完全退出 QGIS 后再打开。英文菜单是 Spatial Match & Topo Adjust，中文菜单是空间匹配与拓扑调整
- 左边两列选判断图层和参考图层。不按 Ctrl 时点哪一行就只选中这一行，已选中再点不会取消。Ctrl 多选，Shift 选一段，拖动选划过的行。点空白不清除
- 底栏切换吸附检测、字段命名、移动。需要重复使用时，把当前参数加入该功能自己的批量方案
常见问题
会上传数据吗？
不会。只用本机工程图层和你自己选择的本地 JSON 方案文件。
窗口大小会自己变吗？
不会。每次重新打开 QGIS 都是 700×650。你拉开之后的尺寸只留到本次 QGIS 退出，不写入本机设置。切换功能或语言也不会改窗口大小。
点空白处会取消已选图层吗？
不会。不按 Ctrl 时，点哪一行就只选中这一行，已经选中的行再点一次也不会取消。按住 Ctrl 可以多选或取消其中一行，Shift 选中一段，按住左键拖动把划过的行加进选择。点列表空白处不清除。点刷新才会清空选择并重新载入。
特殊检测会关掉参考图层吗？
下拉只按判断图层的几何类型列出。当前这项如果不需要参考图层，会清掉参考列里已经选中的图层，并把参考列和点、线、面、全部按钮一起禁用。回到「标准」，或换到需要参考图层的检测，参考列重新可用，刚才清掉的选择不会自动回来。
三个功能的方案会混在一起吗？
不会。吸附、字段命名、移动各有一套方案库。导出可以只导出其中一个库，也可以把三个库打成一个总包。旧的单功能文件仍可导入。
移动会直接改图层吗？
先给出预览。只有你确认之后才写回。写回的是整个要素的平移，不是只挪一个顶点。
界面语言怎么选？
第一次打开先看 QGIS 界面语言；九种之一就用对应语言，其它或读不到时用英文。选过之后会记住。阿拉伯语只换文字，不把窗口改成从右到左。
源码在哪？
https://github.com/AutoFYQ323/spatial-match-topo-adjust