@dsh-gis/dsh-opengis-skill 0.2.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +126 -1
- package/README.md +51 -25
- package/adaptations/brutile.md +6 -6
- package/adaptations/cesiumjs.md +6 -6
- package/adaptations/common.md +20 -13
- package/adaptations/deck-gl.md +6 -6
- package/adaptations/duckdb-spatial.md +6 -6
- package/adaptations/gdal-api.md +6 -6
- package/adaptations/gdal.md +6 -6
- package/adaptations/geolibre.md +6 -6
- package/adaptations/geometry-api-java.md +6 -6
- package/adaptations/geometry-api-net.md +6 -6
- package/adaptations/geonode.md +6 -6
- package/adaptations/geopandas.md +6 -6
- package/adaptations/geopipe-agent.md +6 -6
- package/adaptations/geos.md +8 -0
- package/adaptations/geoserver-cloud.md +6 -6
- package/adaptations/geoserver-rest-api.md +6 -6
- package/adaptations/geoserver.md +6 -6
- package/adaptations/geotools.md +6 -6
- package/adaptations/grass-gis.md +6 -6
- package/adaptations/jts.md +6 -6
- package/adaptations/kepler-gl.md +6 -6
- package/adaptations/leaflet.md +6 -6
- package/adaptations/mapbox-gl-js.md +6 -6
- package/adaptations/maplibre-gl-js.md +8 -0
- package/adaptations/maplibre-native.md +8 -0
- package/adaptations/mapserver.md +6 -6
- package/adaptations/mapsui.md +6 -6
- package/adaptations/nettopologysuite.md +6 -6
- package/adaptations/opendronemap.md +8 -0
- package/adaptations/opengis-all.md +7 -6
- package/adaptations/opengis-daf.md +7 -6
- package/adaptations/opengis-utils-for-java.md +6 -6
- package/adaptations/opengis-utils-for-net.md +6 -6
- package/adaptations/openlayers.md +6 -6
- package/adaptations/pdal.md +6 -6
- package/adaptations/postgis.md +6 -6
- package/adaptations/proj.md +6 -6
- package/adaptations/projnet4geoapi.md +6 -6
- package/adaptations/pyqgis.md +6 -6
- package/adaptations/qgis-process.md +6 -6
- package/adaptations/qgis-server.md +6 -6
- package/adaptations/shapely.md +6 -6
- package/adaptations/sharpmap.md +6 -6
- package/adaptations/spatialite.md +6 -6
- package/adaptations/stac-cog-titiler.md +8 -0
- package/adaptations/whitebox-tools.md +6 -6
- package/assets/brutile/SKILL.md +6 -12
- package/assets/cesiumjs/SKILL.md +14 -18
- package/assets/deck-gl/SKILL.md +9 -15
- package/assets/duckdb-spatial/SKILL.md +41 -25
- package/assets/gdal/SKILL.md +11 -18
- package/assets/gdal/reference/raster-tools.md +14 -0
- package/assets/gdal/reference/vector-tools.md +5 -0
- package/assets/gdal-api/SKILL.md +8 -16
- package/assets/gdal-api/reference/raster-api.md +7 -0
- package/assets/gdal-api/reference/vector-api.md +9 -0
- package/assets/geolibre/SKILL.md +11 -17
- package/assets/geometry-api-java/SKILL.md +5 -10
- package/assets/geometry-api-net/SKILL.md +5 -11
- package/assets/geometry-api-net/reference/geometry-types.md +5 -0
- package/assets/geonode/SKILL.md +8 -15
- package/assets/geopandas/SKILL.md +46 -17
- package/assets/geopandas/reference/core-api.md +55 -0
- package/assets/geopipe-agent/SKILL.md +7 -14
- package/assets/geopipe-agent/reference/steps-reference.md +12 -0
- package/assets/geopipe-agent/reference/workflows.md +8 -0
- package/assets/geos/SKILL.md +372 -0
- package/assets/geoserver/SKILL.md +6 -13
- package/assets/geoserver-cloud/SKILL.md +12 -21
- package/assets/geoserver-rest-api/SKILL.md +5 -12
- package/assets/geoserver-rest-api/reference/endpoints.md +16 -0
- package/assets/geotools/SKILL.md +5 -12
- package/assets/geotools/reference/raster-rendering.md +5 -0
- package/assets/geotools/reference/vector-io.md +7 -0
- package/assets/grass-gis/SKILL.md +36 -18
- package/assets/jts/SKILL.md +5 -12
- package/assets/jts/reference/geometry-operations.md +13 -0
- package/assets/kepler-gl/SKILL.md +10 -16
- package/assets/leaflet/SKILL.md +19 -23
- package/assets/mapbox-gl-js/SKILL.md +11 -16
- package/assets/maplibre-gl-js/SKILL.md +478 -0
- package/assets/maplibre-native/SKILL.md +383 -0
- package/assets/mapserver/SKILL.md +12 -16
- package/assets/mapsui/SKILL.md +29 -18
- package/assets/nettopologysuite/SKILL.md +5 -11
- package/assets/opendronemap/SKILL.md +309 -0
- package/assets/opengis-all/SKILL.md +14 -19
- package/assets/opengis-all/reference/data-stages.md +7 -0
- package/assets/opengis-all/reference/workflow-cheatsheets.md +7 -0
- package/assets/opengis-daf/SKILL.md +5 -13
- package/assets/opengis-utils-for-java/SKILL.md +7 -11
- package/assets/opengis-utils-for-java/reference/common-tasks.md +4 -0
- package/assets/opengis-utils-for-net/SKILL.md +5 -10
- package/assets/opengis-utils-for-net/reference/code-patterns.md +4 -0
- package/assets/opengis-utils-for-net/reference/util-classes.md +10 -0
- package/assets/openlayers/SKILL.md +16 -20
- package/assets/pdal/SKILL.md +15 -13
- package/assets/postgis/SKILL.md +21 -26
- package/assets/proj/SKILL.md +5 -12
- package/assets/projnet4geoapi/SKILL.md +6 -12
- package/assets/pyqgis/SKILL.md +5 -10
- package/assets/pyqgis/reference/processing-rendering.md +6 -0
- package/assets/pyqgis/reference/vector-raster-layers.md +6 -0
- package/assets/qgis-process/SKILL.md +5 -12
- package/assets/qgis-process/reference/algorithm-cheatsheet.md +6 -0
- package/assets/qgis-server/SKILL.md +7 -13
- package/assets/shapely/SKILL.md +29 -14
- package/assets/shapely/reference/operations-reference.md +42 -0
- package/assets/sharpmap/SKILL.md +5 -11
- package/assets/spatialite/SKILL.md +15 -16
- package/assets/stac-cog-titiler/SKILL.md +420 -0
- package/assets/whitebox-tools/SKILL.md +28 -19
- package/lib/adaptations.d.ts +18 -0
- package/lib/adaptations.js +164 -7
- package/lib/catalog.d.ts +7 -1
- package/lib/catalog.js +9 -1
- package/lib/index.d.ts +9 -0
- package/lib/index.js +48 -3
- package/lib/skill-file.d.ts +12 -0
- package/lib/skill-file.js +107 -16
- package/locale/en.json +1 -1
- package/locale/zh.json +1 -1
- package/package.json +8 -3
- package/upstream.json +74 -64
|
@@ -0,0 +1,309 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: opendronemap
|
|
3
|
+
description: "Use when turning drone/aerial imagery into orthophotos, DSM/DTM, point clouds or 3D Tiles with OpenDroneMap — odm CLI via docker run --project-path, --dsm --dtm --orthophoto-resolution --pc-quality --3d-tiles, WebODM 4.0.0 compose, /api/token-auth/ and /api/projects/{id}/tasks, pyodm Node('localhost',3000); also for 'odm_orthophoto.tif' outputs and out-of-memory failures."
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "photogrammetry, drone, orthophoto, point-cloud, dsm, dtm, 3d-tiles, webodm, docker, gis"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
> **项目地址:** <https://github.com/OpenDroneMap/ODM>(CLI/引擎)、<https://github.com/OpenDroneMap/WebODM>(Web 平台)
|
|
11
|
+
>
|
|
12
|
+
> **官方文档:** <https://docs.opendronemap.org/>(ODM)· <https://docs.webodm.org/>(WebODM)
|
|
13
|
+
>
|
|
14
|
+
> **最新版本:** ODM **3.6.2**(2026-08-12,[GitHub Releases](https://github.com/OpenDroneMap/ODM/releases);镜像 `opendronemap/odm:3.6.2`,2026-08-13 推送);WebODM **4.0.0**(2026-11-05,[GitHub Releases](https://github.com/OpenDroneMap/WebODM/releases);镜像 `webodm/webodm_webapp:4.0.0`,2026-11-04 推送);NodeODM **3.6.2**(镜像 `opendronemap/nodeodm:3.6.2`)(截至 2026-11)
|
|
15
|
+
>
|
|
16
|
+
> **运行环境:** Docker(Linux 推荐,Windows 原生安装包亦可);WebODM 4.0.0 栈为 Python 3.14、PostgreSQL 18、Valkey 9.1、Ubuntu 24.04
|
|
17
|
+
>
|
|
18
|
+
> **许可证:** AGPL-3.0(ODM 与 WebODM)
|
|
19
|
+
>
|
|
20
|
+
> **配套客户端:** PyODM 1.5.13(PyPI `pyodm`,通过 NodeODM REST API 提交任务)
|
|
21
|
+
|
|
22
|
+
## 概述
|
|
23
|
+
|
|
24
|
+
OpenDroneMap(ODM)是一套完全开源的无人机航空摄影测量流水线:给一个装满照片的目录,它输出带地理坐标的正射影像、数字表面模型、点云与纹理三维模型。它把 SfM 空三(OpenSfM)、稠密匹配(OpenMVS)、网格重建、纹理映射与地理配准串成一条可复现的命令行流水线,是商业航测软件(Pix4D、Metashape)之外成本最低的替代路线。
|
|
25
|
+
|
|
26
|
+
生态由四个组件构成,选择取决于你要「一次性出图」还是「长期运营一个出图平台」:
|
|
27
|
+
|
|
28
|
+
- **ODM(引擎/CLI)** — 真正干活的部分,一个 Docker 镜像 + 一组命令行参数,产物落在项目目录
|
|
29
|
+
- **NodeODM** — 把 ODM 包成 REST 任务队列服务(默认 3000 端口),可多机分布式
|
|
30
|
+
- **WebODM** — Django 前端:项目管理、任务队列、2D/3D 查看器、量测与 GCP 界面,底层通过 NodeODM 调度
|
|
31
|
+
- **PyODM** — Python 客户端,直接对 NodeODM API 编程,适合把航测接进已有系统
|
|
32
|
+
|
|
33
|
+
**与相邻技术的差异:** GDAL/PDAL 处理的是「已经有坐标的数据」,ODM 解决的是「只有照片,如何得到有坐标的数据」——它内部确实会调用 GDAL/PROJ 做地理配准与 GeoTIFF 写出,但入口是影像而非矢量/点云。
|
|
34
|
+
|
|
35
|
+
## 环境准备
|
|
36
|
+
|
|
37
|
+
### 方式一:Docker 跑 ODM CLI(推荐,最省事)
|
|
38
|
+
|
|
39
|
+
无需安装任何摄影测量依赖,镜像内已含 OpenSfM、OpenMVS、Entwine、PDAL、GDAL 等全部组件。目录约定是硬性的:项目目录下必须有一个名为 `images` 的子目录,否则流水线找不到输入。
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
# 目录结构:/datasets/<项目名>/images/*.jpg
|
|
43
|
+
docker run -ti --rm \
|
|
44
|
+
-v /home/user/datasets:/datasets \
|
|
45
|
+
opendronemap/odm \
|
|
46
|
+
--project-path /datasets my_project
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
```powershell
|
|
50
|
+
# Windows PowerShell(路径用正斜杠,避免反斜杠被当转义)
|
|
51
|
+
docker run -ti --rm -v c:/Users/user/datasets:/datasets opendronemap/odm --project-path /datasets my_project
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
固定版本比追 latest 更可靠:把 `opendronemap/odm` 换成 `opendronemap/odm:3.6.2`。需要 GPU 加速 SIFT 特征提取时用 `opendronemap/odm:gpu`(或 `opendronemap/odm:3.6.2-gpu`)并加 `--gpus all`。
|
|
55
|
+
|
|
56
|
+
### 方式二:WebODM 平台(需要界面/多人协作时)
|
|
57
|
+
|
|
58
|
+
WebODM 4.0.0 官方仓库自带 `webodm.sh` 管理脚本,它会拉取 `webodm/webodm_webapp:4.0.0`、`webodm/webodm_db:18` 与 Valkey broker:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
git clone https://github.com/OpenDroneMap/WebODM.git
|
|
62
|
+
cd WebODM
|
|
63
|
+
|
|
64
|
+
./webodm.sh start # 默认 http://localhost:8000
|
|
65
|
+
./webodm.sh --port 8000 --hostname localhost start
|
|
66
|
+
./webodm.sh --gpu start # Linux:挂 GPU 处理节点
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
./webodm.sh stop # 停止容器
|
|
71
|
+
./webodm.sh down # 停止并删除容器(数据卷保留)
|
|
72
|
+
./webodm.sh liveupdate # 不停止服务地升级到最新发布
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
首次启动会创建管理员账号 `admin`(密码在控制台输出,或首次登录时设置)。`.env` 里的 `WO_PORT`(默认 8000)、`WO_HOST`、`WO_MEDIA_DIR`、`WO_DB_DIR` 决定端口与数据落盘位置,改完重启生效。
|
|
76
|
+
|
|
77
|
+
### 方式三:原生安装与 Python 客户端
|
|
78
|
+
|
|
79
|
+
- **Windows**:从 ODM Releases 下载 setup 安装包,打开 ODM Console 后执行 `run C:\path\to\project --dsm`,无需 Docker
|
|
80
|
+
- **PyODM 客户端**:`pip install -U pyodm`,用于对 NodeODM 编程提交任务
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
# 起一个本地 NodeODM 处理节点(默认 3000 端口)
|
|
84
|
+
docker run -ti -p 3000:3000 opendronemap/nodeodm:3.6.2
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### 验证
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
docker run --rm opendronemap/odm:3.6.2 --version # 打印 ODM 版本
|
|
91
|
+
curl -s http://localhost:3000/info # NodeODM 节点信息(version、queueCount、maxImages)
|
|
92
|
+
curl -s http://localhost:8000/api/ # WebODM API 根(返回带 version 的 JSON)
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
## 核心命令
|
|
96
|
+
|
|
97
|
+
### ODM CLI 常用参数
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
docker run -ti --rm -v /datasets:/datasets opendronemap/odm:3.6.2 \
|
|
101
|
+
--project-path /datasets my_project \
|
|
102
|
+
--dsm \
|
|
103
|
+
--orthophoto-resolution 2 \
|
|
104
|
+
--pc-quality high
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
| 参数 | 默认值 | 作用 |
|
|
108
|
+
|------|--------|------|
|
|
109
|
+
| `--project-path <path>` | 必填 | 项目父目录;每个子目录是一个数据集,内含 `images/` |
|
|
110
|
+
| `--dsm` / `--dtm` | 关闭 | 生成数字表面模型 / 数字地形模型(不传就**没有** DEM 产物) |
|
|
111
|
+
| `--orthophoto-resolution <float>` | 5 | 正射影像地面分辨率(cm/px),值越小越精细也越慢 |
|
|
112
|
+
| `--dem-resolution <float>` | 5 | DSM/DTM 分辨率(cm/px) |
|
|
113
|
+
| `--pc-quality <ultra|high|medium|low|lowest>` | medium | 点云质量,直接决定稠密匹配耗时 |
|
|
114
|
+
| `--feature-quality <...>` | high | 特征提取质量(SIFT) |
|
|
115
|
+
| `--fast-orthophoto` | 关闭 | 跳过稠密重建与三维模型,只出 2D 正射(航拍平地区域首选) |
|
|
116
|
+
| `--skip-3dmodel` | 关闭 | 保留点云与正射,但跳过纹理三维模型 |
|
|
117
|
+
| `--3d-tiles` | 关闭 | 额外输出 OGC 3D Tiles(`3d_tiles/`,供 Cesium 等加载) |
|
|
118
|
+
| `--cog` | 关闭 | 输出 Cloud-Optimized GeoTIFF 而非普通 GeoTIFF |
|
|
119
|
+
| `--auto-boundary` | 关闭 | 用相机航迹自动裁掉重建范围外的噪声 |
|
|
120
|
+
| `--gcp <path>` | 无 | 控制点文件,用于提升绝对精度 |
|
|
121
|
+
| `--geo <path>` | 无 | 手动指定影像地理定位(无 EXIF/GPS 时) |
|
|
122
|
+
| `--mesh-size <int>` | 200000 | 三维网格面数上限,越大越精细 |
|
|
123
|
+
| `--max-concurrency <int>` | CPU 核数 | 并行任务数,内存不足时调小 |
|
|
124
|
+
| `--rerun <stage>` | 无 | 只重跑指定阶段并停止(改参数重算时省时间) |
|
|
125
|
+
| `--copy-to <path>` | 无 | 处理完成后把结果目录复制到此路径 |
|
|
126
|
+
|
|
127
|
+
### 常用预设组合
|
|
128
|
+
|
|
129
|
+
```bash
|
|
130
|
+
# 1) 快速正射(应急出图、只做 2D)
|
|
131
|
+
docker run -ti --rm -v /datasets:/datasets opendronemap/odm:3.6.2 \
|
|
132
|
+
--project-path /datasets my_project --fast-orthophoto --orthophoto-resolution 3
|
|
133
|
+
|
|
134
|
+
# 2) 标准测绘产物:正射 + DSM + DTM
|
|
135
|
+
docker run -ti --rm -v /datasets:/datasets opendronemap/odm:3.6.2 \
|
|
136
|
+
--project-path /datasets my_project --dsm --dtm --cog --auto-boundary
|
|
137
|
+
|
|
138
|
+
# 3) 带三维与 3D Tiles(数字孪生/Web 发布)
|
|
139
|
+
docker run -ti --rm -v /datasets:/datasets opendronemap/odm:3.6.2 \
|
|
140
|
+
--project-path /datasets my_project --dsm --3d-tiles --pc-quality high
|
|
141
|
+
|
|
142
|
+
# 4) 带控制点的高精度成果
|
|
143
|
+
docker run -ti --rm -v /datasets:/datasets opendronemap/odm:3.6.2 \
|
|
144
|
+
--project-path /datasets my_project --gcp /datasets/my_project/gcp_list.txt --dsm --dtm
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
### 产物目录
|
|
148
|
+
|
|
149
|
+
ODM 把每个阶段的结果留在项目目录下,交付时按需取用:
|
|
150
|
+
|
|
151
|
+
```text
|
|
152
|
+
my_project/
|
|
153
|
+
├── images/ # 输入照片
|
|
154
|
+
├── opensfm/ # 空三:相机位姿与连接点
|
|
155
|
+
├── odm_georeferencing/
|
|
156
|
+
│ └── odm_georeferenced_model.laz # 带坐标的点云(--pc-las 可出 .las)
|
|
157
|
+
├── odm_dem/
|
|
158
|
+
│ ├── dsm.tif # 仅 --dsm 时生成
|
|
159
|
+
│ └── dtm.tif # 仅 --dtm 时生成
|
|
160
|
+
├── odm_orthophoto/
|
|
161
|
+
│ ├── odm_orthophoto.tif # 正射影像 GeoTIFF
|
|
162
|
+
│ └── odm_orthophoto.original.tif # 未裁切版本
|
|
163
|
+
├── odm_texturing/
|
|
164
|
+
│ ├── odm_textured_model.obj # 纹理模型(局部坐标)
|
|
165
|
+
│ └── odm_textured_model_geo.obj # 带地理坐标的纹理模型
|
|
166
|
+
├── odm_report/ # 质量报告(PDF/HTML)
|
|
167
|
+
├── 3d_tiles/ # 仅 --3d-tiles 时生成
|
|
168
|
+
├── orthophoto_tiles/ dsm_tiles/ dtm_tiles/ # --tiles 时生成的瓦片
|
|
169
|
+
└── entwine_pointcloud/ # Entwine 点云索引(供 Potree 浏览)
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
> 交付前先确认 `odm_report/` 里的重叠度与重投影误差:重叠度不足或空三失败时,后面的正射与 DSM 即使生成也不可信。
|
|
173
|
+
|
|
174
|
+
### WebODM REST API
|
|
175
|
+
|
|
176
|
+
WebODM 的 API 与 ODM 引擎解耦,可用任意 HTTP 客户端驱动。认证走 JWT:
|
|
177
|
+
|
|
178
|
+
```bash
|
|
179
|
+
# 1) 换 token(返回 {"token": "..."})
|
|
180
|
+
TOKEN=$(curl -s -X POST http://localhost:8000/api/token-auth/ \
|
|
181
|
+
-H "Content-Type: application/json" \
|
|
182
|
+
-d '{"username":"admin","password":"<password>"}' | python -c "import json,sys;print(json.load(sys.stdin)['token'])")
|
|
183
|
+
|
|
184
|
+
# 2) 建项目 → 建任务(上传影像 zip 或逐张 multipart)
|
|
185
|
+
curl -s -X POST http://localhost:8000/api/projects/ \
|
|
186
|
+
-H "Authorization: JWT $TOKEN" -H "Content-Type: application/json" \
|
|
187
|
+
-d '{"name":"my_project"}'
|
|
188
|
+
|
|
189
|
+
curl -s -X POST http://localhost:8000/api/projects/1/tasks/ \
|
|
190
|
+
-H "Authorization: JWT $TOKEN" \
|
|
191
|
+
-F "images=@images.zip" \
|
|
192
|
+
-F "options={\"dsm\": true, \"orthophoto-resolution\": 2}"
|
|
193
|
+
|
|
194
|
+
# 3) 查任务状态(status: 10 排队 / 20 运行 / 30 失败 / 40 完成 / 50 取消)
|
|
195
|
+
curl -s http://localhost:8000/api/projects/1/tasks/1/ -H "Authorization: JWT $TOKEN"
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
成果通过固定路径取用:`/api/projects/{pid}/tasks/{tid}/orthophoto/tiles.json`(瓦片元数据)、`.../orthophoto/tiles/{z}/{x}/{y}.png`(瓦片)、`.../download/{asset}`(原始成果下载)、`.../assets/...`(单项资产)。把 `orthophoto` 换成 `dsm`、`dtm` 即可取高程瓦片,可直接喂给 Leaflet / OpenLayers / Cesium。
|
|
199
|
+
|
|
200
|
+
### PyODM:直接对 NodeODM 编程
|
|
201
|
+
|
|
202
|
+
```python
|
|
203
|
+
from pyodm import Node
|
|
204
|
+
|
|
205
|
+
node = Node("localhost", 3000)
|
|
206
|
+
task = node.create_task(
|
|
207
|
+
["images/1.jpg", "images/2.jpg"],
|
|
208
|
+
{"dsm": True, "orthophoto-resolution": 2},
|
|
209
|
+
name="demo",
|
|
210
|
+
)
|
|
211
|
+
task.wait_for_completion() # 阻塞直到完成或失败
|
|
212
|
+
assets = task.download_assets("results")
|
|
213
|
+
print(assets) # 含 odm_orthophoto、odm_dem 等目录
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
## 典型工作流
|
|
217
|
+
|
|
218
|
+
### 工作流一:一段视频 / 一批照片 → 正射 + DSM 交付
|
|
219
|
+
|
|
220
|
+
**输入**:一次航飞的 JPG(带 GPS EXIF),或一段航拍视频抽帧后的图片序列。
|
|
221
|
+
|
|
222
|
+
1. **检查输入**:照片带 GPS 且覆盖率足够(航向重叠 ≥ 70%、旁向 ≥ 60%),删掉糊片与地面随手拍,否则空三会失败
|
|
223
|
+
2. **组织目录**:`/datasets/my_project/images/*.jpg`
|
|
224
|
+
3. **先跑快速版确认数据可用**:加 `--fast-orthophoto --orthophoto-resolution 5`,十几分钟就能看出空三是否成立
|
|
225
|
+
4. **再跑正式版**:`--dsm --dtm --cog --auto-boundary --pc-quality high`
|
|
226
|
+
5. **验收**:`odm_report/` 看重叠度与重投影误差,用 `gdalinfo` 核对正射影像的 CRS 与分辨率
|
|
227
|
+
|
|
228
|
+
```bash
|
|
229
|
+
# 第 5 步验收
|
|
230
|
+
gdalinfo -json /datasets/my_project/odm_orthophoto/odm_orthophoto.tif \
|
|
231
|
+
| python -c "import json,sys;d=json.load(sys.stdin);print(d['size'], d['coordinateSystem']['wkt'][:60], d['geoTransform'])"
|
|
232
|
+
gdalinfo -stats /datasets/my_project/odm_dem/dsm.tif | grep -E 'Minimum|Maximum'
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
### 工作流二:成果入库并发布为 OGC 服务
|
|
236
|
+
|
|
237
|
+
ODM 的 GeoTIFF 与点云要真正「可用」,还需接进既有 GIS 栈:
|
|
238
|
+
|
|
239
|
+
1. **正射影像 → COG**(已是 `--cog` 时可跳过):`gdal_translate -of COG odm_orthophoto.tif ortho_cog.tif`
|
|
240
|
+
2. **DSM/DTM → PostGIS 栅格**:`raster2pgsql -s <SRID> -I -C -M -t 256x256 dsm.tif public.dsm | psql -d gisdb`
|
|
241
|
+
3. **点云 → PDAL 清洗/重投影**:`pdal translate odm_georeferenced_model.laz clean.laz outlier` 再去分类与抽稀
|
|
242
|
+
4. **三维成果 → 3D Tiles 上云**:用 `--3d-tiles` 的 `3d_tiles/` 直接由 CesiumJS 加载
|
|
243
|
+
|
|
244
|
+
```bash
|
|
245
|
+
gdalinfo -json odm_dem/dsm.tif | python -c "import json,sys;print(json.load(sys.stdin)['coordinateSystem']['wkt'][:120])"
|
|
246
|
+
# 用上面的 SRID(或 EPSG 码)替换下面的 <SRID>
|
|
247
|
+
raster2pgsql -s <SRID> -I -C -M -t 256x256 odm_dem/dsm.tif public.dsm_gen | psql -d gisdb
|
|
248
|
+
```
|
|
249
|
+
|
|
250
|
+
### 工作流三:WebODM 平台化批量作业
|
|
251
|
+
|
|
252
|
+
**场景**:一个团队要反复出图,需要项目管理、权限与在线查看器。
|
|
253
|
+
|
|
254
|
+
1. `./webodm.sh start` 起平台,登录后先在「Processing Nodes」确认自带 ODM 节点在线
|
|
255
|
+
2. 建项目 → 上传影像 zip → 选质量预设(Default / High Resolution / Fast Orthophoto)→ 提交
|
|
256
|
+
3. 任务详情页看日志与进度;失败时读 `Task Output` 里的最后一段 Traceback
|
|
257
|
+
4. 出图后在 2D 查看器量距/量面,3D 查看器看纹理模型;成果用 `Download` 打包全部资产
|
|
258
|
+
5. 批量脚本化时改用 API(见上文 REST 小节)或 PyODM,不要靠点界面
|
|
259
|
+
|
|
260
|
+
### 工作流四:只重算某一阶段
|
|
261
|
+
|
|
262
|
+
改了某个参数不想从头跑(SfM 可能花掉一半时间)时,用 `--rerun` 指定阶段:
|
|
263
|
+
|
|
264
|
+
```bash
|
|
265
|
+
docker run -ti --rm -v /datasets:/datasets opendronemap/odm:3.6.2 \
|
|
266
|
+
--project-path /datasets my_project --rerun odm_meshing --mesh-size 400000
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
## 常见问题
|
|
270
|
+
|
|
271
|
+
| 报错 / 现象 | 原因 | 处置 |
|
|
272
|
+
|------|------|------|
|
|
273
|
+
| `No images found in .../images` | 项目目录下没有 `images/` 子目录,或照片放在 `--project-path` 直下 | 严格按 `<project-path>/<dataset>/images/` 组织;`--project-path` 传父目录、末尾再跟数据集名 |
|
|
274
|
+
| 空三阶段失败、`Not enough images` / 大量未注册影像 | 重叠度不足、影像过糊、曝光差异过大,或照片缺少时间戳 | 提高航向/旁向重叠度重飞;删糊片;必要时加 `--matcher-type bruteforce` 或 `--feature-quality ultra` |
|
|
275
|
+
| 容器被 OOM killer 杀掉(退出码 137) | `--pc-quality ultra` 叠加高分辨率影像超出可用内存 | 降 `--pc-quality`、调小 `--max-concurrency`、加 `--split` 分块,或换更大内存机器 |
|
|
276
|
+
| 产物坐标在几千公里外 / 与底图对不上 | 影像 EXIF 的 GPS 有系统偏移,或缺 GCP | 用 `--gcp` 提供控制点;检查 EXIF 是否真的是 WGS84;`--gps-accuracy` 可放宽对 GPS 的信任 |
|
|
277
|
+
| 正射影像是空白 / 被裁成一条 | `--auto-boundary` 在影像不足时收缩过度,或空三只注册了少数影像 | 先去掉 `--auto-boundary` 看完整范围,再决定是否加回 |
|
|
278
|
+
| 没有 `dsm.tif` / `dtm.tif` | 没传 `--dsm` / `--dtm`,默认不生成 DEM | 明确加 `--dsm`、`--dtm`;只做 2D 的 `--fast-orthophoto` 也不产 DEM |
|
|
279
|
+
| `3d_tiles/` 目录不存在 | 没传 `--3d-tiles`,或该阶段被 `--rerun`/`--end-with` 提前截断 | 加 `--3d-tiles` 并确认 `--end-with` 未停在 `odm_postprocess` 之前 |
|
|
280
|
+
| Windows 下 `-v c:\data:/datasets` 挂载失败 | 反斜杠被 shell 转义,或 Docker Desktop 未共享该盘 | 用 `c:/data:/datasets` 正斜杠;在 Docker Desktop 里共享对应盘符 |
|
|
281
|
+
| WebODM 上传后任务一直排队 | 没有可用的 Processing Node,或节点已被占用 | 在 Processing Nodes 页面确认节点是绿色在线;`docker logs` 看 nodeodm 容器 |
|
|
282
|
+
| WebODM 接口返回 401 | 用了 Basic Auth 而非 JWT,或 token 过期 | 先 `POST /api/token-auth/` 取 token,请求头写 `Authorization: JWT <token>`,过期用 `/api/token-auth/refresh/` 换新 |
|
|
283
|
+
|
|
284
|
+
## AI 使用建议
|
|
285
|
+
|
|
286
|
+
- **先判断产物需求**:只要正射就用 `--fast-orthophoto`(快数倍);要 DEM 必须显式加 `--dsm`/`--dtm`;要 Web 三维再加 `--3d-tiles`。不要默认把所有开关都打开——三维与超高质点云是主要耗时来源。
|
|
287
|
+
- **先探环境再动手**:`docker --version`、`docker run --rm opendronemap/odm:3.6.2 --version`;宿主机内存与磁盘要先确认(中间文件常达原图数倍),磁盘不足会在纹理阶段失败得很难看。
|
|
288
|
+
- **先快速跑通再上正式参数**:用 3–5 张照片或 `--fast-orthophoto` 跑一次端到端,确认挂载路径与目录结构正确,再换成正式参数,避免跑几小时后才发现 `images/` 放错位置。
|
|
289
|
+
- **验证产物而不是只看退出码**:`odm_orthophoto/odm_orthophoto.tif` 用 `gdalinfo` 核对 CRS/尺寸;`odm_dem/*.tif` 用 `-stats` 看高程范围是否合理;点云用 PDAL `info` 看点数与 SRS;`odm_report/` 的重投影误差是质量判据。
|
|
290
|
+
- **失败信号优先级**:容器退出码 137 是 OOM(先降 `--pc-quality`);空三失败几乎都是数据问题(重叠度、糊片、GPS),改参数救不回来;WebODM 任务卡住先查 Processing Node 而不是重装平台。
|
|
291
|
+
- **版本与可复现**:把镜像标签写死为 `opendronemap/odm:3.6.2` / `webodm/webodm_webapp:4.0.0`,不要只用 `latest`;不同 ODM 版本的默认参数与产物目录结构会变,复现旧项目时记录版本号。
|
|
292
|
+
- **安全与权限**:WebODM 的 `admin` 凭据、`WO_SECRET_KEY`、JWT token 不要写进脚本或回显到报告;`./webodm.sh down`、删项目、`--rerun` 覆盖已有产物均不可逆,执行前向用户确认;无人机影像可能涉及测绘资质与隐私,外传前确认合规。
|
|
293
|
+
|
|
294
|
+
## 相关技能
|
|
295
|
+
|
|
296
|
+
- **pdal** — 点云清洗、分类与重投影,处理 ODM 输出的 `.laz`:[../pdal/SKILL.md](../pdal/SKILL.md)
|
|
297
|
+
- **gdal** — 正射影像/DSM 的 COG 转换、裁剪与栅格入库:[../gdal/SKILL.md](../gdal/SKILL.md)
|
|
298
|
+
- **cesiumjs** — 加载 `--3d-tiles` 产出的 OGC 3D Tiles 做 Web 三维发布:[../cesiumjs/SKILL.md](../cesiumjs/SKILL.md)
|
|
299
|
+
- **postgis** — DSM/DTM 与矢量成果入库、空间查询与瓦片服务:[../postgis/SKILL.md](../postgis/SKILL.md)
|
|
300
|
+
|
|
301
|
+
## 参考资源
|
|
302
|
+
|
|
303
|
+
- **ODM 官方文档:** <https://docs.opendronemap.org/> | [全部参数](https://docs.opendronemap.org/arguments/) | [产出说明](https://docs.opendronemap.org/outputs/) | [安装](https://docs.opendronemap.org/installation/)
|
|
304
|
+
- **WebODM 文档:** <https://docs.webodm.org/> | [API Quickstart](https://docs.webodm.org/api/quickstart/) | [认证](https://docs.webodm.org/api/authentication/)
|
|
305
|
+
- **PyODM 文档:** <https://pyodm.readthedocs.io/>
|
|
306
|
+
- **源码:** [ODM](https://github.com/OpenDroneMap/ODM) | [WebODM](https://github.com/OpenDroneMap/WebODM) | [NodeODM](https://github.com/OpenDroneMap/NodeODM) | [pyodm](https://github.com/OpenDroneMap/pyodm)
|
|
307
|
+
- **GCP 与控制点:** <https://docs.opendronemap.org/gcp/>
|
|
308
|
+
- **镜像:** [opendronemap/odm](https://hub.docker.com/r/opendronemap/odm) | [opendronemap/nodeodm](https://hub.docker.com/r/opendronemap/nodeodm) | [webodm/webodm_webapp](https://hub.docker.com/r/webodm/webodm_webapp)
|
|
309
|
+
- **社区论坛:** <https://community.opendronemap.org/>
|
|
@@ -1,28 +1,22 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: opengis-all
|
|
3
3
|
description: "Use when navigating end-to-end GIS workflows — GDAL CLI/API (ogr2ogr, gdalwarp, gdal_calc.py), qgis_process and PyQGIS analysis, GeoServer REST publishing, and OpenLayers/CesiumJS visualization. One-stop index covering the complete open-source GIS data pipeline."
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
- workflow
|
|
9
|
-
- fullstack
|
|
10
|
-
- gdal
|
|
11
|
-
- qgis
|
|
12
|
-
- geoserver
|
|
13
|
-
- pyqgis
|
|
14
|
-
- tutorial
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "gis, entrypoint, workflow, fullstack, gdal, qgis, geoserver, pyqgis, tutorial"
|
|
15
8
|
---
|
|
16
9
|
|
|
17
10
|
> **涵盖工具与项目:**
|
|
18
11
|
>
|
|
19
|
-
> | 工具/接口 | 项目地址 | 文档 | 许可证 |
|
|
20
|
-
>
|
|
21
|
-
> | GDAL 命令行 | <https://github.com/OSGeo/gdal> | <https://gdal.org/en/latest/programs/> | MIT |
|
|
22
|
-
> | GDAL API (C++/Python/Java/C#) | <https://github.com/OSGeo/gdal> | <https://gdal.org/en/stable/api/index.html> | MIT |
|
|
23
|
-
> | qgis_process | <https://github.com/qgis/QGIS> | <https://docs.qgis.org/3.44/en/docs/user_manual/processing/standalone.html> | GPL-2.0+ |
|
|
24
|
-
> | PyQGIS | <https://github.com/qgis/QGIS> | <https://docs.qgis.org/3.44/en/docs/pyqgis_developer_cookbook/> | GPL-2.0+ |
|
|
25
|
-
> | GeoServer REST API | <https://github.com/geoserver/geoserver> | <https://docs.geoserver.org/latest/en/user/rest/index.html> | GPL-2.0+ |
|
|
12
|
+
> | 工具/接口 | 最新版本(截至 2026-11) | 项目地址 | 文档 | 许可证 |
|
|
13
|
+
> |-----------|------------------------|----------|------|--------|
|
|
14
|
+
> | GDAL 命令行 | 3.13.3 | <https://github.com/OSGeo/gdal> | <https://gdal.org/en/latest/programs/> | MIT |
|
|
15
|
+
> | GDAL API (C++/Python/Java/C#) | 3.13.3 | <https://github.com/OSGeo/gdal> | <https://gdal.org/en/stable/api/index.html> | MIT |
|
|
16
|
+
> | QGIS / qgis_process | 4.2.3(LTR 3.44.15) | <https://github.com/qgis/QGIS> | <https://docs.qgis.org/3.44/en/docs/user_manual/processing/standalone.html> | GPL-2.0+ |
|
|
17
|
+
> | PyQGIS | 4.2.3(LTR 3.44.15) | <https://github.com/qgis/QGIS> | <https://docs.qgis.org/3.44/en/docs/pyqgis_developer_cookbook/> | GPL-2.0+ |
|
|
18
|
+
> | GeoServer REST API | 3.0.2 | <https://github.com/geoserver/geoserver> | <https://docs.geoserver.org/latest/en/user/rest/index.html> | GPL-2.0+ |
|
|
19
|
+
> | OpenLayers / CesiumJS(前端) | ol 10.11.0 / Cesium 1.147.0 | <https://github.com/openlayers/openlayers> | <https://openlayers.org/doc/> | BSD-2-Clause / Apache-2.0 |
|
|
26
20
|
|
|
27
21
|
## 概述
|
|
28
22
|
|
|
@@ -76,7 +70,7 @@ python3 -c "from osgeo import gdal; print(gdal.VersionInfo())"
|
|
|
76
70
|
### QGIS(qgis_process + PyQGIS)
|
|
77
71
|
|
|
78
72
|
```bash
|
|
79
|
-
# 安装 QGIS 3.44 LTR
|
|
73
|
+
# 安装 QGIS 4.2.3 或 3.44 LTR(qgis_process 从 3.16 开始可用)
|
|
80
74
|
# Ubuntu
|
|
81
75
|
apt-get install qgis qgis-plugin-grass
|
|
82
76
|
|
|
@@ -250,6 +244,7 @@ new Map({
|
|
|
250
244
|
- **geolibre** — 浏览器/桌面里做 GIS,无需服务端:[../geolibre/SKILL.md](../geolibre/SKILL.md)
|
|
251
245
|
- **whitebox-tools** — 地形/水文/LiDAR 批量分析:[../whitebox-tools/SKILL.md](../whitebox-tools/SKILL.md)
|
|
252
246
|
- **pdal** — 点云 LAS/LAZ 处理与 DEM 生成:[../pdal/SKILL.md](../pdal/SKILL.md)
|
|
247
|
+
- **stac-cog-titiler** — 影像云原生链路:COG 出图、STAC 编目与 TiTiler 动态切片:[../stac-cog-titiler/SKILL.md](../stac-cog-titiler/SKILL.md)
|
|
253
248
|
|
|
254
249
|
## 参考资源
|
|
255
250
|
|
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# OpenGIS Data Pipeline Stages Reference
|
|
2
2
|
|
|
3
|
+
## Contents
|
|
4
|
+
|
|
5
|
+
- 阶段一:数据获取与信息查询
|
|
6
|
+
- 阶段二:数据处理与转换
|
|
7
|
+
- 阶段三:空间分析
|
|
8
|
+
- 阶段四:发布 GIS 地图服务(GeoServer REST API)
|
|
9
|
+
|
|
3
10
|
Stage 1 (data acquisition/query), stage 2 (processing/conversion), stage 3 (spatial analysis) and stage 4 (GeoServer publishing) split from SKILL.md.
|
|
4
11
|
|
|
5
12
|
---
|
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# OpenGIS Workflow Examples and Cheatsheets
|
|
2
2
|
|
|
3
|
+
## Contents
|
|
4
|
+
|
|
5
|
+
- 端到端工作流示例
|
|
6
|
+
- 常用内置算法速查(qgis_process / PyQGIS)
|
|
7
|
+
- GDAL 命令行工具速查
|
|
8
|
+
- 数据格式支持
|
|
9
|
+
|
|
3
10
|
End-to-end workflow examples, built-in algorithm cheatsheet, GDAL CLI cheatsheet, data formats and env vars split from SKILL.md.
|
|
4
11
|
|
|
5
12
|
---
|
|
@@ -1,23 +1,15 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: opengis-daf
|
|
3
3
|
description: "Use when building JSON-plan GIS analysis or QC pipelines with OpenGisDAF (.NET 10 / C# 14) — daf validate/run, operators buffer/clip/intersect_check/containment_check/coordinate_transform, DAG upstream bindings, GeoJSON/Shapefile/PostGIS sinks, qcMode QC reports, AssemblyLoadContext plugins; also for \"zero tests ran\" exit code 5, missing --recurse-submodules GDAL build errors, or PostGIS Layer already exists. Plan-driven ETL."
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
- dotnet
|
|
9
|
-
- spatial-analysis
|
|
10
|
-
- data-quality
|
|
11
|
-
- geojson
|
|
12
|
-
- shapefile
|
|
13
|
-
- postgis
|
|
14
|
-
- vector
|
|
15
|
-
- pipeline
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "gis, csharp, dotnet, spatial-analysis, data-quality, geojson, shapefile, postgis, vector, pipeline"
|
|
16
8
|
---
|
|
17
9
|
|
|
18
10
|
> **项目地址:** <https://github.com/znlgis/opengis-daf>
|
|
19
11
|
>
|
|
20
|
-
>
|
|
12
|
+
> **最新版本:** 仓库 `main` 主线(截至 2026-11,[无 Release tag](https://github.com/znlgis/opengis-daf/releases)、无 NuGet 包;以 `global.json` 的 .NET SDK 10.0.301 为准)
|
|
21
13
|
>
|
|
22
14
|
> **许可证:** MIT License
|
|
23
15
|
>
|
|
@@ -1,23 +1,19 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: opengis-utils-for-java
|
|
3
3
|
description: "Use when needing common GIS utilities in Java — OguLayerUtil layer read/write, GeometryUtil 60+ ops, CrsUtil CGCS2000 (EPSG:4490, 4502-4554), Shapefile/GeoJSON/FileGDB/PostGIS/land TXT I/O, topology validation; also for GDAL UnsatisfiedLinkError on gdal_jni, missing osgeo repo on GeoTools, or resolving com.znlgis.ogu4j:ogu4j:1.0.0 that is not on Maven Central. OGU4J."
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
- jts
|
|
9
|
-
- gdal
|
|
10
|
-
- geometry
|
|
11
|
-
- vector
|
|
12
|
-
- crs
|
|
13
|
-
- cgcs2000
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "java, gis, geotools, jts, gdal, geometry, vector, crs, cgcs2000"
|
|
14
8
|
---
|
|
15
9
|
|
|
16
10
|
> **项目地址:** <https://github.com/znlgis/opengis-utils-for-java>
|
|
17
11
|
>
|
|
18
12
|
> **官方文档:** <https://github.com/znlgis/opengis-utils-for-java#readme>
|
|
19
13
|
>
|
|
20
|
-
>
|
|
14
|
+
> **最新版本:** 1.0.0(截至 2026-11,[仓库 `main` 分支 `pom.xml`](https://github.com/znlgis/opengis-utils-for-java/blob/main/pom.xml),无 Git tag;**尚未发布到 Maven Central**,需从源码 `mvn install` 安装到本地仓库)
|
|
15
|
+
>
|
|
16
|
+
> **Maven 坐标:** `com.znlgis.ogu4j:ogu4j`
|
|
21
17
|
>
|
|
22
18
|
> **许可证:** LGPL-2.1-or-later
|
|
23
19
|
|
|
@@ -1,15 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: opengis-utils-for-net
|
|
3
3
|
description: "Use when needing common GIS utilities in .NET/C# — OguLayerUtil ReadLayer/WriteLayer/ConvertFormat, GeometryUtil 50+ ops, CrsUtil CGCS2000 transforms, Shapefile/GeoJSON/FileGDB/GeoPackage/KML/PostGIS I/O; also for Unable to load DLL gdal / DllNotFoundException, GBK shapefile mojibake, or ArgumentException from Geojson2Wkt on a whole FeatureCollection. OpenGIS.Utils 1.1.2."
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
- ogr
|
|
9
|
-
- geometry
|
|
10
|
-
- vector
|
|
11
|
-
- crs
|
|
12
|
-
- cgcs2000
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "dotnet, csharp, gdal, ogr, geometry, vector, crs, cgcs2000"
|
|
13
8
|
---
|
|
14
9
|
|
|
15
10
|
> **项目地址:** <https://github.com/znlgis/opengis-utils-for-net>
|
|
@@ -18,7 +13,7 @@ tags:
|
|
|
18
13
|
>
|
|
19
14
|
> **NuGet 包:** `OpenGIS.Utils`
|
|
20
15
|
>
|
|
21
|
-
> **最新版本:** 1.1.2(截至 2026-
|
|
16
|
+
> **最新版本:** 1.1.2(截至 2026-11,[NuGet `OpenGIS.Utils`](https://www.nuget.org/packages/OpenGIS.Utils);[GitHub Release v1.1.2](https://github.com/znlgis/opengis-utils-for-net/releases))
|
|
22
17
|
>
|
|
23
18
|
> **许可证:** LGPL-2.1-or-later
|
|
24
19
|
|
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
# OpenGIS Utils for .NET 工具类参考
|
|
2
2
|
|
|
3
|
+
## Contents
|
|
4
|
+
|
|
5
|
+
- 数据读写 — OguLayerUtil(推荐入口)
|
|
6
|
+
- 几何运算 — GeometryUtil
|
|
7
|
+
- 坐标参考系 — CrsUtil
|
|
8
|
+
- Shapefile 工具 — ShpUtil
|
|
9
|
+
- PostGIS 工具 — PostgisUtil
|
|
10
|
+
- 国土调查 TXT 格式 — GtTxtUtil
|
|
11
|
+
- GDAL 配置
|
|
12
|
+
|
|
3
13
|
从 SKILL.md 拆出的 OguLayerUtil、GeometryUtil、CrsUtil、ShpUtil、PostgisUtil、GtTxtUtil 与 GDAL 配置参考,按 OpenGIS.Utils 1.1.2 编写。
|
|
4
14
|
|
|
5
15
|
---
|
|
@@ -1,16 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: openlayers
|
|
3
3
|
description: "Use when adding interactive 2D maps to web apps with npm ol 10.11.0 — Map/View, fromLonLat to EPSG:3857, WMS/WMTS/XYZ sources, MVT with featureClass, Draw/Modify/Snap interactions, or debugging blank layers (missing setStyle), offset centers and ol/... module-not-found errors."
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
- map
|
|
9
|
-
- wms
|
|
10
|
-
- wmts
|
|
11
|
-
- vector-tiles
|
|
12
|
-
- geojson
|
|
13
|
-
- drawing
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "javascript, web, 2d, map, wms, wmts, vector-tiles, geojson, drawing"
|
|
14
8
|
---
|
|
15
9
|
|
|
16
10
|
> **项目地址:** <https://github.com/openlayers/openlayers>
|
|
@@ -21,7 +15,7 @@ tags:
|
|
|
21
15
|
>
|
|
22
16
|
> **示例:** <https://openlayers.org/en/latest/examples/>
|
|
23
17
|
>
|
|
24
|
-
> **最新版本:** 10.11.0(截至 2026-
|
|
18
|
+
> **最新版本:** 10.11.0(截至 2026-11,[npm `ol`](https://www.npmjs.com/package/ol) 与 [GitHub Release](https://github.com/openlayers/openlayers/releases) 一致)
|
|
25
19
|
>
|
|
26
20
|
> **许可证:** BSD-2-Clause
|
|
27
21
|
|
|
@@ -305,15 +299,17 @@ drawSource.on('addfeature', () => {
|
|
|
305
299
|
|
|
306
300
|
## 常见问题
|
|
307
301
|
|
|
308
|
-
|
|
|
309
|
-
|
|
310
|
-
|
|
|
311
|
-
|
|
|
312
|
-
|
|
|
313
|
-
|
|
|
314
|
-
|
|
|
315
|
-
|
|
|
316
|
-
|
|
|
302
|
+
| 报错 / 现象 | 原因 | 处置 |
|
|
303
|
+
|------|------|------|
|
|
304
|
+
| 报错 `Uncaught AssertionError: Assertion failed: The view center is not defined` | `new View()` 未给 `center`,或给的是 `undefined`(坐标变量还没算出来) | 构造 View 时显式传 `center: fromLonLat([lng, lat])` 与 `zoom`;异步取数时等数据到了再 `view.setCenter()` |
|
|
305
|
+
| 报错 `Assertion failed: Expected a list of style instances` | `setStyle()` 收到单个 `Style` 之外的非法值(数组里混入 `null`/`undefined`,或传了函数却返回非 Style) | 传 `new Style({...})` 或其数组;用样式函数时确保每个分支都返回 Style |
|
|
306
|
+
| 中心点偏移 / 图层跑到别处 | 经纬度直接当投影坐标用,未做 `EPSG:4326 → EPSG:3857` 转换 | 所有经纬度经 `fromLonLat()` 转换;自定义投影先 `register(proj4)`;用 `map.getView().getCenter()` 回读核对 |
|
|
307
|
+
| 矢量图层完全不显示 | 矢量图层未设置样式时默认不渲染 | 为图层 `setStyle(new Style({...}))`,或在构造时传 `style` |
|
|
308
|
+
| WMS 返回空白或 404 | `LAYERS` 用了图层短名而非全名、`SRS`/`CRS` 与请求版本不匹配,或服务端未放行 CORS | 用 `GetCapabilities` 里的全名填 `LAYERS`;WMS 1.3.0 用 `CRS`、1.1.1 用 `SRS`;服务端补 CORS 头 |
|
|
309
|
+
| MVT 要素取不到属性 | MVT 源未指定要素类,属性被丢弃 | 用 `new MVT({ featureClass: Feature })`,再通过 `feature.getProperties()` 读取 |
|
|
310
|
+
| 文字标注不显示 / 字体不生效 | 字体尚未加载就创建了 Text 样式,或字体族名与服务端不一致 | 先用 `document.fonts.load()`/CSS 加载字体再建样式;确认 `font` 字符串里的字体族名可用 |
|
|
311
|
+
| 点击拾取不到要素 | 要素过小或触摸设备命中容差不足 | `map.forEachFeatureAtPixel(evt.pixel, cb, { hitTolerance: 5 })` 加大容差 |
|
|
312
|
+
| 运行时报 `ol/...` 模块找不到(如 `Failed to resolve module specifier "ol/Map.js"`) | 直接用 `<script>` 引 ESM 源码,或打包器未按 ESM 解析 | 用 npm 的 `ol` 包并配置打包器;不想打包就用官方全量构建 `dist/ol.js` |
|
|
317
313
|
|
|
318
314
|
---
|
|
319
315
|
|