@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.
Files changed (97) hide show
  1. package/CHANGELOG.md +71 -0
  2. package/README.md +79 -43
  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 +16 -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 +8 -0
  30. package/adaptations/opengis-daf.md +8 -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 +289 -0
  46. package/assets/cesiumjs/SKILL.md +78 -29
  47. package/assets/deck-gl/SKILL.md +20 -20
  48. package/assets/duckdb-spatial/SKILL.md +370 -0
  49. package/assets/gdal/SKILL.md +50 -55
  50. package/assets/gdal-api/SKILL.md +12 -29
  51. package/assets/geolibre/SKILL.md +364 -0
  52. package/assets/geometry-api-java/SKILL.md +11 -19
  53. package/assets/geometry-api-net/SKILL.md +66 -29
  54. package/assets/geonode/SKILL.md +347 -0
  55. package/assets/geopandas/SKILL.md +22 -28
  56. package/assets/geopipe-agent/SKILL.md +25 -30
  57. package/assets/geoserver/SKILL.md +21 -24
  58. package/assets/geoserver-cloud/SKILL.md +23 -34
  59. package/assets/geoserver-rest-api/SKILL.md +18 -23
  60. package/assets/geotools/SKILL.md +13 -21
  61. package/assets/grass-gis/SKILL.md +19 -20
  62. package/assets/jts/SKILL.md +12 -17
  63. package/assets/kepler-gl/SKILL.md +313 -0
  64. package/assets/leaflet/SKILL.md +42 -17
  65. package/assets/mapbox-gl-js/SKILL.md +19 -18
  66. package/assets/mapserver/SKILL.md +18 -18
  67. package/assets/mapsui/SKILL.md +87 -58
  68. package/assets/nettopologysuite/SKILL.md +96 -27
  69. package/assets/opengis-all/SKILL.md +80 -292
  70. package/assets/opengis-all/reference/data-stages.md +262 -4
  71. package/assets/opengis-daf/SKILL.md +12 -14
  72. package/assets/opengis-utils-for-java/SKILL.md +52 -47
  73. package/assets/opengis-utils-for-java/reference/common-tasks.md +12 -12
  74. package/assets/opengis-utils-for-net/SKILL.md +106 -40
  75. package/assets/opengis-utils-for-net/reference/code-patterns.md +11 -11
  76. package/assets/opengis-utils-for-net/reference/util-classes.md +25 -26
  77. package/assets/openlayers/SKILL.md +71 -14
  78. package/assets/pdal/SKILL.md +21 -15
  79. package/assets/postgis/SKILL.md +66 -18
  80. package/assets/proj/SKILL.md +29 -42
  81. package/assets/projnet4geoapi/SKILL.md +299 -0
  82. package/assets/pyqgis/SKILL.md +28 -54
  83. package/assets/qgis-process/SKILL.md +67 -39
  84. package/assets/qgis-server/SKILL.md +21 -32
  85. package/assets/shapely/SKILL.md +133 -84
  86. package/assets/sharpmap/SKILL.md +96 -61
  87. package/assets/spatialite/SKILL.md +365 -0
  88. package/assets/whitebox-tools/SKILL.md +269 -0
  89. package/lib/adaptations.d.ts +47 -0
  90. package/lib/adaptations.js +268 -0
  91. package/lib/index.d.ts +1 -1
  92. package/lib/index.js +14 -2
  93. package/lib/skill-file.js +31 -7
  94. package/locale/en.json +1 -1
  95. package/locale/zh.json +1 -1
  96. package/package.json +12 -2
  97. package/upstream.json +56 -40
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: mapsui
3
- description: "Use when embedding interactive 2D maps in .NET desktop (WinForms/WPF) or mobile (MAUI) applications — tile layers, vector features, map controls. Mapsui: cross-platform .NET map component library."
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
4
  tags:
5
5
  - dotnet
6
6
  - csharp
@@ -18,7 +18,7 @@ tags:
18
18
  >
19
19
  > **官方文档:** <https://mapsui.com/v5/documentation/index.html>
20
20
  >
21
- > **最新版本:** 5.1.0(截至2026-10,NuGet)
21
+ > **最新版本:** 5.1.0(截至 2026-10,NuGet 稳定版;5.2.0-beta.1 为预发布)
22
22
  >
23
23
  > **许可证:** MIT
24
24
 
@@ -36,11 +36,24 @@ tags:
36
36
  ## 安装
37
37
 
38
38
  ```bash
39
- dotnet add package Mapsui.Wpf # 或 Mapsui.Maui / Mapsui.Avalonia / ...
40
- dotnet add package Mapsui.Tiling
41
- dotnet add package Mapsui.Nts
39
+ # 按 UI 框架选一个
40
+ dotnet add package Mapsui.Wpf --version 5.1.0 # WPF(net8.0-windows / net9.0-windows)
41
+ dotnet add package Mapsui.Maui --version 5.1.0 # MAUI,或 Mapsui.Avalonia / Mapsui.WinUI / Mapsui.Blazor
42
+ # 按数据源按需追加
43
+ dotnet add package Mapsui.Tiling --version 5.1.0 # 瓦片底图
44
+ dotnet add package Mapsui.Nts --version 5.1.0 # NTS 几何 / Shapefile
42
45
  ```
43
46
 
47
+ ### 验证
48
+
49
+ ```bash
50
+ dotnet --list-sdks # 需 .NET 8/9 SDK
51
+ dotnet restore # 能解析 Mapsui 5.1.0 即包可用
52
+ dotnet build # 编译通过后才进入渲染验证
53
+ ```
54
+
55
+ > 所有 `Mapsui.*` 子包版本必须一致(同样写 5.1.0),混版会在运行时抛类型加载异常。
56
+
44
57
  ---
45
58
 
46
59
  ## WPF 入门
@@ -85,19 +98,27 @@ MapControl.Map = map;
85
98
  ```csharp
86
99
  using Mapsui.Nts;
87
100
  using Mapsui.Styles;
101
+ using NetTopologySuite.NtsGeometryServices;
88
102
 
89
- var features = new List<IFeature>();
90
- foreach (var f in geoJsonFeatures)
91
- features.Add(new GeometryFeature(f.Geometry) {
103
+ // 视图坐标系为 EPSG:3857,经纬度数据必须先投影
104
+ var factory = NtsGeometryServices.Instance.CreateGeometryFactory(3857);
105
+
106
+ var features = new List<IFeature>
107
+ {
108
+ new GeometryFeature(factory.CreatePoint(SphericalMercator.FromLonLat(116.397, 39.908).ToCoordinate()))
109
+ {
92
110
  Styles = { new VectorStyle {
93
111
  Fill = new Brush(Color.Red),
94
112
  Outline = new Pen(Color.Black, 1)
95
113
  }}
96
- });
114
+ }
115
+ };
97
116
 
98
117
  map.Layers.Add(new MemoryLayer("Roads") { Features = features, Style = null });
99
118
  ```
100
119
 
120
+ > 线/面要素用 `factory.CreateLineString(coords)` / `factory.CreatePolygon(shell, holes)`,坐标同样要先 `SphericalMercator.FromLonLat` 投影。
121
+
101
122
  ---
102
123
 
103
124
  ## Shapefile
@@ -179,95 +200,103 @@ MapControl.Info += (s, e) => {
179
200
 
180
201
  ---
181
202
 
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
203
  ## 典型工作流
206
204
 
207
205
  ### 工作流 1:加载底图 + GeoJSON 矢量数据
208
206
 
207
+ 输入 POI 记录(含 `Lon` / `Lat` / `Name`),输出 WPF 窗口里可拖拽缩放的底图 + 红色点图层。
208
+
209
209
  ```csharp
210
210
  using Mapsui;
211
211
  using Mapsui.Tiling;
212
212
  using Mapsui.Nts;
213
213
  using Mapsui.Styles;
214
- using NetTopologySuite.IO;
214
+ using Mapsui.Projections;
215
215
 
216
216
  var map = new Map();
217
217
 
218
- // 1. 添加 OSM 底图
218
+ // 1. OSM 底图(来自 Mapsui.Tiling)
219
219
  map.Layers.Add(OpenStreetMap.CreateTileLayer());
220
220
 
221
- // 2. 读取 GeoJSON 并添加为矢量图层
222
- var gjReader = new GeoJsonReader();
221
+ // 2. 构造点图层。Mapsui 的视图坐标系默认是 Web Mercator(EPSG:3857),
222
+ // GeoJSON/业务数据里的经纬度必须先投影,否则会画到南太平洋附近。
223
223
  var features = new List<IFeature>();
224
- foreach (var f in geojsonFeatures)
224
+ var factory = NetTopologySuite.NtsGeometryServices.Instance.CreateGeometryFactory(3857);
225
+
226
+ foreach (var item in poiList) // item:含 Lon / Lat / Name 的 POI 记录
225
227
  {
226
- features.Add(new GeometryFeature(f.Geometry)
228
+ var p = SphericalMercator.FromLonLat(item.Lon, item.Lat).ToCoordinate();
229
+ var feature = new GeometryFeature(factory.CreatePoint(p)) { ["name"] = item.Name };
230
+ feature.Styles.Add(new SymbolStyle
227
231
  {
228
- Styles = { new VectorStyle { Fill = new Brush(Color.Red) } }
232
+ SymbolScale = 0.8,
233
+ Fill = new Brush(Color.Red),
234
+ Outline = new Pen(Color.White, 1)
229
235
  });
236
+ features.Add(feature);
230
237
  }
231
- map.Layers.Add(new MemoryLayer("Data") { Features = features });
238
+ var dataLayer = new MemoryLayer("Data") { Features = features, Style = null };
239
+ map.Layers.Add(dataLayer);
232
240
 
233
- // 3. 定位
241
+ // 3. 定位到北京
234
242
  var center = SphericalMercator.FromLonLat(116.4, 39.9).ToMPoint();
235
243
  map.Navigator.CenterOnAndZoomTo(center, map.Navigator.Resolutions[10]);
236
244
 
237
- MapControl.Map = map;
245
+ MapControl.Map = map; // 忘记这一步窗口就是空白
238
246
  ```
239
247
 
240
248
  ### 工作流 2:Shapefile + WMS 叠加
241
249
 
250
+ 输入 `data/china.shp` 与返回 `rivers` 图层的 WMS,输出底图 + 行政界 + 河流栅格图层。
251
+
242
252
  ```csharp
243
- // Shapefile 图层
244
- var shpProvider = new ShapeFile("china.shp", true);
253
+ using Mapsui.Nts.Providers.Shapefile;
254
+ using Mapsui.Providers.Wms;
255
+
256
+ // 1. Shapefile 矢量层(需 Mapsui.Nts)
257
+ var shpProvider = new ShapeFile("data/china.shp", true);
245
258
  map.Layers.Add(new Layer("China") { DataSource = shpProvider });
246
259
 
247
- // WMS 图层(叠加)
260
+ // 2. WMS 栅格层:构造参数依次为服务地址,图层名数组
248
261
  var wmsProvider = new WmsProvider("https://geo.example.com/wms?", new[] { "rivers" });
249
262
  map.Layers.Add(new ImageLayer("Rivers") { DataSource = wmsProvider });
250
263
 
251
264
  map.ZoomToExtents();
252
265
  ```
253
266
 
254
- ## AI 使用建议
267
+ **验证产物**:`dotnet build` 通过不等于出图。无头环境用 `Mapsui.Rendering.Skia.MapRenderer` 把 `map` 渲染成 PNG 再打开 PNG 检查;有窗口时请用户运行后提供截图。
268
+
269
+ ## 性能优化
270
+
271
+ 1. 海量点 → `RasterizingTileLayer` 包一层(按瓦片预渲染)
272
+ 2. 优先 `MemoryLayer` + 缓存 Feature
273
+ 3. 异步加载 + `await Layer.WaitForFinishedRefresh()`
274
+ 4. 共享 Brush/Pen/Style 实例
275
+ 5. SkiaSharp 关闭抗锯齿对极小符号有性能提升
276
+
277
+ ---
278
+
279
+ ## 常见问题
255
280
 
256
- ### 推荐工作流
281
+ | 问题 | 解决 |
282
+ |------|------|
283
+ | WPF 无图 | NuGet 缺 `Mapsui.Wpf` 或没设置 `MapControl.Map` |
284
+ | 找不到 `Mapsui.UI.Wpf` 包 | NuGet 包名为 `Mapsui.Wpf`(v3 起启用该名称;程序集仍为 `Mapsui.UI.Wpf.dll`) |
285
+ | 投影错误 | `SphericalMercator.FromLonLat` 转换 |
286
+ | MAUI 空白 | `MauiProgram` 中 `UseSkiaSharp()` + `UseMapsui()` |
287
+ | Shapefile 中文乱码 | Mapsui 的 DBF 默认按 UTF-7 解析,中文会乱码:`.dbf` 缺 .cpg 声明时按实际编码赋值 `new ShapeFile(path, true) { Encoding = Encoding.GetEncoding("GBK") }`(属性赋值,不是构造参数) |
288
+ | `GeometryFeature` / 瓦片类型找不到 | 矢量要素需安装 `Mapsui.Nts`,瓦片图层需安装 `Mapsui.Tiling` |
257
289
 
258
- 1. **选择 UI 框架**:Mapsui 支持 WPF/WinUI/MAUI/Avalonia/Uno/Blazor/WinForms,根据需要选择对应的 NuGet 包
259
- 2. **创建 Map**:实例化 `Map`,添加图层(`TileLayer` 作为底图 + `MemoryLayer` 作为矢量覆盖层)
260
- 3. **数据转换**:通过 `SphericalMercator.FromLonLat()` 将经纬度转为 Web Mercator 坐标
261
- 4. **绑定控件**:将 `MapControl.Map` 设置为创建的 Map 对象
262
- 5. **添加交互**:通过 `MapControl.Info` 事件处理点击拾取,`Navigator` 控制视图
290
+ ---
263
291
 
264
- ### 关键注意事项
292
+ ## AI 使用建议
265
293
 
266
- - **NuGet 包完整**:确保安装了 `Mapsui.<UI框架>`、`Mapsui.Tiling`、`Mapsui.Nts` 三个包
267
- - **投影转换**:WGS84 经纬度必须通过 `SphericalMercator.FromLonLat()` 转换后才能用于 Mapsui 定位
268
- - **Shapefile 编码**:中文 Shapefile 需指定 `Encoding`(如 `Encoding.UTF8` 或 `Encoding.GetEncoding("GBK")`)
269
- - **样式共享**:共享 `Brush`/`Pen`/`VectorStyle` 实例可提升性能
270
- - **海量点优化**:使用 `RasterizingTileLayer` 包装海量点图层,按瓦片预渲染
294
+ - **执行环境**:先 `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`。
295
+ - **验证产物**:`dotnet build` 只证明编译通过;无头渲染用 `Mapsui.Rendering.Skia.MapRenderer.RenderToBitmapStream(map, ...)` 输出 PNG 的 MemoryStream(参数以 IntelliSense 为准),落盘后打开 PNG 检查;WinForms/WPF 窗口 AI 助手 看不到,需用户运行后提供截图。
296
+ - **投影**:定位坐标必须 `SphericalMercator.FromLonLat(lon, lat)` 转换,直接用经纬度会定位到南太平洋。
297
+ - **数据**:Shapefile 中文要设 `ShapeFile.Encoding`(UTF8 或 GBK);矢量要素装 `Mapsui.Nts`,瓦片装 `Mapsui.Tiling`,UI 包装 `Mapsui.Wpf`/`Mapsui.Maui`。
298
+ - **常见症状**:`MapControl` 空白先查是否赋值 `MapControl.Map`;MAUI 空白查 `UseSkiaSharp()` 与 `UseMapsui()` 是否注册。
299
+ - **安全与权限**:新建工程、装包、运行桌面程序前先征得用户同意;PostGIS/瓦片服务的密码不要写进代码或回答。
271
300
 
272
301
  ## 相关技能
273
302
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: nettopologysuite
3
- description: "Use when performing 2D computational geometry in .NET — spatial predicates, overlay operations, buffering, WKT/WKB I/O. NetTopologySuite: the .NET port of JTS, available via NuGet for spatial analysis in C# applications."
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
4
  tags:
5
5
  - dotnet
6
6
  - csharp
@@ -38,22 +38,30 @@ NTS 与 JTS API 几乎一一对应(C# 命名风格):
38
38
  ## 环境准备
39
39
 
40
40
  ```bash
41
- dotnet add package NetTopologySuite
42
- dotnet add package NetTopologySuite.IO.GeoJSON
43
- dotnet add package NetTopologySuite.IO.Esri.Shapefile # Shapefile 读写(Shapefile.ReadAllFeatures 等)
44
- dotnet add package ProjNet # 坐标变换(可选)
41
+ dotnet add package NetTopologySuite --version 2.6.0
42
+
43
+ # GeoJSON:按序列化框架二选一(不要同时装)
44
+ dotnet add package NetTopologySuite.IO.GeoJSON --version 4.0.0 # Newtonsoft.Json
45
+ dotnet add package NetTopologySuite.IO.GeoJSON4STJ --version 4.0.0 # System.Text.Json
46
+
47
+ dotnet add package NetTopologySuite.IO.Esri.Shapefile --version 1.2.0 # Shapefile 读写
48
+ dotnet add package ProjNet --version 2.1.0 # 坐标变换(可选)
45
49
  ```
46
50
 
47
- **.NET 6+** 推荐。
51
+ **.NET 6+** 推荐;各 IO 包需与主库 2.6 对齐(IO.GeoJSON / IO.GeoJSON4STJ / IO.Esri.Shapefile 均为 4.0.0、1.2.0 一档,ProjNet 2.1.0)。
48
52
 
49
53
  ---
50
54
 
51
55
  ## 核心 API:几何工厂
52
56
 
53
57
  ```csharp
58
+ using NetTopologySuite;
54
59
  using NetTopologySuite.Geometries;
55
60
 
56
- var gf = new GeometryFactory(new PrecisionModel(), 4326);
61
+ // 推荐:由 NtsGeometryServices 提供工厂(也可继续用 new GeometryFactory(new PrecisionModel(), 4326))
62
+ var gf = NtsGeometryServices.Instance.CreateGeometryFactory(srid: 4326);
63
+
64
+ // 等价旧写法:var gf = new GeometryFactory(new PrecisionModel(), 4326);
57
65
 
58
66
  var p = gf.CreatePoint(new Coordinate(116.397, 39.908));
59
67
  var ls = gf.CreateLineString(new[] {
@@ -90,22 +98,45 @@ bool ok = polyA.Relate(polyB, "T*F**F***");
90
98
  ## WKT / WKB / GeoJSON
91
99
 
92
100
  ```csharp
101
+ using NetTopologySuite;
93
102
  using NetTopologySuite.IO;
94
103
 
95
- var rdr = new WKTReader();
104
+ // NTS 2.6 起推荐由 NtsGeometryServices 提供工厂(WKTReader(GeometryFactory) 已标记过时)
105
+ var services = NtsGeometryServices.Instance;
106
+ var rdr = new WKTReader(services);
96
107
  var g = rdr.Read("POINT (116.4 39.9)");
97
108
 
98
109
  string wkt = new WKTWriter().Write(g);
99
110
  byte[] wkb = new WKBWriter().Write(g);
111
+ ```
112
+
113
+ GeoJSON 有两种包,按序列化框架二选一(两者都需与主库 2.6 对齐,均取 4.0.0):
100
114
 
101
- using NetTopologySuite.IO.Converters;
115
+ | 包 | 序列化框架 | 用法 |
116
+ |---|---|---|
117
+ | `NetTopologySuite.IO.GeoJSON` | Newtonsoft.Json 13.x | `new GeoJsonReader()` / `new GeoJsonWriter()` |
118
+ | `NetTopologySuite.IO.GeoJSON4STJ` | System.Text.Json | `opts.Converters.Add(new GeoJsonConverterFactory())` |
119
+
120
+ ```csharp
121
+ using NetTopologySuite.IO.Converters; // 来自 NetTopologySuite.IO.GeoJSON4STJ
102
122
  using System.Text.Json;
123
+
103
124
  var opts = new JsonSerializerOptions();
104
125
  opts.Converters.Add(new GeoJsonConverterFactory());
105
126
  string json = JsonSerializer.Serialize(g, opts);
106
127
  var g2 = JsonSerializer.Deserialize<Geometry>(json, opts);
107
128
  ```
108
129
 
130
+ Newtonsoft 方案:
131
+
132
+ ```csharp
133
+ using NetTopologySuite.IO;
134
+
135
+ var writer = new GeoJsonWriter();
136
+ string json2 = writer.Write(g);
137
+ var g3 = new GeoJsonReader().Read(json2);
138
+ ```
139
+
109
140
  ---
110
141
 
111
142
  ## Shapefile
@@ -196,11 +227,50 @@ double[] xy = ct.MathTransform.Transform(new[] { 116.397, 39.908 });
196
227
 
197
228
  ## 典型工作流
198
229
 
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
230
+ 端到端:WKT 读入 → 有效性修复 → 空间运算 → 写 GeoJSON / 入库。
231
+
232
+ ```csharp
233
+ using NetTopologySuite;
234
+ using NetTopologySuite.Geometries;
235
+ using NetTopologySuite.Geometries.Utilities;
236
+ using NetTopologySuite.IO;
237
+ using NetTopologySuite.IO.Converters; // NetTopologySuite.IO.GeoJSON4STJ
238
+ using System.Text.Json;
239
+
240
+ // 1. 读入两个输入几何(第二个是自相交的"蝴蝶结",无效)
241
+ var services = NtsGeometryServices.Instance;
242
+ var reader = new WKTReader(services);
243
+ Geometry parcel = reader.Read("POLYGON ((0 0, 10 0, 10 10, 0 10, 0 0))");
244
+ Geometry zone = reader.Read("POLYGON ((5 5, 15 15, 15 5, 5 15, 5 5))");
245
+
246
+ // 2. 校验并修复(GeometryFixer 可能把无效面拆成 MultiPolygon)
247
+ Console.WriteLine(zone.IsValid); // False
248
+ if (!zone.IsValid)
249
+ zone = GeometryFixer.Fix(zone); // 修成 MultiPolygon,IsValid=True
250
+
251
+ // 3. 空间运算:求交 + 缓冲
252
+ Geometry overlap = parcel.Intersection(zone);
253
+ Geometry buffered = overlap.Buffer(1.0);
254
+ Console.WriteLine(overlap.Area); // 12.5(两三角形在方形内的部分)
255
+
256
+ // 4. 写 GeoJSON(System.Text.Json 转换器,需 GeoJSON4STJ 包)
257
+ var opts = new JsonSerializerOptions();
258
+ opts.Converters.Add(new GeoJsonConverterFactory());
259
+ string geoJson = JsonSerializer.Serialize(buffered, opts);
260
+
261
+ // 5. 回读校验
262
+ Geometry back = JsonSerializer.Deserialize<Geometry>(geoJson, opts);
263
+ Console.WriteLine(back.IsValid); // True
264
+ ```
265
+
266
+ **输出与验收**:`geoJson` 能以 `JsonSerializer.Deserialize<Geometry>` 读回且 `back.IsValid` 为 `true`;`overlap.Area` 为 12.5(面积只在投影/平面坐标下有实际含义,经纬度下是平面近似值)。
267
+
268
+ **其他常用步骤**:
269
+
270
+ 1. **创建几何工厂**:跨方法共享同一个 `GeometryFactory` 并固定 SRID,避免几何间 SRID 不一致
271
+ 2. **空间索引**:数据量超过几千条时先建 `STRtree`,再做批量 `Intersects` 粗筛
272
+ 3. **格式读写**:`WKTReader`/`WKTWriter`、`GeoJsonConverterFactory`;Shapefile 走 `NetTopologySuite.IO.Esri`
273
+ 4. **EF Core 集成**:`UseNetTopologySuite()` 让 `Distance()`/`Intersects()` 翻译为空间 SQL
204
274
 
205
275
  ---
206
276
 
@@ -226,32 +296,31 @@ foreach (var p in points) if (prep.Contains(p)) ...
226
296
  | `TopologyException` | `GeometryFixer.Fix` 修复无效几何 |
227
297
  | EF Core 类型冲突 | 用 `UseNetTopologySuite()` 而非 `Microsoft.SqlServer.Types` |
228
298
  | Z/M 坐标丢失 | 配置 `WKBWriter` 的 `HandleOrdinates` |
299
+ | 找不到 `GeoJsonConverterFactory` | 该类属于 `NetTopologySuite.IO.GeoJSON4STJ`(System.Text.Json),不是 `NetTopologySuite.IO.GeoJSON`(Newtonsoft) |
229
300
  | Buffer 慢 | 减小 quadrantSegments、并行处理 |
230
301
  | Shapefile 读取写法报错 | 使用 `NetTopologySuite.IO.Esri.Shapefile` 包与 `NetTopologySuite.IO.Esri` 命名空间(`Shapefile.ReadAllFeatures`) |
231
- | 依赖版本不匹配(NTS 2.6 与旧 IO 包) | 各 IO 包选择与 NetTopologySuite 2.6 兼容的最新版本 |
302
+ | 依赖版本不匹配(NTS 2.6 与旧 IO 包) | 对齐版本:IO.GeoJSON 4.0.0、IO.Esri.Shapefile 1.2.0、ProjNet 2.1.0 |
232
303
 
233
304
  ---
234
305
 
235
306
  ## AI 使用建议
236
307
 
237
-
238
- ### 关键注意事项
239
-
240
- - **GeometryFactory 共享**:固定 SRID,复用 `GeometryFactory` 实例
241
- - **拓扑异常修复**:无效几何使用 `GeometryFixer.Fix()` 修复
242
- - **PreparedGeometry**:重复空间关系判断时使用 `PreparedGeometryFactory.Prepare()` 大幅提速
243
- - **STRtree 批量查询**:先 `Build()` 再 `Query()`,大数据量场景优于逐几何判断
244
- - **WKB vs WKT**:WKB 比 WKT 更快更紧凑,数据库交互优先使用 WKB
245
- - **Z/M 坐标**:`WKBWriter` 需配置 `HandleOrdinates` 保留 Z/M 坐标
308
+ - **执行环境**:命令在终端 / shell 中执行;先 `dotnet --version` 确认 SDK 6.0+,`dotnet restore` 需要访问 NuGet。
309
+ - **先探测版本**:`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 包与主库错配是常见编译/运行期报错源。
310
+ - **验证产物**:`dotnet build` 后跑 `dotnet test`,或最小控制台做 WKT 往返 + `IsValid` 断言;`GeoJsonConverterFactory` 序列化后再反序列化,比对坐标数而不是只打日志。
311
+ - **失败信号**:`TopologyException` 先 `GeometryFixer.Fix`;程序集加载/`TypeInitializationException` 多为 IO 包版本不匹配;EF Core 类型冲突是同时引了 `Microsoft.SqlServer.Types`。
312
+ - **注意事项**:NTS 的 SRID 只是元数据、计算在平面进行,跨投影交给 ProjNet;`WKBWriter` 默认丢 Z/M,需设 `HandleOrdinates`。
313
+ - **按需读文件**:本 SKILL 代码块较多,先按章节标题定位再分段读取,比整篇读更省上下文。
246
314
 
247
315
  ## NTS 家族与相关库
248
316
 
249
317
  | 包 | 用途 |
250
318
  |----|------|
251
319
  | `NetTopologySuite.IO.VectorTiles` | Mapbox Vector Tiles(MVT)读写 |
252
- | `NetTopologySuite.IO.GeoJSON` | GeoJSON 读写 |
253
- | `NetTopologySuite.IO.Esri` | Shapefile(ESRI)读写 |
254
- | `ProjNet4GeoAPI` | 坐标参考系与投影变换 |
320
+ | `NetTopologySuite.IO.GeoJSON` | GeoJSON 读写(Newtonsoft.Json) |
321
+ | `NetTopologySuite.IO.GeoJSON4STJ` | GeoJSON 读写(System.Text.Json,提供 `GeoJsonConverterFactory`) |
322
+ | `NetTopologySuite.IO.Esri.Shapefile` | Shapefile 读写(命名空间 `NetTopologySuite.IO.Esri`) |
323
+ | `ProjNet` | 坐标参考系与投影变换(当前主线 2.1.0;旧包 `ProjNet4GeoAPI` 停在 1.4.1,新项目用 `ProjNet`) |
255
324
 
256
325
  ## 相关技能
257
326