@dsh-gis/dsh-opengis-skill 0.1.3 → 0.3.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.
Files changed (117) hide show
  1. package/CHANGELOG.md +95 -0
  2. package/README.md +68 -28
  3. package/THIRD_PARTY_NOTICES.md +9 -0
  4. package/adaptations/brutile.md +8 -0
  5. package/adaptations/cesiumjs.md +8 -0
  6. package/adaptations/common.md +19 -0
  7. package/adaptations/deck-gl.md +8 -0
  8. package/adaptations/duckdb-spatial.md +8 -0
  9. package/adaptations/gdal-api.md +8 -0
  10. package/adaptations/gdal.md +8 -0
  11. package/adaptations/geolibre.md +8 -0
  12. package/adaptations/geometry-api-java.md +8 -0
  13. package/adaptations/geometry-api-net.md +8 -0
  14. package/adaptations/geonode.md +8 -0
  15. package/adaptations/geopandas.md +8 -0
  16. package/adaptations/geopipe-agent.md +8 -0
  17. package/adaptations/geoserver-cloud.md +8 -0
  18. package/adaptations/geoserver-rest-api.md +8 -0
  19. package/adaptations/geoserver.md +8 -0
  20. package/adaptations/geotools.md +8 -0
  21. package/adaptations/grass-gis.md +8 -0
  22. package/adaptations/jts.md +8 -0
  23. package/adaptations/kepler-gl.md +8 -0
  24. package/adaptations/leaflet.md +8 -0
  25. package/adaptations/mapbox-gl-js.md +8 -0
  26. package/adaptations/mapserver.md +8 -0
  27. package/adaptations/mapsui.md +8 -0
  28. package/adaptations/nettopologysuite.md +8 -0
  29. package/adaptations/opengis-all.md +9 -0
  30. package/adaptations/opengis-daf.md +9 -0
  31. package/adaptations/opengis-utils-for-java.md +8 -0
  32. package/adaptations/opengis-utils-for-net.md +8 -0
  33. package/adaptations/openlayers.md +8 -0
  34. package/adaptations/pdal.md +8 -0
  35. package/adaptations/postgis.md +8 -0
  36. package/adaptations/proj.md +8 -0
  37. package/adaptations/projnet4geoapi.md +8 -0
  38. package/adaptations/pyqgis.md +8 -0
  39. package/adaptations/qgis-process.md +8 -0
  40. package/adaptations/qgis-server.md +8 -0
  41. package/adaptations/shapely.md +8 -0
  42. package/adaptations/sharpmap.md +8 -0
  43. package/adaptations/spatialite.md +8 -0
  44. package/adaptations/whitebox-tools.md +8 -0
  45. package/assets/brutile/SKILL.md +283 -0
  46. package/assets/cesiumjs/SKILL.md +81 -35
  47. package/assets/deck-gl/SKILL.md +26 -34
  48. package/assets/duckdb-spatial/SKILL.md +363 -0
  49. package/assets/gdal/SKILL.md +55 -33
  50. package/assets/gdal/reference/raster-tools.md +14 -0
  51. package/assets/gdal/reference/vector-tools.md +5 -0
  52. package/assets/gdal-api/SKILL.md +12 -18
  53. package/assets/gdal-api/reference/raster-api.md +7 -0
  54. package/assets/gdal-api/reference/vector-api.md +9 -0
  55. package/assets/geolibre/SKILL.md +357 -0
  56. package/assets/geometry-api-java/SKILL.md +10 -16
  57. package/assets/geometry-api-net/SKILL.md +70 -32
  58. package/assets/geometry-api-net/reference/geometry-types.md +5 -0
  59. package/assets/geonode/SKILL.md +340 -0
  60. package/assets/geopandas/SKILL.md +21 -24
  61. package/assets/geopandas/reference/core-api.md +4 -0
  62. package/assets/geopipe-agent/SKILL.md +29 -31
  63. package/assets/geopipe-agent/reference/steps-reference.md +12 -0
  64. package/assets/geopipe-agent/reference/workflows.md +8 -0
  65. package/assets/geoserver/SKILL.md +10 -15
  66. package/assets/geoserver-cloud/SKILL.md +25 -33
  67. package/assets/geoserver-rest-api/SKILL.md +17 -19
  68. package/assets/geoserver-rest-api/reference/endpoints.md +16 -0
  69. package/assets/geotools/SKILL.md +12 -17
  70. package/assets/geotools/reference/raster-rendering.md +5 -0
  71. package/assets/geotools/reference/vector-io.md +7 -0
  72. package/assets/grass-gis/SKILL.md +26 -33
  73. package/assets/jts/SKILL.md +12 -16
  74. package/assets/jts/reference/geometry-operations.md +13 -0
  75. package/assets/kepler-gl/SKILL.md +306 -0
  76. package/assets/leaflet/SKILL.md +58 -40
  77. package/assets/mapbox-gl-js/SKILL.md +26 -33
  78. package/assets/mapserver/SKILL.md +21 -29
  79. package/assets/mapsui/SKILL.md +109 -63
  80. package/assets/nettopologysuite/SKILL.md +96 -31
  81. package/assets/opengis-all/SKILL.md +91 -289
  82. package/assets/opengis-all/reference/data-stages.md +269 -4
  83. package/assets/opengis-all/reference/workflow-cheatsheets.md +7 -0
  84. package/assets/opengis-daf/SKILL.md +10 -17
  85. package/assets/opengis-utils-for-java/SKILL.md +58 -49
  86. package/assets/opengis-utils-for-java/reference/common-tasks.md +16 -12
  87. package/assets/opengis-utils-for-net/SKILL.md +109 -48
  88. package/assets/opengis-utils-for-net/reference/code-patterns.md +15 -11
  89. package/assets/opengis-utils-for-net/reference/util-classes.md +35 -26
  90. package/assets/openlayers/SKILL.md +81 -28
  91. package/assets/pdal/SKILL.md +25 -27
  92. package/assets/postgis/SKILL.md +80 -35
  93. package/assets/proj/SKILL.md +32 -41
  94. package/assets/projnet4geoapi/SKILL.md +293 -0
  95. package/assets/pyqgis/SKILL.md +33 -30
  96. package/assets/pyqgis/reference/processing-rendering.md +6 -0
  97. package/assets/pyqgis/reference/vector-raster-layers.md +6 -0
  98. package/assets/qgis-process/SKILL.md +75 -33
  99. package/assets/qgis-process/reference/algorithm-cheatsheet.md +6 -0
  100. package/assets/qgis-server/SKILL.md +25 -31
  101. package/assets/shapely/SKILL.md +136 -84
  102. package/assets/shapely/reference/operations-reference.md +12 -0
  103. package/assets/sharpmap/SKILL.md +97 -60
  104. package/assets/spatialite/SKILL.md +358 -0
  105. package/assets/whitebox-tools/SKILL.md +262 -0
  106. package/lib/adaptations.d.ts +53 -0
  107. package/lib/adaptations.js +343 -0
  108. package/lib/catalog.d.ts +7 -1
  109. package/lib/catalog.js +9 -1
  110. package/lib/index.d.ts +10 -1
  111. package/lib/index.js +34 -3
  112. package/lib/skill-file.d.ts +12 -0
  113. package/lib/skill-file.js +133 -18
  114. package/locale/en.json +1 -1
  115. package/locale/zh.json +1 -1
  116. package/package.json +12 -2
  117. package/upstream.json +73 -57
@@ -1,23 +1,17 @@
1
1
  ---
2
2
  name: mapserver
3
3
  description: "Use when publishing WMS/WFS/WCS/OGC API Features from a MapServer 8.6.6 .map mapfile — MAP/LAYER/CLASS/STYLE objects, STATUS/PROJECTION/EXTENT errors, WEB.METADATA wms_enable_request and wfs_enable_request, SLD binding, FastCGI plus MS_MAP_PATTERN hardening, and blank GetMap / \"No query information to decode\" symptoms."
4
- tags:
5
- - c
6
- - server
7
- - wms
8
- - wfs
9
- - wcs
10
- - ogc
11
- - mapfile
12
- - cgi
13
- - web
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "c, server, wms, wfs, wcs, ogc, mapfile, cgi, web"
14
8
  ---
15
9
 
16
10
  > **项目地址:** <https://github.com/MapServer/MapServer>
17
11
  >
18
12
  > **官方文档:** <https://mapserver.org/>
19
13
  >
20
- > **最新版本:** 8.6.6(rel-8-6-6,[发布记录](https://github.com/MapServer/MapServer/releases))
14
+ > **最新版本:** 8.6.6(rel-8-6-6,2026-09-06 发布,截至 2026-11;[发布记录](https://github.com/MapServer/MapServer/releases))
21
15
  >
22
16
  > **许可证:** MIT
23
17
 
@@ -52,12 +46,13 @@ sudo systemctl restart apache2
52
46
 
53
47
  ### 方式二:源码编译(CMake)
54
48
 
55
- MapServer 8.x 需要支持 C++11/C99 的编译器,8.4.0 起要求 CMake 3.16+。先装依赖(GDAL、PROJ、libpng、FreeType、zlib、libcurl 为常用项):
49
+ MapServer 8.0 起需要支持 C++11/C99 的编译器;8.4.0 起要求 CMake 3.16+(官方 Unix 安装文档实测)。先装依赖(GDAL、PROJ、libpng、FreeType、zlib、libcurl 为常用项):
56
50
 
57
51
  ```bash
58
52
  sudo apt install -y build-essential cmake libgdal-dev libproj-dev \
59
53
  libpng-dev libfreetype6-dev zlib1g-dev libcurl4-openssl-dev
60
54
 
55
+ curl -fLO https://download.osgeo.org/mapserver/mapserver-8.6.6.tar.gz
61
56
  tar -zxvf mapserver-8.6.6.tar.gz
62
57
  cd mapserver-8.6.6 && mkdir build && cd build
63
58
  cmake -DCMAKE_INSTALL_PREFIX=/opt \
@@ -265,16 +260,14 @@ ogr2ogr -f GPKG clip.gpkg countries.gpkg -clipsrc 100 20 130 50
265
260
 
266
261
  ---
267
262
 
268
- ## 参考资源
263
+ ## AI 使用建议
269
264
 
270
- - 官方文档:<https://mapserver.org/>
271
- - Unix 编译安装:<https://mapserver.org/installation/unix.html>
272
- - Mapfile 参考:<https://mapserver.org/mapfile/index.html>
273
- - WMS Server:<https://mapserver.org/ogc/wms_server.html>
274
- - WFS Server:<https://mapserver.org/ogc/wfs_server.html>
275
- - 在线示例服务:<https://demo.mapserver.org/>
276
-
277
- ---
265
+ - **执行环境**:命令在终端 / shell 中执行(Windows 用 OSGeo4W 的 `mapserv.exe`);`sudo apt`、`tar -zxvf` 不跨平台,Windows 改 `Expand-Archive`,装包或改系统目录前先问用户。
266
+ - **先探测版本**:`mapserv -v`,确认输出含 `MapServer version 8.6.6` 且 `SUPPORTS=` 里有需要的 `WMS_SERVER`/`WFS_SERVER`;缺项说明该构建没编进对应库,改 mapfile 无用。
267
+ - **验证产物**:先离线 `map2img -m demo.map -o out.png -s 600 400` 看渲染,再 `mapserv -nh "QUERY_STRING=map=/abs/demo.map&SERVICE=WMS&VERSION=1.1.1&REQUEST=GetCapabilities"` 抓能力文档,最后才 `curl -sI "http://host/cgi-bin/mapserv?map=...&REQUEST=GetMap..."` 确认 200 与 `Content-Type: image/png`。
268
+ - **排障分流**:空白图查 `EXTENT`/`BBOX`/`PROJECTION`/`STATUS ON`;能力文档缺图层查 `wms_enable_request`、`wfs_enable_request` 与 `NAME` 是否字母开头;WFS 无属性字段是 8.x 默认行为,补 `gml_include_items`。
269
+ - **安全与权限**:`map=` 可读任意路径是 MapServer 最典型误配置,生产必须设 `MS_MAP_PATTERN`/`MS_MAP_NO_PATH`;重启 Apache/nginx 或改 CGI 权限前先向用户确认。
270
+ - **改一处验一处**:改 `WEB.METADATA` 后只重跑 `GetCapabilities`,改 `LAYER` 样式后只重跑 `map2img`,缩小排查范围。
278
271
 
279
272
  ## 相关技能
280
273
 
@@ -285,12 +278,11 @@ ogr2ogr -f GPKG clip.gpkg countries.gpkg -clipsrc 100 20 130 50
285
278
 
286
279
  ---
287
280
 
288
- ## DeepSeek Harness 使用建议
281
+ ## 参考资源
289
282
 
290
- - **加载与引用**:`skill("mapserver")` 加载;技能目录只读,mapfile、SLD 与测试数据写到会话工作区。
291
- - **执行环境**:命令交给 dsh 的 `pwsh`(Windows 用 OSGeo4W 的 `mapserv.exe`);`sudo apt`、`tar -zxvf` 不跨平台,Windows 改 `Expand-Archive`,装包或改系统目录前先问用户。
292
- - **先探测版本**:`mapserv -v`,确认输出含 `MapServer version 8.6.6` 且 `SUPPORTS=` 里有需要的 `WMS_SERVER`/`WFS_SERVER`;缺项说明该构建没编进对应库,改 mapfile 无用。
293
- - **验证产物**:先离线 `map2img -m demo.map -o out.png -s 600 400` 看渲染,再 `mapserv -nh "QUERY_STRING=map=/abs/demo.map&SERVICE=WMS&VERSION=1.1.1&REQUEST=GetCapabilities"` 抓能力文档,最后才 `curl -sI "http://host/cgi-bin/mapserv?map=...&REQUEST=GetMap..."` 确认 200 与 `Content-Type: image/png`。
294
- - **排障分流**:空白图查 `EXTENT`/`BBOX`/`PROJECTION`/`STATUS ON`;能力文档缺图层查 `wms_enable_request`、`wfs_enable_request` 与 `NAME` 是否字母开头;WFS 无属性字段是 8.x 默认行为,补 `gml_include_items`。
295
- - **安全与权限**:`map=` 可读任意路径是 MapServer 最典型误配置,生产必须设 `MS_MAP_PATTERN`/`MS_MAP_NO_PATH`;重启 Apache/nginx 或改 CGI 权限前先向用户确认。
296
- - **改一处验一处**:改 `WEB.METADATA` 后只重跑 `GetCapabilities`,改 `LAYER` 样式后只重跑 `map2img`,缩小排查范围。
283
+ - 官方文档:<https://mapserver.org/>
284
+ - Unix 编译安装:<https://mapserver.org/installation/unix.html>
285
+ - Mapfile 参考:<https://mapserver.org/mapfile/index.html>
286
+ - WMS Server:<https://mapserver.org/ogc/wms_server.html>
287
+ - WFS Server:<https://mapserver.org/ogc/wfs_server.html>
288
+ - 在线示例服务:<https://demo.mapserver.org/>
@@ -1,24 +1,17 @@
1
1
  ---
2
2
  name: mapsui
3
3
  description: "Use when embedding interactive 2D maps in .NET desktop (WPF/WinUI/WinForms) or mobile (MAUI/Avalonia/Blazor) apps with Mapsui 5.1.0 (net8.0/net9.0) — Mapsui.Wpf/Mapsui.Maui packages, Map and Layers, OpenStreetMap.CreateTileLayer, Shapefile/GeoJSON via Mapsui.Nts, SphericalMercator.FromLonLat, or fixing a blank MapControl."
4
- tags:
5
- - dotnet
6
- - csharp
7
- - map
8
- - wpf
9
- - maui
10
- - avalonia
11
- - blazor
12
- - skia
13
- - wms
14
- - tiles
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "dotnet, csharp, map, wpf, maui, avalonia, blazor, skia, wms, tiles"
15
8
  ---
16
9
 
17
10
  > **项目地址:** <https://github.com/Mapsui/Mapsui>
18
11
  >
19
12
  > **官方文档:** <https://mapsui.com/v5/documentation/index.html>
20
13
  >
21
- > **最新版本:** 5.1.0(截至 2026-10,NuGet 稳定版;5.2.0-beta.1 为预发布)
14
+ > **最新版本:** 5.1.0(截至 2026-11,[NuGet `Mapsui`](https://www.nuget.org/packages/Mapsui) 稳定版;上游 5.2.0-beta.1 为预发布,未计入)
22
15
  >
23
16
  > **许可证:** MIT
24
17
 
@@ -36,11 +29,24 @@ tags:
36
29
  ## 安装
37
30
 
38
31
  ```bash
39
- dotnet add package Mapsui.Wpf # 或 Mapsui.Maui / Mapsui.Avalonia / ...
40
- dotnet add package Mapsui.Tiling
41
- dotnet add package Mapsui.Nts
32
+ # 按 UI 框架选一个
33
+ dotnet add package Mapsui.Wpf --version 5.1.0 # WPF(net8.0-windows / net9.0-windows)
34
+ dotnet add package Mapsui.Maui --version 5.1.0 # MAUI,或 Mapsui.Avalonia / Mapsui.WinUI / Mapsui.Blazor
35
+ # 按数据源按需追加
36
+ dotnet add package Mapsui.Tiling --version 5.1.0 # 瓦片底图
37
+ dotnet add package Mapsui.Nts --version 5.1.0 # NTS 几何 / Shapefile
42
38
  ```
43
39
 
40
+ ### 验证
41
+
42
+ ```bash
43
+ dotnet --list-sdks # 需 .NET 8/9 SDK
44
+ dotnet restore # 能解析 Mapsui 5.1.0 即包可用
45
+ dotnet build # 编译通过后才进入渲染验证
46
+ ```
47
+
48
+ > 所有 `Mapsui.*` 子包版本必须一致(同样写 5.1.0),混版会在运行时抛类型加载异常。
49
+
44
50
  ---
45
51
 
46
52
  ## WPF 入门
@@ -85,19 +91,27 @@ MapControl.Map = map;
85
91
  ```csharp
86
92
  using Mapsui.Nts;
87
93
  using Mapsui.Styles;
94
+ using NetTopologySuite;
88
95
 
89
- var features = new List<IFeature>();
90
- foreach (var f in geoJsonFeatures)
91
- features.Add(new GeometryFeature(f.Geometry) {
96
+ // 视图坐标系为 EPSG:3857,经纬度数据必须先投影
97
+ var factory = NtsGeometryServices.Instance.CreateGeometryFactory(3857);
98
+
99
+ var features = new List<IFeature>
100
+ {
101
+ new GeometryFeature(factory.CreatePoint(SphericalMercator.FromLonLat(116.397, 39.908).ToCoordinate()))
102
+ {
92
103
  Styles = { new VectorStyle {
93
104
  Fill = new Brush(Color.Red),
94
105
  Outline = new Pen(Color.Black, 1)
95
106
  }}
96
- });
107
+ }
108
+ };
97
109
 
98
110
  map.Layers.Add(new MemoryLayer("Roads") { Features = features, Style = null });
99
111
  ```
100
112
 
113
+ > 线/面要素用 `factory.CreateLineString(coords)` / `factory.CreatePolygon(shell, holes)`,坐标同样要先 `SphericalMercator.FromLonLat` 投影。
114
+
101
115
  ---
102
116
 
103
117
  ## Shapefile
@@ -130,13 +144,29 @@ map.Layers.Add(new TileLayer(mb));
130
144
 
131
145
  ## WMS
132
146
 
147
+ WMS 支持由主包 `Mapsui` 提供,命名空间 `Mapsui.Providers.Wms`,**没有**单独的 WMS NuGet 包。5.x 起必须用异步工厂 `WmsProvider.CreateAsync` 创建(旧的同步构造函数已不可用),再挂到 `ImageLayer` 上:
148
+
133
149
  ```csharp
150
+ using Mapsui.Layers;
134
151
  using Mapsui.Providers.Wms;
135
- var wms = new WmsProvider("https://demo.mapserver.org/cgi-bin/wms?",
136
- new[] { "continents" });
137
- map.Layers.Add(new ImageLayer("WMS") { DataSource = wms });
152
+ using Mapsui.Styles;
153
+
154
+ var wms = await WmsProvider.CreateAsync("https://demo.mapserver.org/cgi-bin/wms?", userAgent: "MyApp");
155
+ wms.CRS = "EPSG:3857"; // 请求用的 CRS,需与 Map 的 CRS 一致
156
+ wms.ContinueOnError = true;
157
+ wms.TimeOut = 40000;
158
+ wms.AddLayer("continents"); // 可多次调用,加多个 WMS 图层
159
+ wms.SetImageFormat(wms.OutputFormats[0]); // 从服务端 GetCapabilities 的可用格式里选
160
+
161
+ map.Layers.Add(new ImageLayer("WMS")
162
+ {
163
+ DataSource = wms,
164
+ Style = new RasterStyle()
165
+ });
138
166
  ```
139
167
 
168
+ > 排错要点:`CreateAsync` 会先拉 `GetCapabilities`,服务端地址写错会在此步抛异常;`AddLayer` 的图层名必须与能力文档里完全一致;`CRS` 与 `Map.CRS` 不匹配时地图空白而非报错。
169
+
140
170
  ---
141
171
 
142
172
  ## 样式
@@ -179,85 +209,101 @@ MapControl.Info += (s, e) => {
179
209
 
180
210
  ---
181
211
 
182
- ## 性能优化
183
-
184
- 1. 海量点 → `RasterizingTileLayer` 包一层(按瓦片预渲染)
185
- 2. 优先 `MemoryLayer` + 缓存 Feature
186
- 3. 异步加载 + `await Layer.WaitForFinishedRefresh()`
187
- 4. 共享 Brush/Pen/Style 实例
188
- 5. SkiaSharp 关闭抗锯齿对极小符号有性能提升
189
-
190
- ---
191
-
192
- ## 常见问题
193
-
194
- | 问题 | 解决 |
195
- |------|------|
196
- | WPF 无图 | NuGet 缺 `Mapsui.Wpf` 或没设置 `MapControl.Map` |
197
- | 找不到 `Mapsui.UI.Wpf` 包 | NuGet 包名为 `Mapsui.Wpf`(v3 起启用该名称;程序集仍为 `Mapsui.UI.Wpf.dll`) |
198
- | 投影错误 | `SphericalMercator.FromLonLat` 转换 |
199
- | MAUI 空白 | `MauiProgram` 中 `UseSkiaSharp()` + `UseMapsui()` |
200
- | Shapefile 中文乱码 | 指定 Encoding |
201
- | `GeometryFeature` / 瓦片类型找不到 | 矢量要素需安装 `Mapsui.Nts`,瓦片图层需安装 `Mapsui.Tiling` |
202
-
203
- ---
204
-
205
212
  ## 典型工作流
206
213
 
207
214
  ### 工作流 1:加载底图 + GeoJSON 矢量数据
208
215
 
216
+ 输入 POI 记录(含 `Lon` / `Lat` / `Name`),输出 WPF 窗口里可拖拽缩放的底图 + 红色点图层。
217
+
209
218
  ```csharp
210
219
  using Mapsui;
211
220
  using Mapsui.Tiling;
212
221
  using Mapsui.Nts;
213
222
  using Mapsui.Styles;
214
- using NetTopologySuite.IO;
223
+ using Mapsui.Projections;
215
224
 
216
225
  var map = new Map();
217
226
 
218
- // 1. 添加 OSM 底图
227
+ // 1. OSM 底图(来自 Mapsui.Tiling)
219
228
  map.Layers.Add(OpenStreetMap.CreateTileLayer());
220
229
 
221
- // 2. 读取 GeoJSON 并添加为矢量图层
222
- var gjReader = new GeoJsonReader();
230
+ // 2. 构造点图层。Mapsui 的视图坐标系默认是 Web Mercator(EPSG:3857),
231
+ // GeoJSON/业务数据里的经纬度必须先投影,否则会画到南太平洋附近。
223
232
  var features = new List<IFeature>();
224
- foreach (var f in geojsonFeatures)
233
+ var factory = NetTopologySuite.NtsGeometryServices.Instance.CreateGeometryFactory(3857);
234
+
235
+ foreach (var item in poiList) // item:含 Lon / Lat / Name 的 POI 记录
225
236
  {
226
- features.Add(new GeometryFeature(f.Geometry)
237
+ var p = SphericalMercator.FromLonLat(item.Lon, item.Lat).ToCoordinate();
238
+ var feature = new GeometryFeature(factory.CreatePoint(p)) { ["name"] = item.Name };
239
+ feature.Styles.Add(new SymbolStyle
227
240
  {
228
- Styles = { new VectorStyle { Fill = new Brush(Color.Red) } }
241
+ SymbolScale = 0.8,
242
+ Fill = new Brush(Color.Red),
243
+ Outline = new Pen(Color.White, 1)
229
244
  });
245
+ features.Add(feature);
230
246
  }
231
- map.Layers.Add(new MemoryLayer("Data") { Features = features });
247
+ var dataLayer = new MemoryLayer("Data") { Features = features, Style = null };
248
+ map.Layers.Add(dataLayer);
232
249
 
233
- // 3. 定位
250
+ // 3. 定位到北京
234
251
  var center = SphericalMercator.FromLonLat(116.4, 39.9).ToMPoint();
235
252
  map.Navigator.CenterOnAndZoomTo(center, map.Navigator.Resolutions[10]);
236
253
 
237
- MapControl.Map = map;
254
+ MapControl.Map = map; // 忘记这一步窗口就是空白
238
255
  ```
239
256
 
240
257
  ### 工作流 2:Shapefile + WMS 叠加
241
258
 
259
+ 输入 `data/china.shp` 与返回 `rivers` 图层的 WMS,输出底图 + 行政界 + 河流栅格图层。
260
+
242
261
  ```csharp
243
- // Shapefile 图层
244
- var shpProvider = new ShapeFile("china.shp", true);
262
+ using Mapsui.Nts.Providers.Shapefile;
263
+ using Mapsui.Providers.Wms;
264
+
265
+ // 1. Shapefile 矢量层(需 Mapsui.Nts)
266
+ var shpProvider = new ShapeFile("data/china.shp", true);
245
267
  map.Layers.Add(new Layer("China") { DataSource = shpProvider });
246
268
 
247
- // WMS 图层(叠加)
269
+ // 2. WMS 栅格层:构造参数依次为服务地址,图层名数组
248
270
  var wmsProvider = new WmsProvider("https://geo.example.com/wms?", new[] { "rivers" });
249
271
  map.Layers.Add(new ImageLayer("Rivers") { DataSource = wmsProvider });
250
272
 
251
273
  map.ZoomToExtents();
252
274
  ```
253
275
 
254
- ## DeepSeek Harness 使用建议
276
+ **验证产物**:`dotnet build` 通过不等于出图。无头环境用 `Mapsui.Rendering.Skia.MapRenderer` 把 `map` 渲染成 PNG 再打开 PNG 检查;有窗口时请用户运行后提供截图。
277
+
278
+ ## 性能优化
279
+
280
+ 1. 海量点 → `RasterizingTileLayer` 包一层(按瓦片预渲染)
281
+ 2. 优先 `MemoryLayer` + 缓存 Feature
282
+ 3. 异步加载 + `await Layer.WaitForFinishedRefresh()`
283
+ 4. 共享 Brush/Pen/Style 实例
284
+ 5. SkiaSharp 关闭抗锯齿对极小符号有性能提升
285
+
286
+ ---
287
+
288
+ ## 常见问题
289
+
290
+ | 问题 | 解决 |
291
+ |------|------|
292
+ | WPF 无图 | NuGet 缺 `Mapsui.Wpf` 或没设置 `MapControl.Map` |
293
+ | 找不到 `Mapsui.UI.Wpf` 包 | NuGet 包名为 `Mapsui.Wpf`(v3 起启用该名称;程序集仍为 `Mapsui.UI.Wpf.dll`) |
294
+ | 投影错误 | `SphericalMercator.FromLonLat` 转换 |
295
+ | MAUI 空白 | `MauiProgram` 中 `UseSkiaSharp()` + `UseMapsui()` |
296
+ | Shapefile 中文乱码 | Mapsui 的 DBF 默认按 UTF-7 解析,中文会乱码:`.dbf` 缺 .cpg 声明时按实际编码赋值 `new ShapeFile(path, true) { Encoding = Encoding.GetEncoding("GBK") }`(属性赋值,不是构造参数) |
297
+ | `GeometryFeature` / 瓦片类型找不到 | 矢量要素需安装 `Mapsui.Nts`,瓦片图层需安装 `Mapsui.Tiling` |
298
+
299
+ ---
300
+
301
+ ## AI 使用建议
255
302
 
256
- - **加载与引用**:用 `skill("mapsui")` 加载(用户也可输入 `/mapsui`);示例写入会话工作区的 .NET 工程,技能目录只读。
257
- - **执行环境**:先 `dotnet --list-sdks`;Mapsui 5.1.0 的目标框架是 net8.0/net9.0(`Mapsui.Wpf` 为 net8.0-windows/net9.0-windows),低于 .NET 8 的工程不能直接引用。命令交给 `pwsh`,例如 `dotnet add package Mapsui.Wpf --version 5.1.0`。
258
- - **验证产物**:`dotnet build` 只证明编译通过;无头渲染用 `Mapsui.Rendering.Skia.MapRenderer.RenderToBitmapStream(map, ...)` 输出 PNG 的 MemoryStream(参数以 IntelliSense 为准),落盘后 `read_image` 检查;WinForms/WPF 窗口 DSH 看不到,需用户运行后提供截图。
303
+ - **执行环境**:先 `dotnet --list-sdks`;Mapsui 5.1.0 的目标框架是 net8.0/net9.0(`Mapsui.Wpf` 为 net8.0-windows/net9.0-windows),低于 .NET 8 的工程不能直接引用。命令在终端中执行,例如 `dotnet add package Mapsui.Wpf --version 5.1.0`。
304
+ - **验证产物**:`dotnet build` 只证明编译通过;无头渲染用 `Mapsui.Rendering.Skia.MapRenderer.RenderToBitmapStream(map, ...)` 输出 PNG 的 MemoryStream(参数以 IntelliSense 为准),落盘后打开 PNG 检查;WinForms/WPF 窗口 AI 助手 看不到,需用户运行后提供截图。
259
305
  - **投影**:定位坐标必须 `SphericalMercator.FromLonLat(lon, lat)` 转换,直接用经纬度会定位到南太平洋。
260
- - **数据**:Shapefile 中文要指定 `Encoding`(UTF8 或 GBK);矢量要素装 `Mapsui.Nts`,瓦片装 `Mapsui.Tiling`,UI 包装 `Mapsui.Wpf`/`Mapsui.Maui`。
306
+ - **数据**:Shapefile 中文要设 `ShapeFile.Encoding`(UTF8 或 GBK);矢量要素装 `Mapsui.Nts`,瓦片装 `Mapsui.Tiling`,UI 包装 `Mapsui.Wpf`/`Mapsui.Maui`。
261
307
  - **常见症状**:`MapControl` 空白先查是否赋值 `MapControl.Map`;MAUI 空白查 `UseSkiaSharp()` 与 `UseMapsui()` 是否注册。
262
308
  - **安全与权限**:新建工程、装包、运行桌面程序前先征得用户同意;PostGIS/瓦片服务的密码不要写进代码或回答。
263
309
 
@@ -1,21 +1,15 @@
1
1
  ---
2
2
  name: nettopologysuite
3
3
  description: "Use when doing 2D computational geometry in .NET with NuGet NetTopologySuite 2.6.0 — GeometryFactory with SRID, Contains/Intersects predicates, Intersection/Union/Buffer overlays, STRtree, GeometryFixer, WKT/WKB/GeoJSON I/O, Shapefile via IO.Esri, and EF Core spatial queries on SQL Server/Npgsql."
4
- tags:
5
- - dotnet
6
- - csharp
7
- - geometry
8
- - spatial
9
- - wkt
10
- - wkb
11
- - geojson
12
- - ef-core
13
- - npgsql
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "dotnet, csharp, geometry, spatial, wkt, wkb, geojson, ef-core, npgsql"
14
8
  ---
15
9
 
16
10
  > **项目地址:** <https://github.com/NetTopologySuite/NetTopologySuite>
17
11
  >
18
- > **NuGet:** `NetTopologySuite`(最新稳定版 2.6.0,截至 2026-10,NuGet)
12
+ > **最新版本:** 2.6.0(截至 2026-11,[NuGet](https://www.nuget.org/packages/NetTopologySuite) 稳定版;[GitHub Release](https://github.com/NetTopologySuite/NetTopologySuite/releases))
19
13
  >
20
14
  > **官方文档:** <https://nettopologysuite.github.io/NetTopologySuite/>
21
15
  >
@@ -39,21 +33,29 @@ NTS 与 JTS API 几乎一一对应(C# 命名风格):
39
33
 
40
34
  ```bash
41
35
  dotnet add package NetTopologySuite --version 2.6.0
42
- dotnet add package NetTopologySuite.IO.GeoJSON --version 4.0.0
43
- dotnet add package NetTopologySuite.IO.Esri.Shapefile --version 1.2.0 # Shapefile 读写(Shapefile.ReadAllFeatures 等)
44
- dotnet add package ProjNet --version 2.1.0 # 坐标变换(可选)
36
+
37
+ # GeoJSON:按序列化框架二选一(不要同时装)
38
+ dotnet add package NetTopologySuite.IO.GeoJSON --version 4.0.0 # Newtonsoft.Json
39
+ dotnet add package NetTopologySuite.IO.GeoJSON4STJ --version 4.0.0 # System.Text.Json
40
+
41
+ dotnet add package NetTopologySuite.IO.Esri.Shapefile --version 1.2.0 # Shapefile 读写
42
+ dotnet add package ProjNet --version 2.1.0 # 坐标变换(可选)
45
43
  ```
46
44
 
47
- **.NET 6+** 推荐;IO 包需与主库 2.6 对齐(IO.GeoJSON 4.0.0 / IO.Esri.Shapefile 1.2.0 / ProjNet 2.1.0)。
45
+ **.NET 6+** 推荐;各 IO 包需与主库 2.6 对齐(IO.GeoJSON / IO.GeoJSON4STJ / IO.Esri.Shapefile 均为 4.0.0、1.2.0 一档,ProjNet 2.1.0)。
48
46
 
49
47
  ---
50
48
 
51
49
  ## 核心 API:几何工厂
52
50
 
53
51
  ```csharp
52
+ using NetTopologySuite;
54
53
  using NetTopologySuite.Geometries;
55
54
 
56
- var gf = new GeometryFactory(new PrecisionModel(), 4326);
55
+ // 推荐:由 NtsGeometryServices 提供工厂(也可继续用 new GeometryFactory(new PrecisionModel(), 4326))
56
+ var gf = NtsGeometryServices.Instance.CreateGeometryFactory(srid: 4326);
57
+
58
+ // 等价旧写法:var gf = new GeometryFactory(new PrecisionModel(), 4326);
57
59
 
58
60
  var p = gf.CreatePoint(new Coordinate(116.397, 39.908));
59
61
  var ls = gf.CreateLineString(new[] {
@@ -90,22 +92,45 @@ bool ok = polyA.Relate(polyB, "T*F**F***");
90
92
  ## WKT / WKB / GeoJSON
91
93
 
92
94
  ```csharp
95
+ using NetTopologySuite;
93
96
  using NetTopologySuite.IO;
94
97
 
95
- var rdr = new WKTReader();
98
+ // NTS 2.6 起推荐由 NtsGeometryServices 提供工厂(WKTReader(GeometryFactory) 已标记过时)
99
+ var services = NtsGeometryServices.Instance;
100
+ var rdr = new WKTReader(services);
96
101
  var g = rdr.Read("POINT (116.4 39.9)");
97
102
 
98
103
  string wkt = new WKTWriter().Write(g);
99
104
  byte[] wkb = new WKBWriter().Write(g);
105
+ ```
100
106
 
101
- using NetTopologySuite.IO.Converters;
107
+ GeoJSON 有两种包,按序列化框架二选一(两者都需与主库 2.6 对齐,均取 4.0.0):
108
+
109
+ | 包 | 序列化框架 | 用法 |
110
+ |---|---|---|
111
+ | `NetTopologySuite.IO.GeoJSON` | Newtonsoft.Json 13.x | `new GeoJsonReader()` / `new GeoJsonWriter()` |
112
+ | `NetTopologySuite.IO.GeoJSON4STJ` | System.Text.Json | `opts.Converters.Add(new GeoJsonConverterFactory())` |
113
+
114
+ ```csharp
115
+ using NetTopologySuite.IO.Converters; // 来自 NetTopologySuite.IO.GeoJSON4STJ
102
116
  using System.Text.Json;
117
+
103
118
  var opts = new JsonSerializerOptions();
104
119
  opts.Converters.Add(new GeoJsonConverterFactory());
105
120
  string json = JsonSerializer.Serialize(g, opts);
106
121
  var g2 = JsonSerializer.Deserialize<Geometry>(json, opts);
107
122
  ```
108
123
 
124
+ Newtonsoft 方案:
125
+
126
+ ```csharp
127
+ using NetTopologySuite.IO;
128
+
129
+ var writer = new GeoJsonWriter();
130
+ string json2 = writer.Write(g);
131
+ var g3 = new GeoJsonReader().Read(json2);
132
+ ```
133
+
109
134
  ---
110
135
 
111
136
  ## Shapefile
@@ -196,11 +221,50 @@ double[] xy = ct.MathTransform.Transform(new[] { 116.397, 39.908 });
196
221
 
197
222
  ## 典型工作流
198
223
 
199
- 1. **创建几何工厂**:使用 `new GeometryFactory(new PrecisionModel(), 4326)` 创建工厂,SRID 指定坐标系
200
- 2. **创建几何对象**:通过工厂方法 `CreatePoint()`、`CreateLineString()`、`CreatePolygon()` 创建几何
201
- 3. **空间运算**:直接调用几何对象方法 `Intersects()`、`Intersection()`、`Buffer()` 等
202
- 4. **格式读写**:使用 `WKTReader`/`WKTWriter`、`GeoJsonConverterFactory` 进行序列化
203
- 5. **EF Core 集成**:`UseNetTopologySuite()` 启用空间查询翻译为 SQL
224
+ 端到端:WKT 读入 → 有效性修复 → 空间运算 → 写 GeoJSON / 入库。
225
+
226
+ ```csharp
227
+ using NetTopologySuite;
228
+ using NetTopologySuite.Geometries;
229
+ using NetTopologySuite.Geometries.Utilities;
230
+ using NetTopologySuite.IO;
231
+ using NetTopologySuite.IO.Converters; // NetTopologySuite.IO.GeoJSON4STJ
232
+ using System.Text.Json;
233
+
234
+ // 1. 读入两个输入几何(第二个是自相交的"蝴蝶结",无效)
235
+ var services = NtsGeometryServices.Instance;
236
+ var reader = new WKTReader(services);
237
+ Geometry parcel = reader.Read("POLYGON ((0 0, 10 0, 10 10, 0 10, 0 0))");
238
+ Geometry zone = reader.Read("POLYGON ((5 5, 15 15, 15 5, 5 15, 5 5))");
239
+
240
+ // 2. 校验并修复(GeometryFixer 可能把无效面拆成 MultiPolygon)
241
+ Console.WriteLine(zone.IsValid); // False
242
+ if (!zone.IsValid)
243
+ zone = GeometryFixer.Fix(zone); // 修成 MultiPolygon,IsValid=True
244
+
245
+ // 3. 空间运算:求交 + 缓冲
246
+ Geometry overlap = parcel.Intersection(zone);
247
+ Geometry buffered = overlap.Buffer(1.0);
248
+ Console.WriteLine(overlap.Area); // 12.5(两三角形在方形内的部分)
249
+
250
+ // 4. 写 GeoJSON(System.Text.Json 转换器,需 GeoJSON4STJ 包)
251
+ var opts = new JsonSerializerOptions();
252
+ opts.Converters.Add(new GeoJsonConverterFactory());
253
+ string geoJson = JsonSerializer.Serialize(buffered, opts);
254
+
255
+ // 5. 回读校验
256
+ Geometry back = JsonSerializer.Deserialize<Geometry>(geoJson, opts);
257
+ Console.WriteLine(back.IsValid); // True
258
+ ```
259
+
260
+ **输出与验收**:`geoJson` 能以 `JsonSerializer.Deserialize<Geometry>` 读回且 `back.IsValid` 为 `true`;`overlap.Area` 为 12.5(面积只在投影/平面坐标下有实际含义,经纬度下是平面近似值)。
261
+
262
+ **其他常用步骤**:
263
+
264
+ 1. **创建几何工厂**:跨方法共享同一个 `GeometryFactory` 并固定 SRID,避免几何间 SRID 不一致
265
+ 2. **空间索引**:数据量超过几千条时先建 `STRtree`,再做批量 `Intersects` 粗筛
266
+ 3. **格式读写**:`WKTReader`/`WKTWriter`、`GeoJsonConverterFactory`;Shapefile 走 `NetTopologySuite.IO.Esri`
267
+ 4. **EF Core 集成**:`UseNetTopologySuite()` 让 `Distance()`/`Intersects()` 翻译为空间 SQL
204
268
 
205
269
  ---
206
270
 
@@ -226,30 +290,31 @@ foreach (var p in points) if (prep.Contains(p)) ...
226
290
  | `TopologyException` | `GeometryFixer.Fix` 修复无效几何 |
227
291
  | EF Core 类型冲突 | 用 `UseNetTopologySuite()` 而非 `Microsoft.SqlServer.Types` |
228
292
  | Z/M 坐标丢失 | 配置 `WKBWriter` 的 `HandleOrdinates` |
293
+ | 找不到 `GeoJsonConverterFactory` | 该类属于 `NetTopologySuite.IO.GeoJSON4STJ`(System.Text.Json),不是 `NetTopologySuite.IO.GeoJSON`(Newtonsoft) |
229
294
  | Buffer 慢 | 减小 quadrantSegments、并行处理 |
230
295
  | Shapefile 读取写法报错 | 使用 `NetTopologySuite.IO.Esri.Shapefile` 包与 `NetTopologySuite.IO.Esri` 命名空间(`Shapefile.ReadAllFeatures`) |
231
296
  | 依赖版本不匹配(NTS 2.6 与旧 IO 包) | 对齐版本:IO.GeoJSON 4.0.0、IO.Esri.Shapefile 1.2.0、ProjNet 2.1.0 |
232
297
 
233
298
  ---
234
299
 
235
- ## DeepSeek Harness 使用建议
300
+ ## AI 使用建议
236
301
 
237
- - **加载与引用**:`skill("nettopologysuite")` 加载;技能目录只读,示例工程与测试数据写到会话工作区。
238
- - **执行环境**:命令交给 dsh 的 `pwsh`;先 `dotnet --version` 确认 SDK 6.0+,`dotnet restore` 需要访问 NuGet。
239
- - **先探测版本**:`dotnet list package` 核对 `NetTopologySuite` 2.6.0、`NetTopologySuite.IO.GeoJSON` 4.0.0、`NetTopologySuite.IO.Esri.Shapefile` 1.2.0、`ProjNet` 2.1.0;IO 包与主库错配是常见编译/运行期报错源。
302
+ - **执行环境**:命令在终端 / shell 中执行;先 `dotnet --version` 确认 SDK 6.0+,`dotnet restore` 需要访问 NuGet。
303
+ - **先探测版本**:`dotnet list package` 核对 `NetTopologySuite` 2.6.0、`NetTopologySuite.IO.GeoJSON`(或 `IO.GeoJSON4STJ`)4.0.0、`NetTopologySuite.IO.Esri.Shapefile` 1.2.0、`ProjNet` 2.1.0;IO 包与主库错配是常见编译/运行期报错源。
240
304
  - **验证产物**:`dotnet build` 后跑 `dotnet test`,或最小控制台做 WKT 往返 + `IsValid` 断言;`GeoJsonConverterFactory` 序列化后再反序列化,比对坐标数而不是只打日志。
241
305
  - **失败信号**:`TopologyException` 先 `GeometryFixer.Fix`;程序集加载/`TypeInitializationException` 多为 IO 包版本不匹配;EF Core 类型冲突是同时引了 `Microsoft.SqlServer.Types`。
242
306
  - **注意事项**:NTS 的 SRID 只是元数据、计算在平面进行,跨投影交给 ProjNet;`WKBWriter` 默认丢 Z/M,需设 `HandleOrdinates`。
243
- - **按需读文件**:本 SKILL 代码块较多,先按章节标题定位再用 `read` 取行区间,比整篇读更省上下文。
307
+ - **按需读文件**:本 SKILL 代码块较多,先按章节标题定位再分段读取,比整篇读更省上下文。
244
308
 
245
309
  ## NTS 家族与相关库
246
310
 
247
311
  | 包 | 用途 |
248
312
  |----|------|
249
313
  | `NetTopologySuite.IO.VectorTiles` | Mapbox Vector Tiles(MVT)读写 |
250
- | `NetTopologySuite.IO.GeoJSON` | GeoJSON 读写 |
251
- | `NetTopologySuite.IO.Esri` | Shapefile(ESRI)读写 |
252
- | `ProjNet4GeoAPI` | 坐标参考系与投影变换 |
314
+ | `NetTopologySuite.IO.GeoJSON` | GeoJSON 读写(Newtonsoft.Json) |
315
+ | `NetTopologySuite.IO.GeoJSON4STJ` | GeoJSON 读写(System.Text.Json,提供 `GeoJsonConverterFactory`) |
316
+ | `NetTopologySuite.IO.Esri.Shapefile` | Shapefile 读写(命名空间 `NetTopologySuite.IO.Esri`) |
317
+ | `ProjNet` | 坐标参考系与投影变换(当前主线 2.1.0;旧包 `ProjNet4GeoAPI` 停在 1.4.1,新项目用 `ProjNet`) |
253
318
 
254
319
  ## 相关技能
255
320