@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.
- package/CHANGELOG.md +95 -0
- package/README.md +68 -28
- package/THIRD_PARTY_NOTICES.md +9 -0
- package/adaptations/brutile.md +8 -0
- package/adaptations/cesiumjs.md +8 -0
- package/adaptations/common.md +19 -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 +9 -0
- package/adaptations/opengis-daf.md +9 -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 +283 -0
- package/assets/cesiumjs/SKILL.md +81 -35
- package/assets/deck-gl/SKILL.md +26 -34
- package/assets/duckdb-spatial/SKILL.md +363 -0
- package/assets/gdal/SKILL.md +55 -33
- package/assets/gdal/reference/raster-tools.md +14 -0
- package/assets/gdal/reference/vector-tools.md +5 -0
- package/assets/gdal-api/SKILL.md +12 -18
- package/assets/gdal-api/reference/raster-api.md +7 -0
- package/assets/gdal-api/reference/vector-api.md +9 -0
- package/assets/geolibre/SKILL.md +357 -0
- package/assets/geometry-api-java/SKILL.md +10 -16
- package/assets/geometry-api-net/SKILL.md +70 -32
- package/assets/geometry-api-net/reference/geometry-types.md +5 -0
- package/assets/geonode/SKILL.md +340 -0
- package/assets/geopandas/SKILL.md +21 -24
- package/assets/geopandas/reference/core-api.md +4 -0
- package/assets/geopipe-agent/SKILL.md +29 -31
- package/assets/geopipe-agent/reference/steps-reference.md +12 -0
- package/assets/geopipe-agent/reference/workflows.md +8 -0
- package/assets/geoserver/SKILL.md +10 -15
- package/assets/geoserver-cloud/SKILL.md +25 -33
- package/assets/geoserver-rest-api/SKILL.md +17 -19
- package/assets/geoserver-rest-api/reference/endpoints.md +16 -0
- package/assets/geotools/SKILL.md +12 -17
- package/assets/geotools/reference/raster-rendering.md +5 -0
- package/assets/geotools/reference/vector-io.md +7 -0
- package/assets/grass-gis/SKILL.md +26 -33
- package/assets/jts/SKILL.md +12 -16
- package/assets/jts/reference/geometry-operations.md +13 -0
- package/assets/kepler-gl/SKILL.md +306 -0
- package/assets/leaflet/SKILL.md +58 -40
- package/assets/mapbox-gl-js/SKILL.md +26 -33
- package/assets/mapserver/SKILL.md +21 -29
- package/assets/mapsui/SKILL.md +109 -63
- package/assets/nettopologysuite/SKILL.md +96 -31
- package/assets/opengis-all/SKILL.md +91 -289
- package/assets/opengis-all/reference/data-stages.md +269 -4
- package/assets/opengis-all/reference/workflow-cheatsheets.md +7 -0
- package/assets/opengis-daf/SKILL.md +10 -17
- package/assets/opengis-utils-for-java/SKILL.md +58 -49
- package/assets/opengis-utils-for-java/reference/common-tasks.md +16 -12
- package/assets/opengis-utils-for-net/SKILL.md +109 -48
- package/assets/opengis-utils-for-net/reference/code-patterns.md +15 -11
- package/assets/opengis-utils-for-net/reference/util-classes.md +35 -26
- package/assets/openlayers/SKILL.md +81 -28
- package/assets/pdal/SKILL.md +25 -27
- package/assets/postgis/SKILL.md +80 -35
- package/assets/proj/SKILL.md +32 -41
- package/assets/projnet4geoapi/SKILL.md +293 -0
- package/assets/pyqgis/SKILL.md +33 -30
- package/assets/pyqgis/reference/processing-rendering.md +6 -0
- package/assets/pyqgis/reference/vector-raster-layers.md +6 -0
- package/assets/qgis-process/SKILL.md +75 -33
- package/assets/qgis-process/reference/algorithm-cheatsheet.md +6 -0
- package/assets/qgis-server/SKILL.md +25 -31
- package/assets/shapely/SKILL.md +136 -84
- package/assets/shapely/reference/operations-reference.md +12 -0
- package/assets/sharpmap/SKILL.md +97 -60
- package/assets/spatialite/SKILL.md +358 -0
- package/assets/whitebox-tools/SKILL.md +262 -0
- package/lib/adaptations.d.ts +53 -0
- package/lib/adaptations.js +343 -0
- package/lib/catalog.d.ts +7 -1
- package/lib/catalog.js +9 -1
- package/lib/index.d.ts +10 -1
- package/lib/index.js +34 -3
- package/lib/skill-file.d.ts +12 -0
- package/lib/skill-file.js +133 -18
- package/locale/en.json +1 -1
- package/locale/zh.json +1 -1
- package/package.json +12 -2
- 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
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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.
|
|
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
|
-
-
|
|
271
|
-
-
|
|
272
|
-
-
|
|
273
|
-
-
|
|
274
|
-
-
|
|
275
|
-
-
|
|
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
|
-
##
|
|
281
|
+
## 参考资源
|
|
289
282
|
|
|
290
|
-
-
|
|
291
|
-
-
|
|
292
|
-
-
|
|
293
|
-
-
|
|
294
|
-
-
|
|
295
|
-
-
|
|
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/>
|
package/assets/mapsui/SKILL.md
CHANGED
|
@@ -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
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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-
|
|
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
|
-
|
|
40
|
-
dotnet add package Mapsui.
|
|
41
|
-
dotnet add package Mapsui.
|
|
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
|
-
|
|
90
|
-
|
|
91
|
-
|
|
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
|
-
|
|
136
|
-
|
|
137
|
-
|
|
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
|
|
223
|
+
using Mapsui.Projections;
|
|
215
224
|
|
|
216
225
|
var map = new Map();
|
|
217
226
|
|
|
218
|
-
// 1.
|
|
227
|
+
// 1. OSM 底图(来自 Mapsui.Tiling)
|
|
219
228
|
map.Layers.Add(OpenStreetMap.CreateTileLayer());
|
|
220
229
|
|
|
221
|
-
// 2.
|
|
222
|
-
|
|
230
|
+
// 2. 构造点图层。Mapsui 的视图坐标系默认是 Web Mercator(EPSG:3857),
|
|
231
|
+
// GeoJSON/业务数据里的经纬度必须先投影,否则会画到南太平洋附近。
|
|
223
232
|
var features = new List<IFeature>();
|
|
224
|
-
|
|
233
|
+
var factory = NetTopologySuite.NtsGeometryServices.Instance.CreateGeometryFactory(3857);
|
|
234
|
+
|
|
235
|
+
foreach (var item in poiList) // item:含 Lon / Lat / Name 的 POI 记录
|
|
225
236
|
{
|
|
226
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
244
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
257
|
-
-
|
|
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
|
|
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
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
-
|
|
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
|
-
>
|
|
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
|
-
|
|
43
|
-
|
|
44
|
-
dotnet add package
|
|
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+**
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
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
|
-
##
|
|
300
|
+
## AI 使用建议
|
|
236
301
|
|
|
237
|
-
-
|
|
238
|
-
-
|
|
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
|
|
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.
|
|
252
|
-
| `
|
|
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
|
|