@dsh-gis/dsh-opengis-skill 0.1.2 → 0.2.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 +71 -0
- package/README.md +79 -43
- package/THIRD_PARTY_NOTICES.md +9 -0
- package/adaptations/brutile.md +8 -0
- package/adaptations/cesiumjs.md +8 -0
- package/adaptations/common.md +16 -0
- package/adaptations/deck-gl.md +8 -0
- package/adaptations/duckdb-spatial.md +8 -0
- package/adaptations/gdal-api.md +8 -0
- package/adaptations/gdal.md +8 -0
- package/adaptations/geolibre.md +8 -0
- package/adaptations/geometry-api-java.md +8 -0
- package/adaptations/geometry-api-net.md +8 -0
- package/adaptations/geonode.md +8 -0
- package/adaptations/geopandas.md +8 -0
- package/adaptations/geopipe-agent.md +8 -0
- package/adaptations/geoserver-cloud.md +8 -0
- package/adaptations/geoserver-rest-api.md +8 -0
- package/adaptations/geoserver.md +8 -0
- package/adaptations/geotools.md +8 -0
- package/adaptations/grass-gis.md +8 -0
- package/adaptations/jts.md +8 -0
- package/adaptations/kepler-gl.md +8 -0
- package/adaptations/leaflet.md +8 -0
- package/adaptations/mapbox-gl-js.md +8 -0
- package/adaptations/mapserver.md +8 -0
- package/adaptations/mapsui.md +8 -0
- package/adaptations/nettopologysuite.md +8 -0
- package/adaptations/opengis-all.md +8 -0
- package/adaptations/opengis-daf.md +8 -0
- package/adaptations/opengis-utils-for-java.md +8 -0
- package/adaptations/opengis-utils-for-net.md +8 -0
- package/adaptations/openlayers.md +8 -0
- package/adaptations/pdal.md +8 -0
- package/adaptations/postgis.md +8 -0
- package/adaptations/proj.md +8 -0
- package/adaptations/projnet4geoapi.md +8 -0
- package/adaptations/pyqgis.md +8 -0
- package/adaptations/qgis-process.md +8 -0
- package/adaptations/qgis-server.md +8 -0
- package/adaptations/shapely.md +8 -0
- package/adaptations/sharpmap.md +8 -0
- package/adaptations/spatialite.md +8 -0
- package/adaptations/whitebox-tools.md +8 -0
- package/assets/brutile/SKILL.md +289 -0
- package/assets/cesiumjs/SKILL.md +78 -29
- package/assets/deck-gl/SKILL.md +20 -20
- package/assets/duckdb-spatial/SKILL.md +370 -0
- package/assets/gdal/SKILL.md +50 -55
- package/assets/gdal-api/SKILL.md +12 -29
- package/assets/geolibre/SKILL.md +364 -0
- package/assets/geometry-api-java/SKILL.md +11 -19
- package/assets/geometry-api-net/SKILL.md +66 -29
- package/assets/geonode/SKILL.md +347 -0
- package/assets/geopandas/SKILL.md +22 -28
- package/assets/geopipe-agent/SKILL.md +25 -30
- package/assets/geoserver/SKILL.md +21 -24
- package/assets/geoserver-cloud/SKILL.md +23 -34
- package/assets/geoserver-rest-api/SKILL.md +18 -23
- package/assets/geotools/SKILL.md +13 -21
- package/assets/grass-gis/SKILL.md +19 -20
- package/assets/jts/SKILL.md +12 -17
- package/assets/kepler-gl/SKILL.md +313 -0
- package/assets/leaflet/SKILL.md +42 -17
- package/assets/mapbox-gl-js/SKILL.md +19 -18
- package/assets/mapserver/SKILL.md +18 -18
- package/assets/mapsui/SKILL.md +87 -58
- package/assets/nettopologysuite/SKILL.md +96 -27
- package/assets/opengis-all/SKILL.md +80 -292
- package/assets/opengis-all/reference/data-stages.md +262 -4
- package/assets/opengis-daf/SKILL.md +12 -14
- package/assets/opengis-utils-for-java/SKILL.md +52 -47
- package/assets/opengis-utils-for-java/reference/common-tasks.md +12 -12
- package/assets/opengis-utils-for-net/SKILL.md +106 -40
- package/assets/opengis-utils-for-net/reference/code-patterns.md +11 -11
- package/assets/opengis-utils-for-net/reference/util-classes.md +25 -26
- package/assets/openlayers/SKILL.md +71 -14
- package/assets/pdal/SKILL.md +21 -15
- package/assets/postgis/SKILL.md +66 -18
- package/assets/proj/SKILL.md +29 -42
- package/assets/projnet4geoapi/SKILL.md +299 -0
- package/assets/pyqgis/SKILL.md +28 -54
- package/assets/qgis-process/SKILL.md +67 -39
- package/assets/qgis-server/SKILL.md +21 -32
- package/assets/shapely/SKILL.md +133 -84
- package/assets/sharpmap/SKILL.md +96 -61
- package/assets/spatialite/SKILL.md +365 -0
- package/assets/whitebox-tools/SKILL.md +269 -0
- package/lib/adaptations.d.ts +47 -0
- package/lib/adaptations.js +268 -0
- package/lib/index.d.ts +1 -1
- package/lib/index.js +14 -2
- package/lib/skill-file.js +31 -7
- package/locale/en.json +1 -1
- package/locale/zh.json +1 -1
- package/package.json +12 -2
- package/upstream.json +56 -40
package/assets/pdal/SKILL.md
CHANGED
|
@@ -17,7 +17,9 @@ tags:
|
|
|
17
17
|
>
|
|
18
18
|
> **官方文档:** <https://pdal.io/>
|
|
19
19
|
>
|
|
20
|
-
>
|
|
20
|
+
> **Conda:** `pdal` / `python-pdal`(conda-forge,最新 2.10.2,截至 2026-10)
|
|
21
|
+
>
|
|
22
|
+
> **PyPI:** `pdal`(Python 绑定,最新 3.5.5,截至 2026-10;版本号与主库独立)
|
|
21
23
|
>
|
|
22
24
|
> **许可证:** BSD-3-Clause
|
|
23
25
|
|
|
@@ -66,9 +68,11 @@ pip install PDAL # 依赖系统已安装 PDAL 库(提供 pdal-config)
|
|
|
66
68
|
### 验证安装
|
|
67
69
|
|
|
68
70
|
```bash
|
|
69
|
-
pdal --version # 输出如
|
|
71
|
+
pdal --version # 输出如 PDAL 2.10.2 (…)
|
|
72
|
+
pdal --help # 列出全部子命令(info/translate/pipeline/…)
|
|
70
73
|
pdal --drivers # 列出可用的 readers/filters/writers
|
|
71
|
-
pdal --options filters.smrf # 查看某个
|
|
74
|
+
pdal --options filters.smrf # 查看某个 driver 的参数与默认值
|
|
75
|
+
pdal info --help # 查看单个子命令的参数
|
|
72
76
|
```
|
|
73
77
|
|
|
74
78
|
## 核心 API/命令
|
|
@@ -309,7 +313,7 @@ for las_file in glob.glob("tiles/*.las"):
|
|
|
309
313
|
- 重投影后用 writer 的 `scale_*/offset_* = "auto"`,防止坐标精度截断
|
|
310
314
|
- 输出统一用 LAZ(`compression: "true"`)减小体积,GDAL/QGIS 可直接读取
|
|
311
315
|
- 用 `tag` + `inputs` 构建分支与合并(filters.merge),tag 必须先定义
|
|
312
|
-
- `pdal ground`
|
|
316
|
+
- `pdal ground` 自 2.6.0 标记 DEPRECATED,2.7 从默认安装移除、2.8 完全移除;一律改用 `filters.smrf` 的 pipeline 写法
|
|
313
317
|
- SMRF 参数需按数据调整:window 参考最大建筑物尺寸,slope/threshold 可参考 SMRF 论文的参数组合
|
|
314
318
|
|
|
315
319
|
## 常见问题
|
|
@@ -324,13 +328,16 @@ for las_file in glob.glob("tiles/*.las"):
|
|
|
324
328
|
| writers.gdal 输出了多波段 | 默认 `output_type: "all"`,指定 `mean` 或 `idw` 等单值即可输出单波段 |
|
|
325
329
|
| 重投影后坐标精度变差 | 在 writer 中设置 `scale_x/y/z` 与 `offset_x/y/z: "auto"` |
|
|
326
330
|
| 地面分类效果不佳 | 调整 smrf 的 window/slope/threshold/scalar,先检查数据坐标系与高程单位 |
|
|
331
|
+
| 报 `Couldn't create <cls> stage of type '<type>'.` | stage 名拼错或该版本没有此 stage:先 `pdal --drivers` 确认存在,再核对 `readers.*`/`filters.*`/`writers.*` 前缀 |
|
|
327
332
|
|
|
328
|
-
##
|
|
333
|
+
## AI 使用建议
|
|
329
334
|
|
|
330
|
-
-
|
|
331
|
-
-
|
|
332
|
-
-
|
|
333
|
-
-
|
|
335
|
+
- **执行环境**:命令在终端 / shell 中执行(Windows 用 PowerShell)。正文的 `sudo apt`、`conda activate` 是 Bash/Linux 写法,Windows 改用 OSGeo4W 或 conda;Docker 挂载写成 `docker run --rm -v "${PWD}:/data" -w /data pdal/pdal pdal pipeline pipeline.json`。
|
|
336
|
+
- **先探测版本**:`pdal --version`(应为 2.10.2)、`pdal --drivers`;`pdal ground` 自 2.6 起弃用,低版本缺少 `filters.expression` 等 stage,回答里要写明按哪个版本写。
|
|
337
|
+
- **验证产物**:`pdal info --summary out.laz` 核对 `num_points`、`bounds`、`srs`;DEM 用 `gdalinfo -json dem.tif` 核对波段数与范围;pipeline 先 `pdal pipeline --validate` 再实跑,不要只看退出码。
|
|
338
|
+
- **注意执行模式**:stream mode 不能跑 `filters.outlier`、`filters.smrf` 这类需要全局统计的 stage,大文件先按 tile 拆分;`writers.gdal` 默认 `output_type: "all"` 会输出多波段,单波段 DEM 要显式写 `idw`/`mean`。
|
|
339
|
+
- **Python 场景**:`pipeline.execute()` 返回处理的点数而不是数组,数据在 `pipeline.arrays`(NumPy 结构化数组);排查失败看 `pipeline.log`,不要只看异常栈。
|
|
340
|
+
- **安全与权限**:`pdal translate` 与各 writer 会覆盖同名输出,先确认目标文件名;`pdal pipeline --stdin` 和 Docker 挂载以调用者/容器用户写盘,Linux 下注意属主;安装 PDAL 或下载大点云前先征得用户同意。
|
|
334
341
|
|
|
335
342
|
## 相关技能
|
|
336
343
|
|
|
@@ -339,10 +346,9 @@ for las_file in glob.glob("tiles/*.las"):
|
|
|
339
346
|
- **geopandas** — Python 矢量数据处理:[../geopandas/SKILL.md](../geopandas/SKILL.md)
|
|
340
347
|
- **shapely** — 几何对象计算,与裁剪范围构造相关:[../shapely/SKILL.md](../shapely/SKILL.md)
|
|
341
348
|
|
|
342
|
-
##
|
|
349
|
+
## 参考资源
|
|
343
350
|
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
5. Python 场景用 `json.dumps` 构造 stage 列表,便于程序化生成与复用
|
|
351
|
+
- **官方文档:** <https://pdal.io/en/stable/> | [Pipeline](https://pdal.io/en/stable/pipeline.html) | [命令行应用](https://pdal.io/en/stable/apps/index.html) | [Stage 参考](https://pdal.io/en/stable/stages/stages.html) | [维度列表](https://pdal.io/en/stable/dimensions.html) | [Python 绑定](https://pdal.io/en/stable/python.html)
|
|
352
|
+
- **GitHub:** <https://github.com/PDAL/PDAL>
|
|
353
|
+
- **Docker 镜像:** <https://hub.docker.com/r/pdal/pdal>
|
|
354
|
+
- **示例数据:** <https://github.com/PDAL/data>
|
package/assets/postgis/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: postgis
|
|
3
|
-
description: "Use when extending PostgreSQL with
|
|
3
|
+
description: "Use when extending PostgreSQL with PostGIS 3.6.4 — geometry/geography/raster types, GiST and KNN <-> indexes, ST_Intersects/ST_Buffer/ST_Transform/ST_AsMVT, shp2pgsql -I and raster2pgsql import, and fixing \"Operation on mixed SRID\", slow spatial joins, and invalid polygons with ST_MakeValid."
|
|
4
4
|
tags:
|
|
5
5
|
- postgresql
|
|
6
6
|
- database
|
|
@@ -18,6 +18,8 @@ tags:
|
|
|
18
18
|
>
|
|
19
19
|
> **官方文档:** <https://postgis.net/docs/>
|
|
20
20
|
>
|
|
21
|
+
> **最新版本:** 3.6.4(截至 2026-10,[Releases](https://github.com/postgis/postgis/releases));3.7 系列已到 3.7.0rc3,尚未正式发布
|
|
22
|
+
>
|
|
21
23
|
> **许可证:** GPL-2.0+
|
|
22
24
|
|
|
23
25
|
## 概述
|
|
@@ -30,7 +32,7 @@ PostGIS 是基于 PostgreSQL 的开源空间数据库扩展,遵循 OGC Simple
|
|
|
30
32
|
- **坐标参考系**:内置 6000+ EPSG 投影,自动 ST_Transform
|
|
31
33
|
- **数据导入导出**:与 GDAL/ogr2ogr/shp2pgsql 无缝集成
|
|
32
34
|
|
|
33
|
-
**版本要求:** PostgreSQL 12–18 配合 PostGIS 3.x(最新稳定版 3.6.4
|
|
35
|
+
**版本要求:** PostgreSQL 12–18 配合 PostGIS 3.x(最新稳定版 3.6.4;3.7 仍处 RC 阶段,候选版为 3.7.0rc3,截至 2026-10);GEOS ≥ 3.8(部分新算子需 GEOS ≥ 3.14)
|
|
34
36
|
|
|
35
37
|
---
|
|
36
38
|
|
|
@@ -191,14 +193,63 @@ SELECT ST_Clip(rast, geom, true) FROM dem, region WHERE region.id=1;
|
|
|
191
193
|
|
|
192
194
|
---
|
|
193
195
|
|
|
194
|
-
##
|
|
196
|
+
## 典型工作流:Shapefile 入 PostGIS → 空间连接 → 导出 GeoJSON
|
|
197
|
+
|
|
198
|
+
**输入**:`data/poi.shp`(点,EPSG:4326)、`data/districts.shp`(面,EPSG:4326)。
|
|
199
|
+
|
|
200
|
+
**步骤 1 —— 入库并建索引**(`shp2pgsql -I` 自动建 GiST 索引,`-s 4326` 指定 SRID):
|
|
201
|
+
|
|
202
|
+
```bash
|
|
203
|
+
shp2pgsql -s 4326 -I -W UTF-8 data/poi.shp public.poi \
|
|
204
|
+
| psql -d gisdb -v ON_ERROR_STOP=1
|
|
205
|
+
shp2pgsql -s 4326 -I -W UTF-8 data/districts.shp public.districts \
|
|
206
|
+
| psql -d gisdb -v ON_ERROR_STOP=1
|
|
207
|
+
psql -d gisdb -c "VACUUM ANALYZE poi, districts;"
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
**步骤 2 —— 空间连接**(点落在哪个区;先用 `&&` 走索引再 `ST_Within` 精筛):
|
|
211
|
+
|
|
212
|
+
```sql
|
|
213
|
+
CREATE TABLE poi_with_district AS
|
|
214
|
+
SELECT p.id, p.name, d.name AS district, p.geom
|
|
215
|
+
FROM poi AS p
|
|
216
|
+
JOIN districts AS d
|
|
217
|
+
ON p.geom && d.geom -- 包围盒粗筛,走 GiST
|
|
218
|
+
AND ST_Within(p.geom, d.geom); -- 精确判断
|
|
219
|
+
|
|
220
|
+
CREATE INDEX ON poi_with_district USING GIST (geom);
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
**步骤 3 —— 导出 GeoJSON**(`-t_srs EPSG:4326` 保证输出为经纬度):
|
|
224
|
+
|
|
225
|
+
```bash
|
|
226
|
+
ogr2ogr -f GeoJSON out/poi_with_district.geojson \
|
|
227
|
+
"PG:host=localhost dbname=gisdb user=postgres" poi_with_district \
|
|
228
|
+
-t_srs EPSG:4326
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
**输出与验收**:
|
|
232
|
+
|
|
233
|
+
```sql
|
|
234
|
+
-- 落在区内的点数(INNER JOIN 会过滤掉区外的点,因此 <= POI 总数)
|
|
235
|
+
SELECT count(*) FROM poi_with_district;
|
|
236
|
+
|
|
237
|
+
-- 未匹配数 = POI 总数 - 已匹配数(差值即落在所有区之外的点)
|
|
238
|
+
SELECT (SELECT count(*) FROM poi)
|
|
239
|
+
- (SELECT count(*) FROM poi_with_district) AS unmatched;
|
|
195
240
|
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
241
|
+
-- SRID 应为 4326
|
|
242
|
+
SELECT ST_SRID(geom) FROM poi_with_district LIMIT 1;
|
|
243
|
+
|
|
244
|
+
-- 确认连接走 GiST:计划里应出现 poi_geom_idx 上的 Index/Bitmap Index Scan
|
|
245
|
+
EXPLAIN (ANALYZE, BUFFERS)
|
|
246
|
+
SELECT count(*) FROM poi AS p JOIN districts AS d
|
|
247
|
+
ON p.geom && d.geom AND ST_Within(p.geom, d.geom);
|
|
248
|
+
```
|
|
249
|
+
|
|
250
|
+
若两边 SRID 不一致,`&&` 会退化为逐行比较且可能报 `Operation on mixed SRID`;先 `ST_Transform` 统一到 4326 再入库。
|
|
251
|
+
|
|
252
|
+
最后用 `ogrinfo -al -so out/poi_with_district.geojson` 核对要素数与字段,不要只凭 psql 的 `INSERT 0 n` 判定成功。
|
|
202
253
|
|
|
203
254
|
---
|
|
204
255
|
|
|
@@ -230,15 +281,12 @@ SELECT ST_Clip(rast, geom, true) FROM dem, region WHERE region.id=1;
|
|
|
230
281
|
|
|
231
282
|
## AI 使用建议
|
|
232
283
|
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
-
|
|
237
|
-
-
|
|
238
|
-
-
|
|
239
|
-
- **KNN 用 `<->`**:`ORDER BY geom <-> point LIMIT 10` 走 GiST 索引,比 `ST_Distance` 快几个数量级
|
|
240
|
-
- **大几何优化**:使用 `ST_Subdivide` 切分大面几何加速空间连接
|
|
241
|
-
- **导入后 ANALYZE**:大批量数据导入后执行 `VACUUM ANALYZE` 更新统计信息
|
|
284
|
+
- **执行环境**:命令在终端 / shell 中执行(Windows 用 `psql.exe`,或 `docker exec -i pg psql -U postgres`);psql 元命令(`\d`、`\c`)用 `psql -c "\d poi"` 单条传入,别依赖交互式会话。
|
|
285
|
+
- **先探测版本**:`psql -c "SELECT version(), PostGIS_Full_Version();"` 核对 PostgreSQL、PostGIS 3.6.4 与 GEOS/PROJ;扩展缺失时先看 `SELECT * FROM pg_available_extensions WHERE name LIKE 'postgis%';`。
|
|
286
|
+
- **验证产物**:导入后别只看 `INSERT 0 n`,跑 `SELECT count(*), ST_SRID(geom), ST_IsValid(geom) FROM t GROUP BY 2,3;` 核对要素数、SRID 与无效几何;性能结论必须用 `EXPLAIN (ANALYZE, BUFFERS)` 证明索引被使用。
|
|
287
|
+
- **写操作回读**:`CREATE/ALTER`、`UpdateGeometrySRID` 或批量 `UPDATE` 后回读 `\d+ t` 与 `geometry_columns`,确认列类型与 SRID 真的落库。
|
|
288
|
+
- **安全与权限**:密码不要写进命令行或报告(用 `PGPASSWORD`/`.pgpass`/连接串环境变量);`DROP TABLE/SCHEMA`、整表改写 geom、`VACUUM FULL`、重启 PostgreSQL 前必须先向用户确认并备份。
|
|
289
|
+
- **大表 DDL**:`UPDATE`/`CREATE INDEX` 尽量放在可控事务里避免长时间锁表;`CREATE INDEX CONCURRENTLY` 不能包在事务块中执行。
|
|
242
290
|
|
|
243
291
|
## 相关技能
|
|
244
292
|
|
package/assets/proj/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: proj
|
|
3
|
-
description: "Use when
|
|
3
|
+
description: "Use when transforming coordinates or inspecting CRS definitions from the command line — cs2cs, projinfo -s/-t, proj projection math, cct, EPSG lookup, datum shift with grid files, WKT/PROJJSON export, or debugging \"Cannot find proj.db\" and latitude-first axis order. PROJ 9.9.0: the OSGeo engine behind GDAL/QGIS, with the proj.db SQLite database."
|
|
4
4
|
tags:
|
|
5
5
|
- proj
|
|
6
6
|
- crs
|
|
@@ -20,7 +20,7 @@ tags:
|
|
|
20
20
|
>
|
|
21
21
|
> **命令行文档:** <https://proj.org/en/stable/apps/index.html>
|
|
22
22
|
>
|
|
23
|
-
> **最新版本:** 9.9.0(截至 2026-10
|
|
23
|
+
> **最新版本:** 9.9.0(截至 2026-10)
|
|
24
24
|
>
|
|
25
25
|
> **许可证:** MIT
|
|
26
26
|
|
|
@@ -147,15 +147,17 @@ projinfo --dump-db-structure
|
|
|
147
147
|
### cs2cs — 坐标系转换
|
|
148
148
|
|
|
149
149
|
```bash
|
|
150
|
-
# EPSG 代码:WGS 84 经纬度 → UTM
|
|
150
|
+
# EPSG 代码:WGS 84 经纬度 → UTM 32N(EPSG:4326 轴序为纬度在前,故 56 是纬度、12 是经度)
|
|
151
151
|
echo 56 12 | cs2cs EPSG:4326 EPSG:25832
|
|
152
152
|
|
|
153
|
-
#
|
|
154
|
-
cs2cs EPSG:4326 EPSG:32631 <<EOF
|
|
153
|
+
# 多行输入(45N 为纬度、2E 为经度)
|
|
154
|
+
cs2cs EPSG:4326 EPSG:32631 <<'EOF'
|
|
155
155
|
45N 2E
|
|
156
156
|
EOF
|
|
157
157
|
```
|
|
158
158
|
|
|
159
|
+
> **轴序要点:** 输入 `AUTHORITY:CODE` 或 WKT 时按该 CRS 定义的轴序解析,`EPSG:4326` 是纬度在前;用 `-r` 反转输入、`-s` 反转输出。下文示例一律先纬度后经度。
|
|
160
|
+
|
|
159
161
|
PROJ 字符串写法(`+to` 分隔源与目标):
|
|
160
162
|
|
|
161
163
|
```bash
|
|
@@ -242,8 +244,9 @@ projsync --list-files
|
|
|
242
244
|
### 模式 1:WGS 84 经纬度 → UTM / Web Mercator
|
|
243
245
|
|
|
244
246
|
```bash
|
|
245
|
-
|
|
246
|
-
echo 116.391
|
|
247
|
+
# 先纬度后经度:39.907 是纬度、116.391 是经度(北京)
|
|
248
|
+
echo 39.907 116.391 | cs2cs EPSG:4326 EPSG:32650 # 北京 → UTM 50N
|
|
249
|
+
echo 39.907 116.391 | cs2cs EPSG:4326 EPSG:3857 # → Web Mercator
|
|
247
250
|
```
|
|
248
251
|
|
|
249
252
|
### 模式 2:CGCS2000 中国坐标系操作
|
|
@@ -255,8 +258,8 @@ projinfo EPSG:4490
|
|
|
255
258
|
# 查询 3 度带高斯-克吕格投影(114E 中央经线,即 38 带)
|
|
256
259
|
projinfo EPSG:4547
|
|
257
260
|
|
|
258
|
-
# WGS 84 经纬度 → CGCS2000 3
|
|
259
|
-
echo 114.0
|
|
261
|
+
# WGS 84 经纬度 → CGCS2000 3 度带投影(30.5N 114.0E,纬度在前)
|
|
262
|
+
echo 30.5 114.0 | cs2cs EPSG:4326 EPSG:4547
|
|
260
263
|
```
|
|
261
264
|
|
|
262
265
|
### 模式 3:查找并确认转换路径
|
|
@@ -266,17 +269,15 @@ echo 114.0 30.5 | cs2cs EPSG:4326 EPSG:4547
|
|
|
266
269
|
projinfo -s EPSG:4326 -t EPSG:4547 --summary
|
|
267
270
|
|
|
268
271
|
# 再用 cs2cs 执行,必要时强制使用最佳转换
|
|
269
|
-
echo 114.0
|
|
272
|
+
echo 30.5 114.0 | cs2cs EPSG:4326 EPSG:4547 --only-best
|
|
270
273
|
```
|
|
271
274
|
|
|
272
275
|
### 模式 4:批量转换坐标文本
|
|
273
276
|
|
|
274
277
|
```bash
|
|
275
278
|
#!/bin/bash
|
|
276
|
-
# 输入文件每行 "lon
|
|
277
|
-
|
|
278
|
-
echo "$lat $lon" | cs2cs EPSG:4326 EPSG:3857
|
|
279
|
-
done < points.txt > points_3857.txt
|
|
279
|
+
# 输入文件每行 "lat lon"(纬度在前,与 EPSG:4326 轴序一致)
|
|
280
|
+
cs2cs EPSG:4326 EPSG:3857 points.txt > points_3857.txt
|
|
280
281
|
```
|
|
281
282
|
|
|
282
283
|
### 模式 5:为缺失网格下载数据
|
|
@@ -285,7 +286,7 @@ done < points.txt > points_3857.txt
|
|
|
285
286
|
# 按目标区域下载转换网格后执行高精度转换
|
|
286
287
|
projsync --bbox 73,18,135,54
|
|
287
288
|
export PROJ_NETWORK=ON
|
|
288
|
-
echo 116.391
|
|
289
|
+
echo 39.907 116.391 | cs2cs EPSG:4326 EPSG:4547 --only-best
|
|
289
290
|
```
|
|
290
291
|
|
|
291
292
|
---
|
|
@@ -316,15 +317,14 @@ echo 116.391 39.907 | cs2cs EPSG:4326 EPSG:4547 --only-best
|
|
|
316
317
|
|
|
317
318
|
---
|
|
318
319
|
|
|
319
|
-
##
|
|
320
|
-
|
|
321
|
-
- **官方文档:** <https://proj.org/> | [命令行工具](https://proj.org/en/stable/apps/index.html) | [快速上手](https://proj.org/en/stable/usage/quickstart.html) | [资源文件与 proj.db](https://proj.org/en/stable/resource_files.html)
|
|
322
|
-
- **工具手册:** [projinfo](https://proj.org/en/stable/apps/projinfo.html) | [cs2cs](https://proj.org/en/stable/apps/cs2cs.html) | [proj](https://proj.org/en/stable/apps/proj.html) | [projsync](https://proj.org/en/stable/apps/projsync.html)
|
|
323
|
-
- **转换原理:** <https://proj.org/en/stable/operations/operations_computation.html>
|
|
324
|
-
- **EPSG 代码查询:** <https://epsg.io/>
|
|
325
|
-
- **源码仓库:** <https://github.com/OSGeo/PROJ>
|
|
320
|
+
## AI 使用建议
|
|
326
321
|
|
|
327
|
-
|
|
322
|
+
- **执行环境**:命令在终端 / shell 中执行(Windows 用 PowerShell)。正文的 `export PROJ_DATA=...` 在 PowerShell 写作 `$env:PROJ_DATA = "C:\OSGeo4W\share\proj"`;heredoc(`<<EOF`)在 PowerShell 中不可用,改用管道 `"56 12" | cs2cs EPSG:4326 EPSG:25832` 或先把输入写成文件再重定向。
|
|
323
|
+
- **先探测版本**:`projinfo --version`(同时打印 `proj.db` 路径)、`projinfo --searchpaths`;本技能按 PROJ 9.9.0 编写,低于 9.1 用 `PROJ_LIB` 而非 `PROJ_DATA`,低于 9.3 的 `proj` 不能直接接受 `EPSG:xxxx`。
|
|
324
|
+
- **验证转换**:用已知点对拍——`echo "39.907 116.391" | cs2cs EPSG:4326 EPSG:32650` 应得到东坐标约 44 万、北坐标约 442 万,量级不对通常是轴序或单位问题;结构化核对用 `projinfo -o PROJJSON -q EPSG:4326`,转换路径用 `projinfo -s A -t B --summary` 看候选操作与精度。
|
|
325
|
+
- **轴序与降级**:`EPSG:4326` 纬度在前(输入先 lat 后 lon),`proj` 命令内部经度在前要用 `-r`;高精度转换加 `--only-best`,否则缺网格时会静默退回精度更低的操作。
|
|
326
|
+
- **大输出处理**:`projinfo EPSG:4326` 的 WKT 有上百行,重定向到文件再分段读取;批量转换把 `cs2cs EPSG:4326 EPSG:3857 points.txt` 一次跑完,不要逐行起进程。
|
|
327
|
+
- **安全与权限**:`projsync --all` 会从 CDN 下载数 GB 网格、`PROJ_NETWORK=ON` 也会联网,先确认网络与磁盘;`sqlite3 proj.db` 只做只读查询,不要写库;改 `PROJ_DATA` 会影响同机 GDAL/PostGIS,先征得用户同意。
|
|
328
328
|
|
|
329
329
|
## 相关技能
|
|
330
330
|
|
|
@@ -335,23 +335,10 @@ echo 116.391 39.907 | cs2cs EPSG:4326 EPSG:4547 --only-best
|
|
|
335
335
|
|
|
336
336
|
---
|
|
337
337
|
|
|
338
|
-
##
|
|
339
|
-
|
|
340
|
-
### 推荐工作流
|
|
341
|
-
|
|
342
|
-
1. **先查询、后转换**:任何转换前先用 `projinfo <code>` 确认 CRS 名称与轴序,再用 `projinfo -s A -t B` 确认转换路径。
|
|
343
|
-
```bash
|
|
344
|
-
projinfo EPSG:4490
|
|
345
|
-
projinfo -s EPSG:4326 -t EPSG:4547 --summary
|
|
346
|
-
```
|
|
347
|
-
2. **用结构化输出便于解析**:`projinfo -o PROJJSON -q EPSG:4326 | jq .`,避免解析缩进文本。
|
|
348
|
-
3. **点转换用 `cs2cs`,文件重投影用 GDAL**:`cs2cs` 只处理坐标流;`ogr2ogr -t_srs`/`gdalwarp -t_srs` 处理数据文件,二者共享 `PROJ_DATA`。
|
|
349
|
-
4. **高精度场景显式下载网格**:先 `projsync --bbox ...` 或设 `PROJ_NETWORK=ON`,再加 `--only-best` 验证。
|
|
350
|
-
5. **核对环境变量**:脚本中显式设置 `PROJ_DATA`,避免依赖不可控的默认搜索路径。
|
|
351
|
-
|
|
352
|
-
### 关键注意事项
|
|
338
|
+
## 参考资源
|
|
353
339
|
|
|
354
|
-
-
|
|
355
|
-
-
|
|
356
|
-
-
|
|
357
|
-
-
|
|
340
|
+
- **官方文档:** <https://proj.org/> | [命令行工具](https://proj.org/en/stable/apps/index.html) | [快速上手](https://proj.org/en/stable/usage/quickstart.html) | [资源文件与 proj.db](https://proj.org/en/stable/resource_files.html)
|
|
341
|
+
- **工具手册:** [projinfo](https://proj.org/en/stable/apps/projinfo.html) | [cs2cs](https://proj.org/en/stable/apps/cs2cs.html) | [proj](https://proj.org/en/stable/apps/proj.html) | [projsync](https://proj.org/en/stable/apps/projsync.html)
|
|
342
|
+
- **转换原理:** <https://proj.org/en/stable/operations/operations_computation.html>
|
|
343
|
+
- **EPSG 代码查询:** <https://epsg.io/>
|
|
344
|
+
- **源码仓库:** <https://github.com/OSGeo/PROJ>
|
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: projnet4geoapi
|
|
3
|
+
description: "Use when transforming coordinates or reading CRS definitions in .NET with ProjNet 2.1.0 (NuGet ProjNet, repo ProjNet4GeoAPI) — CoordinateSystemFactory.CreateFromWkt, CoordinateTransformationFactory.CreateFromCoordinateSystems, MathTransform.Transform, CoordinateSystemServices SRID registration. Also for 'no suitable transformation' / null from GetCoordinateSystem, EPSG codes beyond 4326 and 3857 returning null, and SharpMap projects needing the legacy ProjNet4GeoAPI 1.4.1 GeoAPI build."
|
|
4
|
+
tags:
|
|
5
|
+
- dotnet
|
|
6
|
+
- csharp
|
|
7
|
+
- coordinate-systems
|
|
8
|
+
- projection
|
|
9
|
+
- epsg
|
|
10
|
+
- wkt
|
|
11
|
+
- geospatial
|
|
12
|
+
- netstandard
|
|
13
|
+
- sharpmap
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
> **项目地址:** <https://github.com/NetTopologySuite/ProjNet4GeoAPI>
|
|
17
|
+
>
|
|
18
|
+
> **NuGet(2.x):** `ProjNet` 2.1.0(netstandard2.0 / netstandard2.1,截至 2026-10)
|
|
19
|
+
>
|
|
20
|
+
> **NuGet(1.x,旧版):** `ProjNet4GeoAPI` 1.4.1(面向 GeoAPI 接口的项目,如 SharpMap 1.2)
|
|
21
|
+
>
|
|
22
|
+
> **官方文档:** <https://github.com/NetTopologySuite/ProjNet4GeoAPI/wiki>
|
|
23
|
+
>
|
|
24
|
+
> **许可证:** LGPL-2.1-or-later
|
|
25
|
+
>
|
|
26
|
+
> **维护状态:** 上游 README 明确说明维护资源不足,官方给出的替代方案是 SharpProj、DotSpatial.Projections、GDAL;新项目在需要完整 EPSG 支持时应优先考虑这些方案。
|
|
27
|
+
|
|
28
|
+
## 概述
|
|
29
|
+
|
|
30
|
+
ProjNet 是 SharpMap 时代延续下来的 .NET 坐标参考系与投影引擎,按 OGC Simple Features 模型描述坐标系,负责「点对点」的坐标转换:源坐标系 → 目标坐标系,中间可能包含基准面转换(datum transformation)。它不提供地图渲染,也不自带 EPSG 数据库,坐标系定义要么用内置常量(WGS84、WebMercator),要么由调用方提供 WKT。
|
|
31
|
+
|
|
32
|
+
- **坐标系模型**:地理坐标系、地心坐标系、投影坐标系、垂直坐标系、复合坐标系
|
|
33
|
+
- **转换能力**:基准面转换、地理↔投影、投影↔投影,支持 Albers、Mercator、Transverse Mercator、Lambert Conformal Conic、Polar Stereographic、Krovak 等常用投影
|
|
34
|
+
- **定义读写**:WKT 与 XML 互转(`CreateFromWkt` / `CreateFromXml`)
|
|
35
|
+
- **服务容器**:`CoordinateSystemServices` 维护 SRID → 坐标系映射与转换工厂,默认只注册 EPSG:4326 与 EPSG:3857
|
|
36
|
+
- **两代包**:2.x 用自带类型体系(`ProjNet.CoordinateSystems`),1.x 实现 GeoAPI 接口供 SharpMap 等老库使用
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## 环境准备
|
|
41
|
+
|
|
42
|
+
### 安装(.NET 6+ / netstandard2.0 兼容项目)
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
# 2.x 系列(推荐)
|
|
46
|
+
dotnet add package ProjNet --version 2.1.0
|
|
47
|
+
|
|
48
|
+
# 1.x 系列:只在必须实现 GeoAPI 接口的老项目里使用(如 SharpMap 1.2)
|
|
49
|
+
dotnet add package ProjNet4GeoAPI --version 1.4.1
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
```powershell
|
|
53
|
+
# Package Manager Console
|
|
54
|
+
Install-Package ProjNet -Version 2.1.0
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
两个包的程序集名都是 `ProjNET.dll`,**不能同时引用**;同时引用会出现类型冲突与「找到多个同名类型」的编译错误。
|
|
58
|
+
|
|
59
|
+
### 验证
|
|
60
|
+
|
|
61
|
+
```csharp
|
|
62
|
+
using ProjNet.CoordinateSystems;
|
|
63
|
+
using ProjNet.CoordinateSystems.Transformations;
|
|
64
|
+
|
|
65
|
+
var src = GeographicCoordinateSystem.WGS84;
|
|
66
|
+
var tgt = ProjectedCoordinateSystem.WebMercator;
|
|
67
|
+
var transform = new CoordinateTransformationFactory()
|
|
68
|
+
.CreateFromCoordinateSystems(src, tgt);
|
|
69
|
+
|
|
70
|
+
double[] xy = transform.MathTransform.Transform(new[] {116.397, 39.908});
|
|
71
|
+
Console.WriteLine($"{xy[0]:F2}, {xy[1]:F2}"); // 约 12957254.80, 4852582.10
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
dotnet run # 能打印出 Web Mercator 米制坐标即环境正常
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### 目标框架
|
|
79
|
+
|
|
80
|
+
| 包 | 目标框架 | 说明 |
|
|
81
|
+
|----|----------|------|
|
|
82
|
+
| `ProjNet` 2.1.0 | netstandard2.0 / netstandard2.1 | .NET Framework 4.6.1+、.NET 6/8/9 均可引用;netstandard2.0 版本额外依赖 `System.Memory` 4.6.0 |
|
|
83
|
+
| `ProjNet4GeoAPI` 1.4.1 | net35-client / net40-client / net45 / netstandard2.0 | 2018 年发布,只为兼容 GeoAPI 生态 |
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## 核心 API
|
|
88
|
+
|
|
89
|
+
### 坐标系工厂
|
|
90
|
+
|
|
91
|
+
```csharp
|
|
92
|
+
using ProjNet.CoordinateSystems;
|
|
93
|
+
|
|
94
|
+
var factory = new CoordinateSystemFactory();
|
|
95
|
+
|
|
96
|
+
// 从 WKT 解析(EPSG 官网、GDAL 的 projinfo、QGIS 都能导出 WKT)
|
|
97
|
+
CoordinateSystem wgs84Utm50 = factory.CreateFromWkt(wktText);
|
|
98
|
+
|
|
99
|
+
// 从 XML 解析
|
|
100
|
+
CoordinateSystem fromXml = factory.CreateFromXml(xmlText);
|
|
101
|
+
|
|
102
|
+
// 组合式构造:以已有地理坐标系 + 投影参数创建投影坐标系
|
|
103
|
+
var gcs = GeographicCoordinateSystem.WGS84;
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
| 成员 | 说明 |
|
|
107
|
+
|------|------|
|
|
108
|
+
| `CreateFromWkt(string)` | 解析 WKT,返回 `CoordinateSystem`;失败时可能返回 `null` |
|
|
109
|
+
| `CreateFromXml(string)` | 解析 ProjNet 自身的 XML 表示 |
|
|
110
|
+
| `CreateProjectedCoordinateSystem(...)` | 手工组装投影坐标系(名称、地理坐标系、投影、线性单位、轴) |
|
|
111
|
+
| `CreateGeographicCoordinateSystem(...)` | 手工组装地理坐标系(角度单位、基准面、本初子午线、轴) |
|
|
112
|
+
| `CreateProjection(name, className, parameters)` | 按投影类名与参数创建投影 |
|
|
113
|
+
|
|
114
|
+
内置常量只有少数几个:`GeographicCoordinateSystem.WGS84`、`ProjectedCoordinateSystem.WebMercator`。其余坐标系必须自带 WKT。
|
|
115
|
+
|
|
116
|
+
### 坐标转换
|
|
117
|
+
|
|
118
|
+
```csharp
|
|
119
|
+
using ProjNet.CoordinateSystems;
|
|
120
|
+
using ProjNet.CoordinateSystems.Transformations;
|
|
121
|
+
|
|
122
|
+
var ctFactory = new CoordinateTransformationFactory();
|
|
123
|
+
ICoordinateTransformation ct = ctFactory.CreateFromCoordinateSystems(
|
|
124
|
+
sourceCS: factory.CreateFromWkt(wgs84Wkt),
|
|
125
|
+
targetCS: factory.CreateFromWkt(cgcs2000GaussKrugerWkt));
|
|
126
|
+
|
|
127
|
+
MathTransform mt = ct.MathTransform;
|
|
128
|
+
|
|
129
|
+
// 单点
|
|
130
|
+
double[] projected = mt.Transform(new[] {116.397, 39.908});
|
|
131
|
+
|
|
132
|
+
// 单点(元组重载,免去数组分配)
|
|
133
|
+
var (x, y) = mt.Transform(116.397, 39.908);
|
|
134
|
+
|
|
135
|
+
// 多点:一次调用处理整批,比循环 new 数组快得多
|
|
136
|
+
double[][] points = {new[] {116.0, 39.0}, new[] {117.0, 40.0}};
|
|
137
|
+
IList<double[]> projectedPoints = mt.TransformList(points);
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
| 类型 / 成员 | 说明 |
|
|
141
|
+
|-------------|------|
|
|
142
|
+
| `ICoordinateTransformation.SourceCS` / `TargetCS` | 源与目标坐标系 |
|
|
143
|
+
| `ICoordinateTransformation.MathTransform` | 实际执行数值转换的数学变换 |
|
|
144
|
+
| `MathTransform.Transform(double[])` | 单点转换,输入 `[x, y]` 或 `[x, y, z]`,维度由变换决定 |
|
|
145
|
+
| `MathTransform.Transform(double x, double y)` | 元组重载,返回 `(x, y)` |
|
|
146
|
+
| `MathTransform.TransformList(IList<double[]>)` | 批量转换,返回转换后的点数组列表 |
|
|
147
|
+
| `MathTransform.Transform(Span<double> xs, Span<double> ys)` | 分离数组的 SOA 批量转换,适合大数组 |
|
|
148
|
+
| `MathTransform.Inverse()` | 取逆变换,用于反向换算 |
|
|
149
|
+
|
|
150
|
+
坐标按 `x, y` 顺序解释(经度/东坐标在前,纬度/北坐标在后),ProjNet **不做轴序交换**;若拿到的 WKT 声明了 `AXIS["Latitude", NORTH]` 之类的轴序,需要调用方自行判断是否交换。
|
|
151
|
+
|
|
152
|
+
### CoordinateSystemServices:SRID 与转换缓存
|
|
153
|
+
|
|
154
|
+
```csharp
|
|
155
|
+
using ProjNet.CoordinateSystems;
|
|
156
|
+
using ProjNet.CoordinateSystems.Transformations;
|
|
157
|
+
|
|
158
|
+
var services = new CoordinateSystemServices();
|
|
159
|
+
|
|
160
|
+
// 默认只有 4326 与 3857
|
|
161
|
+
var wgs84 = services.GetCoordinateSystem(4326);
|
|
162
|
+
var mercator = services.GetCoordinateSystem(3857);
|
|
163
|
+
|
|
164
|
+
// 注册任意 EPSG 编码(值为 WKT 字符串)
|
|
165
|
+
var defs = new[]
|
|
166
|
+
{
|
|
167
|
+
new KeyValuePair<int, string>(4490, cgcs2000Wkt),
|
|
168
|
+
new KeyValuePair<int, string>(4547, cgcs2000GkCmwWkt),
|
|
169
|
+
};
|
|
170
|
+
var withDefs = new CoordinateSystemServices(defs);
|
|
171
|
+
|
|
172
|
+
ICoordinateTransformation ct = withDefs.CreateTransformation(4490, 4547);
|
|
173
|
+
double[] xy = ct.MathTransform.Transform(new[] {116.397, 39.908});
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
| 成员 | 说明 |
|
|
177
|
+
|------|------|
|
|
178
|
+
| `new CoordinateSystemServices()` | 默认注册 4326、3857 两个坐标系 |
|
|
179
|
+
| `new CoordinateSystemServices(IEnumerable<KeyValuePair<int,string>>)` | 用 SRID → WKT 批量注册 |
|
|
180
|
+
| `GetCoordinateSystem(int srid)` | 按 SRID 取坐标系;未注册返回 `null` |
|
|
181
|
+
| `GetCoordinateSystem(string authority, long code)` | 按授权名与编码取(内部仍走 SRID 映射) |
|
|
182
|
+
| `GetSRID(string authority, long code)` | 反查 SRID,未注册返回 `null` |
|
|
183
|
+
| `CreateTransformation(int sourceSrid, int targetSrid)` | 按 SRID 建转换,最常用 |
|
|
184
|
+
| `CreateTransformation(CoordinateSystem, CoordinateSystem)` | 按对象建转换 |
|
|
185
|
+
|
|
186
|
+
失败的 WKT 会被静默跳过:`CreateCoordinateSystem` 内部捕获异常并返回 `null`,因此「注册了但查不到」优先怀疑 WKT 本身不被支持(例如带 `ELLIPSOID` 关键字或使用了未实现的投影)。
|
|
187
|
+
|
|
188
|
+
---
|
|
189
|
+
|
|
190
|
+
## 典型工作流
|
|
191
|
+
|
|
192
|
+
把一批 WGS84 经纬度点位转换到 CGCS2000 3 度带高斯-克吕格投影(EPSG:4547),并写回 CSV:
|
|
193
|
+
|
|
194
|
+
**输入**:`points.csv`(`lon,lat`)
|
|
195
|
+
**输出**:`points_projected.csv`(`lon,lat,x,y`)
|
|
196
|
+
|
|
197
|
+
1. 用 `projinfo`(PROJ 命令行)导出目标坐标系的 WKT,避免手写投影参数
|
|
198
|
+
2. 在代码里用 `CoordinateSystemServices` 注册 4490 与 4547
|
|
199
|
+
3. 批量读取点位,调用 `MathTransform.Transform` 逐点或打包转换
|
|
200
|
+
4. 输出前校验坐标量级(高斯投影的东坐标通常在 6 位数字量级)
|
|
201
|
+
|
|
202
|
+
```bash
|
|
203
|
+
# 导出 WKT(PROJ 9.x)
|
|
204
|
+
projinfo EPSG:4547 -o WKT2:2019
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
```csharp
|
|
208
|
+
using System.Globalization;
|
|
209
|
+
using ProjNet.CoordinateSystems;
|
|
210
|
+
using ProjNet.CoordinateSystems.Transformations;
|
|
211
|
+
|
|
212
|
+
var cgcs2000 = File.ReadAllText("wkt/epsg4490.wkt");
|
|
213
|
+
var gk3d = File.ReadAllText("wkt/epsg4547.wkt");
|
|
214
|
+
|
|
215
|
+
var services = new CoordinateSystemServices(new[]
|
|
216
|
+
{
|
|
217
|
+
new KeyValuePair<int, string>(4490, cgcs2000),
|
|
218
|
+
new KeyValuePair<int, string>(4547, gk3d),
|
|
219
|
+
});
|
|
220
|
+
|
|
221
|
+
var ct = services.CreateTransformation(4490, 4547);
|
|
222
|
+
var mt = ct.MathTransform;
|
|
223
|
+
|
|
224
|
+
using var reader = new StreamReader("points.csv");
|
|
225
|
+
using var writer = new StreamWriter("points_projected.csv");
|
|
226
|
+
writer.WriteLine("lon,lat,x,y");
|
|
227
|
+
|
|
228
|
+
reader.ReadLine(); // 跳过表头
|
|
229
|
+
string? line;
|
|
230
|
+
while ((line = reader.ReadLine()) is not null)
|
|
231
|
+
{
|
|
232
|
+
var parts = line.Split(',');
|
|
233
|
+
double lon = double.Parse(parts[0], CultureInfo.InvariantCulture);
|
|
234
|
+
double lat = double.Parse(parts[1], CultureInfo.InvariantCulture);
|
|
235
|
+
|
|
236
|
+
double[] xy = mt.Transform(new[] {lon, lat});
|
|
237
|
+
writer.WriteLine(string.Join(",",
|
|
238
|
+
lon.ToString(CultureInfo.InvariantCulture),
|
|
239
|
+
lat.ToString(CultureInfo.InvariantCulture),
|
|
240
|
+
xy[0].ToString("F3", CultureInfo.InvariantCulture),
|
|
241
|
+
xy[1].ToString("F3", CultureInfo.InvariantCulture)));
|
|
242
|
+
}
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
**检查点**:转换后东坐标应是 6 位数(含带号则 8 位),北坐标在 0–5000000 量级;若数值仍是 116 / 39 这样的量级,说明取错了坐标系或 WKT 解析失败被静默跳过。
|
|
246
|
+
|
|
247
|
+
---
|
|
248
|
+
|
|
249
|
+
## 最佳实践
|
|
250
|
+
|
|
251
|
+
1. **WKT 由专业工具生成**:用 `projinfo`、`gdalsrsinfo` 或 EPSG 官网导出,不要手写 `PROJCS` 字符串,参数顺序错一位结果就偏
|
|
252
|
+
2. **一次构造、复用实例**:`CoordinateTransformationFactory`、`CoordinateSystemFactory` 与 `MathTransform` 都可复用,避免在循环里重复解析 WKT
|
|
253
|
+
3. **批量用 `TransformList` 或 `Span` 重载**:`MathTransform.TransformList(IList<double[]>)` 一次处理整批点;SOA 结构的大数组用 `Transform(Span<double> xs, Span<double> ys)` 避免装箱
|
|
254
|
+
4. **校验转换前后的量级与范围**:投影坐标是米,经纬度是度;写一条断言比肉眼检查可靠
|
|
255
|
+
5. **明确轴序**:ProjNet 只做 `x, y` 算术,不理会 WKT 的 `AXIS` 声明,跨系统交换数据时显式约定顺序
|
|
256
|
+
6. **坐标是数值不是几何**:ProjNet 只处理点数组,几何对象的转换要自己遍历坐标(或用 NTS 的坐标过滤器)
|
|
257
|
+
7. **考虑替代方案**:需要完整 EPSG 库、网格文件(NTv2/GTX)或 3D 基准转换时,用 SharpProj 或 GDAL,不要指望 ProjNet 覆盖
|
|
258
|
+
|
|
259
|
+
---
|
|
260
|
+
|
|
261
|
+
## 常见问题
|
|
262
|
+
|
|
263
|
+
| 问题 | 原因与解决 |
|
|
264
|
+
|------|------------|
|
|
265
|
+
| `CreateFromCoordinateSystems` 返回 `null` 或抛异常 | 源/目标坐标系类型组合不受支持(如两个地理坐标系之间只差基准面而缺少转换参数):改用「地理 → 投影」或先转 WGS84 再转目标 |
|
|
266
|
+
| `GetCoordinateSystem(4490)` 返回 `null` | `CoordinateSystemServices` 默认只注册 4326 与 3857:用 SRID → WKT 的构造函数注册,或直接 `CreateFromWkt` |
|
|
267
|
+
| 转换结果与 QGIS/GDAL 差几十米 | ProjNet 没有网格文件与最新基准面参数,只做近似七参数/三参数转换:高精度场景改用 SharpProj 或 GDAL |
|
|
268
|
+
| 注册了 WKT 但查不到坐标系 | `CreateCoordinateSystem` 会吞掉解析异常:先用 `new CoordinateSystemFactory().CreateFromWkt(wkt)` 单独验证,确认返回非 `null` |
|
|
269
|
+
| 经纬度转换结果是反的 | 输入数组按 `[x, y]` 解释,即经度在前:把 `[lat, lon]` 改成 `[lon, lat]` |
|
|
270
|
+
| 同时引用两个包后大量类型冲突 | `ProjNet` 2.x 与 `ProjNet4GeoAPI` 1.x 程序集同名:只保留一个;SharpMap 1.2 项目必须用 1.4.1 |
|
|
271
|
+
| 老项目里 `CoordinateTransformation` 赋值编译失败 | SharpMap 1.2 期望 GeoAPI 的 `ICoordinateTransformation`,2.x 不再实现该接口:换成 `ProjNet4GeoAPI` 1.4.1 |
|
|
272
|
+
| 大文件转换极慢 | 在循环里反复解析 WKT 或逐点 new 转换对象:把工厂、坐标系、`MathTransform` 提到循环外,并用打包数组接口 |
|
|
273
|
+
|
|
274
|
+
---
|
|
275
|
+
|
|
276
|
+
## AI 使用建议
|
|
277
|
+
|
|
278
|
+
- **执行环境**:`dotnet add package`、`dotnet build`、`dotnet run` 在终端中执行;首次 restore 需要访问 NuGet,失败时先看是否离线。
|
|
279
|
+
- **先探测版本**:`dotnet list package` 确认是 `ProjNet 2.1.0` 还是 `ProjNet4GeoAPI 1.4.1`——两者的命名空间与接口完全不同,写代码前必须确认,不要凭 `using ProjNet.CoordinateSystems` 猜。
|
|
280
|
+
- **WKT 来源**:让用户提供或先跑 `projinfo EPSG:xxxx -o WKT2:2019` 生成,再写进示例;不要凭空编造 `PROJCS` 参数。
|
|
281
|
+
- **验证产物**:编译后运行最小断言(如 116.397, 39.908 → Web Mercator 约 (12957254.8, 4852582.1)),数值量级不对就说明坐标系或轴序取错。
|
|
282
|
+
- **失败信号**:`null` 返回值优先怀疑 WKT 解析;结果偏差固定为几十米量级,是缺少网格文件而非代码错误。
|
|
283
|
+
- **安全与权限**:新建工程、装包前征得用户同意;示例里的 WKT 文件路径用占位符,不要写入用户真实数据路径。
|
|
284
|
+
|
|
285
|
+
## 相关技能
|
|
286
|
+
|
|
287
|
+
- **nettopologysuite** — .NET 几何运算,常与 ProjNet 搭配做「几何转换 + 空间分析」:[../nettopologysuite/SKILL.md](../nettopologysuite/SKILL.md)
|
|
288
|
+
- **sharpmap** — 旧版 .NET 地图渲染库,坐标变换依赖 ProjNet/ProjNet4GeoAPI:[../sharpmap/SKILL.md](../sharpmap/SKILL.md)
|
|
289
|
+
- **mapsui** — 现代跨平台 .NET 地图组件,新项目优先考虑:[../mapsui/SKILL.md](../mapsui/SKILL.md)
|
|
290
|
+
- **proj** — PROJ 命令行,用于导出 WKT 与核对转换结果:[../proj/SKILL.md](../proj/SKILL.md)
|
|
291
|
+
- **gdal** — GDAL/OGR 命令行,可做高精度重投影与批量转换:[../gdal/SKILL.md](../gdal/SKILL.md)
|
|
292
|
+
|
|
293
|
+
## 参考资源
|
|
294
|
+
|
|
295
|
+
- Wiki(FAQ、常用 WKT):<https://github.com/NetTopologySuite/ProjNet4GeoAPI/wiki>
|
|
296
|
+
- 源码:<https://github.com/NetTopologySuite/ProjNet4GeoAPI>
|
|
297
|
+
- NuGet(2.x):<https://www.nuget.org/packages/ProjNet>
|
|
298
|
+
- NuGet(1.x):<https://www.nuget.org/packages/ProjNet4GeoAPI>
|
|
299
|
+
- EPSG 坐标系查询:<https://epsg.org/>(EPSG 官方注册库;<https://spatialreference.org/> 可查 OGC WKT)
|