@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/mapsui/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: mapsui
|
|
3
|
-
description: "Use when embedding interactive 2D maps in .NET desktop (WinForms
|
|
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
|
-
|
|
40
|
-
dotnet add package Mapsui.
|
|
41
|
-
dotnet add package Mapsui.
|
|
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
|
-
|
|
90
|
-
|
|
91
|
-
|
|
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
|
|
214
|
+
using Mapsui.Projections;
|
|
215
215
|
|
|
216
216
|
var map = new Map();
|
|
217
217
|
|
|
218
|
-
// 1.
|
|
218
|
+
// 1. OSM 底图(来自 Mapsui.Tiling)
|
|
219
219
|
map.Layers.Add(OpenStreetMap.CreateTileLayer());
|
|
220
220
|
|
|
221
|
-
// 2.
|
|
222
|
-
|
|
221
|
+
// 2. 构造点图层。Mapsui 的视图坐标系默认是 Web Mercator(EPSG:3857),
|
|
222
|
+
// GeoJSON/业务数据里的经纬度必须先投影,否则会画到南太平洋附近。
|
|
223
223
|
var features = new List<IFeature>();
|
|
224
|
-
|
|
224
|
+
var factory = NetTopologySuite.NtsGeometryServices.Instance.CreateGeometryFactory(3857);
|
|
225
|
+
|
|
226
|
+
foreach (var item in poiList) // item:含 Lon / Lat / Name 的 POI 记录
|
|
225
227
|
{
|
|
226
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
244
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
267
|
-
-
|
|
268
|
-
-
|
|
269
|
-
-
|
|
270
|
-
-
|
|
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
|
|
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
|
-
|
|
43
|
-
|
|
44
|
-
dotnet add package
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
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 包) |
|
|
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
|
-
-
|
|
241
|
-
-
|
|
242
|
-
-
|
|
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.
|
|
254
|
-
| `
|
|
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
|
|