@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
|
@@ -0,0 +1,357 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: geolibre
|
|
3
|
+
description: "Use when scripting or self-hosting the GeoLibre GIS app — geolibre Python anywidget (Map/add_geojson/add_cog/save_project), geolibre-mcp stdio server for AI agents, ghcr.io/opengeos/geolibre Docker image, DuckDB-WASM SQL workspace, ?data= and ?url= deep links; also for a blank window on Linux WebKitGTK, sidecar path not allowed from GEOLIBRE_CONVERSION_ROOTS, and Jupyter relay not connected. GeoLibre 3.7.0."
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "geolibre, gis, python, jupyter, mcp, duckdb, docker, webgis, tauri, geospatial"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
> **项目地址:** <https://github.com/opengeos/GeoLibre>
|
|
11
|
+
>
|
|
12
|
+
> **官方文档:** <https://geolibre.app/getting-started/>
|
|
13
|
+
>
|
|
14
|
+
> **在线版:** <https://web.geolibre.app>
|
|
15
|
+
>
|
|
16
|
+
> **最新版本:** 3.7.0(截至 2026-11,[PyPI](https://pypi.org/project/geolibre/) / [GitHub Releases](https://github.com/opengeos/GeoLibre/releases));要求 Python >= 3.11,conda-forge 同步为 3.7.0
|
|
17
|
+
>
|
|
18
|
+
> **许可证:** MIT
|
|
19
|
+
|
|
20
|
+
## 概述
|
|
21
|
+
|
|
22
|
+
GeoLibre 是一个云原生 GIS 应用,同一份代码可运行在浏览器、桌面(Tauri v2)、移动端与 Jupyter Notebook 里。它把地图渲染、矢量/栅格/点云浏览、SQL 分析与上千个地理处理工具装进一个前端应用,数据默认留在本机。
|
|
23
|
+
|
|
24
|
+
对脚本与自动化最相关的四个入口:
|
|
25
|
+
|
|
26
|
+
- **Python 包**:geolibre.Map(anywidget)把整个应用嵌进 Notebook,并暴露 leafmap 风格的 API
|
|
27
|
+
- **MCP 服务器**:geolibre-mcp 以无头方式读写 .geolibre.json 工程,供 AI 客户端调用
|
|
28
|
+
- **Docker 镜像**:ghcr.io/opengeos/geolibre:latest 自托管 Web 版,可选 sidecar 与 Basic Auth
|
|
29
|
+
- **SQL 工作区**:DuckDB-WASM 加 spatial 扩展,把地图上的每个矢量图层当成 SQL 表
|
|
30
|
+
|
|
31
|
+
技术栈为 Tauri v2 + React + TypeScript + MapLibre GL JS + DuckDB-WASM Spatial + deck.gl;渲染引擎可在 MapLibre、Mapbox、CesiumJS、ArcGIS 之间切换。地理处理工具(地形、水文、点云、遥感、矢量分析)通过 WebAssembly 在浏览器里执行,不需要服务端。
|
|
32
|
+
|
|
33
|
+
## 环境准备
|
|
34
|
+
|
|
35
|
+
### 路径一:零安装(浏览器)
|
|
36
|
+
|
|
37
|
+
访问 <https://web.geolibre.app>。网页版可读浏览器能选择的数据、URL 服务、COG 与远程 GeoParquet,但没有本地文件对话框,也不能读本地 MBTiles/栅格。
|
|
38
|
+
|
|
39
|
+
### 路径二:桌面应用
|
|
40
|
+
|
|
41
|
+
| 平台 | 命令 / 入口 |
|
|
42
|
+
|------|-------------|
|
|
43
|
+
| Windows(Store,推荐) | <https://apps.microsoft.com/detail/9nwt67rv531x> |
|
|
44
|
+
| Windows(winget,未签名构建) | `winget install OpenGeos.GeoLibre` |
|
|
45
|
+
| macOS(Homebrew Cask) | `brew install --cask geolibre` |
|
|
46
|
+
| Arch / Manjaro | `yay -S geolibre-bin` |
|
|
47
|
+
| Fedora / RHEL(COPR) | `sudo dnf copr enable giswqs/geolibre && sudo dnf install geolibre` |
|
|
48
|
+
| Flatpak | `flatpak install flatpark app.geolibre.GeoLibre` |
|
|
49
|
+
| Debian / Ubuntu | `sudo apt install ./GeoLibre.Desktop_<version>_amd64.deb` |
|
|
50
|
+
|
|
51
|
+
验证:启动后 **Help → About** 核对版本为 3.7.x,**Help → Diagnostics** 应无红色错误项。
|
|
52
|
+
|
|
53
|
+
### 路径三:Python 包(Notebook / 脚本)
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
pip install geolibre==3.7.0
|
|
57
|
+
|
|
58
|
+
# 或 conda-forge
|
|
59
|
+
conda install -c conda-forge geolibre
|
|
60
|
+
|
|
61
|
+
# 可选 extras
|
|
62
|
+
pip install "geolibre[dash]" # DashMap 组件
|
|
63
|
+
pip install "geolibre[mcp]" # geolibre-mcp 控制台脚本
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
```python
|
|
67
|
+
from geolibre import Map
|
|
68
|
+
print(Map.__module__) # 能 import 即为安装成功
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
### 路径四:Docker 自托管
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
docker pull ghcr.io/opengeos/geolibre:latest
|
|
75
|
+
docker run --rm -p 8080:80 ghcr.io/opengeos/geolibre:latest
|
|
76
|
+
# 打开 http://localhost:8080
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
需要 sidecar(转换、栅格、PostGIS 等本地工具)时挂载数据目录并限制可访问路径:
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
docker run --rm -p 8080:80 \
|
|
83
|
+
-v "$PWD/data:/data" \
|
|
84
|
+
-e GEOLIBRE_CONVERSION_ROOTS=/data \
|
|
85
|
+
ghcr.io/opengeos/geolibre:latest
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
加共享密码(应用与 /sidecar 都启用 HTTP Basic Auth,/healthz 除外):
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
docker run --rm -p 8080:80 \
|
|
92
|
+
-e GEOLIBRE_AUTH_USER=admin \
|
|
93
|
+
-e GEOLIBRE_AUTH_PASSWORD='change-me' \
|
|
94
|
+
ghcr.io/opengeos/geolibre:latest
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### 路径五:源码运行
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
git clone https://github.com/opengeos/GeoLibre.git
|
|
101
|
+
cd GeoLibre
|
|
102
|
+
npm install # 需要 Node 22+
|
|
103
|
+
npm run dev # 浏览器开发服务器 http://localhost:5173
|
|
104
|
+
npm run tauri:dev # 桌面应用(需要 Rust 工具链)
|
|
105
|
+
npm run build # Web 生产构建
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
## 核心接口
|
|
109
|
+
|
|
110
|
+
### Python:geolibre.Map
|
|
111
|
+
|
|
112
|
+
| 方法 | 说明 |
|
|
113
|
+
|------|------|
|
|
114
|
+
| Map(center=(lng, lat), zoom=4) | 创建内嵌应用;参数决定初始视图 |
|
|
115
|
+
| add_geojson(data, name=, **style) | 加矢量图层,接受 URL、dict、GeoDataFrame、JSON 字符串 |
|
|
116
|
+
| add_tile_layer(url, name=, attribution=) | XYZ 栅格瓦片 |
|
|
117
|
+
| add_cog(url, name=, colormap=) | 云优化 GeoTIFF |
|
|
118
|
+
| add_basemap(name) | 切换底图(如 "dark") |
|
|
119
|
+
| set_center(lng, lat, zoom=) | 移动相机 |
|
|
120
|
+
| save_project(path) / load_project(path) | 读写 .geolibre.json 工程 |
|
|
121
|
+
| to_project() | 取当前工程状态(dict),用于回读 UI 侧编辑 |
|
|
122
|
+
|
|
123
|
+
```python
|
|
124
|
+
from geolibre import Map
|
|
125
|
+
|
|
126
|
+
m = Map(center=(-100, 40), zoom=4)
|
|
127
|
+
m.add_geojson("https://example.com/data.geojson", name="Data")
|
|
128
|
+
m.add_tile_layer(
|
|
129
|
+
"https://tile.openstreetmap.org/{z}/{x}/{y}.png",
|
|
130
|
+
name="OpenStreetMap",
|
|
131
|
+
attribution="(c) OpenStreetMap contributors",
|
|
132
|
+
)
|
|
133
|
+
m.add_cog("https://example.com/dem.tif", name="DEM", colormap="terrain")
|
|
134
|
+
m.add_basemap("dark")
|
|
135
|
+
m.set_center(-120, 47, zoom=8)
|
|
136
|
+
m.save_project("my-map.geolibre.json")
|
|
137
|
+
m # 最后一行放在单元格末尾才会渲染
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
工程状态双向同步:Python 加的图层会出现在 UI,UI 里平移/缩放后再 to_project() 能读回新的 mapView.center。
|
|
141
|
+
|
|
142
|
+
```python
|
|
143
|
+
m2 = Map()
|
|
144
|
+
m2.load_project("my-map.geolibre.json")
|
|
145
|
+
print(m2.to_project()["mapView"]["center"])
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
### Python:Google Earth Engine 图层
|
|
149
|
+
|
|
150
|
+
```bash
|
|
151
|
+
pip install earthengine-api
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
```python
|
|
155
|
+
import ee
|
|
156
|
+
ee.Authenticate() # 每台机器一次
|
|
157
|
+
ee.Initialize(project="your-gcp-project")
|
|
158
|
+
|
|
159
|
+
from geolibre import Map
|
|
160
|
+
m = Map()
|
|
161
|
+
m.add_ee_layer(ee.Image("USGS/SRTMGL1_003"), {"min": 0, "max": 3000}, name="SRTM")
|
|
162
|
+
m
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
### MCP 服务器:geolibre-mcp
|
|
166
|
+
|
|
167
|
+
无头写工程:不需要浏览器、不需要运行中的应用,产出与桌面/网页版能加载的工程同构。
|
|
168
|
+
|
|
169
|
+
```bash
|
|
170
|
+
pip install "geolibre[mcp]"
|
|
171
|
+
geolibre-mcp --root ~/maps
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
| 参数 / 变量 | 说明 |
|
|
175
|
+
|-------------|------|
|
|
176
|
+
| --root | 可重复,声明工作区根目录 |
|
|
177
|
+
| GEOLIBRE_MCP_ROOTS | 环境变量版,冒号分隔(Windows 用分号) |
|
|
178
|
+
| --transport | stdio(默认,客户端 spawn 用)、streamable-http、sse |
|
|
179
|
+
|
|
180
|
+
客户端配置(Claude Desktop 等):
|
|
181
|
+
|
|
182
|
+
```json
|
|
183
|
+
{
|
|
184
|
+
"mcpServers": {
|
|
185
|
+
"geolibre": {
|
|
186
|
+
"command": "geolibre-mcp",
|
|
187
|
+
"args": ["--root", "C:/Users/you/maps"]
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
支持 MCP 的客户端(Claude Code、Cursor、Cline、OpenCode 等)都把上段 JSON 写进各自的 MCP 配置即可;以 Claude Code 为例的一行注册:
|
|
194
|
+
|
|
195
|
+
```bash
|
|
196
|
+
claude mcp add geolibre -- geolibre-mcp --root ~/maps
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
常用工具分组:
|
|
200
|
+
|
|
201
|
+
| 分组 | 工具 |
|
|
202
|
+
|------|------|
|
|
203
|
+
| 工程生命周期 | create_project、describe_project、list_catalog |
|
|
204
|
+
| 加图层 | add_geojson_layer、add_vector_layer、add_raster_layer、add_tile_layer、add_ogc_layer、add_3d_tiles_layer |
|
|
205
|
+
| 编辑 | update_layer、remove_layer、style_layer、set_layer_metadata、set_layer_filter |
|
|
206
|
+
| 取景与装饰 | set_view、set_basemap、add_legend、add_colorbar、add_swipe |
|
|
207
|
+
| 导出 | export_html(独立页面)、show_map(支持 MCP Apps 的客户端内联预览) |
|
|
208
|
+
| 实时地图 | live_status、live_fly_to、live_add_geojson、live_run_algorithm |
|
|
209
|
+
|
|
210
|
+
list_catalog 应该是第一个调用的工具:底图、色带、图例预设、插件 id 都以它为准,猜错名字不会报错,只会静默不生效。
|
|
211
|
+
|
|
212
|
+
工作区安全模型(决定为什么有些路径写不进去):
|
|
213
|
+
|
|
214
|
+
| 闸门 | 规则 |
|
|
215
|
+
|------|------|
|
|
216
|
+
| 路径解析 | 每次调用的路径都按允许根解析,根之外与"根内指向根外的符号链接"一律拒绝 |
|
|
217
|
+
| 扩展名 | 只写 .json(工程)或 .html(导出) |
|
|
218
|
+
| 覆盖 | 不带 overwrite 不覆盖已存在文件 |
|
|
219
|
+
| 大小 | 内联 GeoJSON 不超过 50 MB,工程文件读取不超过 256 MB |
|
|
220
|
+
|
|
221
|
+
给它一个专门放地图的目录,不要给家目录。
|
|
222
|
+
|
|
223
|
+
### SQL 工作区(DuckDB-WASM)
|
|
224
|
+
|
|
225
|
+
**Processing → SQL Workspace** 打开,面板停靠在地图下方。地图上每个矢量图层同时是一张 SQL 表:
|
|
226
|
+
|
|
227
|
+
- 表名规则:小写、非字母数字压成下划线、数字开头加 t_ 前缀、保留字加前缀、重名追加 _2
|
|
228
|
+
- 几何列名:DuckDB 与 PostGIS 引擎为 geom,Sedona 为 geometry
|
|
229
|
+
- 支持三种引擎:DuckDB(默认,可直读远程文件)、PostGIS(PGlite)、Apache Sedona(CereusDB,单层上限 5 万要素)
|
|
230
|
+
|
|
231
|
+
```sql
|
|
232
|
+
-- 两个图层直接 JOIN:城市点落在哪个国家
|
|
233
|
+
SELECT c.NAME AS country, p.name AS city, p.geom
|
|
234
|
+
FROM cities p
|
|
235
|
+
JOIN countries c
|
|
236
|
+
ON ST_Intersects(c.geom, p.geom)
|
|
237
|
+
WHERE c.CONTINENT = 'Africa';
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
结果区可 **Add as layer**(物化)或 **Add as query layer**(活查询,仅 DuckDB)。
|
|
241
|
+
|
|
242
|
+
### Web 版 URL 参数(分享与嵌入)
|
|
243
|
+
|
|
244
|
+
| 参数 | 作用 |
|
|
245
|
+
|------|------|
|
|
246
|
+
| url= | 打开一个公开 .geolibre 工程 |
|
|
247
|
+
| data= | 直接打开托管数据,可重复(GeoJSON、GeoParquet、PMTiles、COG、LiDAR 等) |
|
|
248
|
+
| style= | 给 data= 应用样式 JSON |
|
|
249
|
+
| layout=compact | 图标化工具栏,适合窄嵌入 |
|
|
250
|
+
| layout=viewer | 只读查看器预设 |
|
|
251
|
+
| panels=none / maponly | 隐藏面板 / 完全去掉工具栏与状态栏 |
|
|
252
|
+
|
|
253
|
+
```text
|
|
254
|
+
https://web.geolibre.app/?data=https://example.org/places.geojson&layout=compact&panels=none
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
### 关键环境变量
|
|
258
|
+
|
|
259
|
+
| 变量 | 作用 |
|
|
260
|
+
|------|------|
|
|
261
|
+
| GEOLIBRE_CONVERSION_ROOTS | sidecar 允许读写的目录白名单(Docker 镜像内默认 /data) |
|
|
262
|
+
| GEOLIBRE_DISABLE_SIDECAR=1 | 纯静态 Web 行为,不起 sidecar |
|
|
263
|
+
| GEOLIBRE_AUTH_USER / GEOLIBRE_AUTH_PASSWORD | nginx 层 HTTP Basic Auth |
|
|
264
|
+
| GEOLIBRE_CAPABILITIES | 逗号分隔的能力白名单(或 none),用于只读门户/展厅 |
|
|
265
|
+
| GEOLIBRE_EMBED_ORIGINS | 允许通过 iframe/postMessage 驱动应用的来源 |
|
|
266
|
+
| GEOLIBRE_STORE_BUILD / GEOLIBRE_MAS_BUILD | 商店构建开关(移除自动更新 / sidecar 能力) |
|
|
267
|
+
|
|
268
|
+
## 典型工作流:MCP 生成工程 → 桌面打开 → 导出独立 HTML
|
|
269
|
+
|
|
270
|
+
目标:不打开应用,用 AI 客户端生成一张城市地图,人工在桌面版微调后导出为可分发的单页。
|
|
271
|
+
|
|
272
|
+
**步骤 1:装 MCP 并准备目录**
|
|
273
|
+
|
|
274
|
+
```bash
|
|
275
|
+
pip install "geolibre[mcp]"
|
|
276
|
+
mkdir -p ~/maps
|
|
277
|
+
claude mcp add geolibre -- geolibre-mcp --root ~/maps
|
|
278
|
+
```
|
|
279
|
+
|
|
280
|
+
**步骤 2:让客户端依次调用工具(工具序列)**
|
|
281
|
+
|
|
282
|
+
```text
|
|
283
|
+
list_catalog() # 先查有哪些底图/色带/插件 id
|
|
284
|
+
create_project(name="beijing", center=[116.39, 39.90], zoom=10)
|
|
285
|
+
add_geojson_layer(url="https://example.org/poi.geojson", name="POI")
|
|
286
|
+
style_layer(layer="POI", fillColor="#f97316", circleRadius=6)
|
|
287
|
+
set_view(center=[116.39, 39.90], zoom=11) # 精确取景用 center+zoom,不要用 bbox
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
产出一个 .geolibre.json(工作区内,扩展名只能是 .json 或 .html)。
|
|
291
|
+
|
|
292
|
+
**步骤 3:桌面版打开并微调**
|
|
293
|
+
|
|
294
|
+
双击工程文件(桌面安装包已注册文件关联),调整样式、加图例(add_legend / set_map_legend),必要时用 **Project → Save** 写回。
|
|
295
|
+
|
|
296
|
+
**步骤 4:导出可分发的 HTML**
|
|
297
|
+
|
|
298
|
+
```text
|
|
299
|
+
export_html(path="beijing.html", app_url="https://web.geolibre.app")
|
|
300
|
+
```
|
|
301
|
+
|
|
302
|
+
export_html 会剥掉凭据;指向本地文件的图层在别人机器上不会加载,要分享就用托管 URL。app_url 是信任边界——工程内容会被 POST 到那个来源,只填你本来就信任的地址。
|
|
303
|
+
|
|
304
|
+
**步骤 5:验证**
|
|
305
|
+
|
|
306
|
+
```bash
|
|
307
|
+
python -c "import json;d=json.load(open('beijing.geolibre.json'));print(len(d.get('layers',[])),'layers')"
|
|
308
|
+
```
|
|
309
|
+
|
|
310
|
+
再在浏览器打开 beijing.html,确认底图与图层能渲染、点击要素有弹窗。
|
|
311
|
+
|
|
312
|
+
## 最佳实践
|
|
313
|
+
|
|
314
|
+
1. **生成用 MCP 或 Python 包,审阅用 GUI**:无头路径可重复、可测试,GUI 微调难以复现。
|
|
315
|
+
2. **工程文件走版本控制**:.geolibre.json 是纯 JSON,diff 友好;大 GeoJSON 放外部 URL 而不是内联。
|
|
316
|
+
3. **sidecar 路径走白名单目录**:自托管时把数据挂到 GEOLIBRE_CONVERSION_ROOTS 声明的目录下。
|
|
317
|
+
4. **只读门户用能力策略**:GEOLIBRE_CAPABILITIES 受限或 none,配 layout=viewer,避免把编辑能力暴露出去。
|
|
318
|
+
5. **嵌入要声明来源**:iframe 驱动需要 GEOLIBRE_EMBED_ORIGINS 白名单,否则命令会被丢弃。
|
|
319
|
+
6. **实时工具有前提**:桌面版每次启动后要先打开一次 **Processing → Jupyter Notebook** 启动中继;网页版与 JupyterLite 没有中继。
|
|
320
|
+
|
|
321
|
+
## 常见问题
|
|
322
|
+
|
|
323
|
+
| 问题 | 原因 | 解决方案 |
|
|
324
|
+
|------|------|---------|
|
|
325
|
+
| Linux 桌面版窗口空白或地图闪烁 | WebKitGTK 的 DMA-BUF 渲染器与驱动不兼容 | 用传统渲染器启动:WEBKIT_DISABLE_DMABUF_RENDERER=1 geolibre-desktop;若被自动降到传统渲染器后很慢,改回 0 再试 |
|
|
326
|
+
| 无 AVX 的老 CPU 上窗口永不绘制 | JavaScriptCore 的 WebAssembly JIT 触发 SIGILL | 成对设置 JSC_useWasmOSR=false 与 JSC_useBBQTierUpChecks=false |
|
|
327
|
+
| MCP 返回路径不允许或工具直接拒绝 | 路径不在 --root 或 GEOLIBRE_MCP_ROOTS 内,或是指向根外的符号链接 | 把工程目录加进 --root,或把文件移到根内;不要给家目录 |
|
|
328
|
+
| geolibre-mcp 不在客户端 PATH 里 | 装在 virtualenv 中,客户端 spawn 时用系统 PATH | 配置里改用解释器:command 指向 venv 的 python,args 用 -m geolibre.mcp --root ... |
|
|
329
|
+
| live_ 工具报没连接或超时 | 桌面版中继没启动,或大 FeatureCollection 超过约 5 秒 | 先打开一次 Processing → Jupyter Notebook;超时不代表失败,用 live_list_layers 回查而不是重发 |
|
|
330
|
+
| add_geojson / list_layers 返回 None 或抛 GeoLibreNotConnectedError | 没有窗口在监听,或读回在网页版不可用 | 确认至少一个桌面窗口连到同一 Jupyter 服务器;同步读回只在桌面版可用 |
|
|
331
|
+
| SQL 工作区里 ST_Intersects 报函数不存在 | 引擎未加载空间扩展,或图层未按几何列注册 | 检查 Queryable layers 里的表名与几何列名(DuckDB/PostGIS 是 geom,Sedona 是 geometry) |
|
|
332
|
+
| 自托管转换报路径不允许 | 触到 GEOLIBRE_CONVERSION_ROOTS 白名单 | 输出到白名单目录内,或调整该变量 |
|
|
333
|
+
| 网页版打开本地文件后刷新就没了 | 浏览器安全模型不给持久文件路径 | 用桌面版做本地文件工作,或用 data= 指向托管 URL |
|
|
334
|
+
| 沙盒(Mac App Store)版加载松散 Shapefile 丢属性 | 沙盒授权只覆盖显式选择的文件 | 一次选中所有分片(.shp/.dbf/.prj)或用压缩包 |
|
|
335
|
+
|
|
336
|
+
## AI 使用建议
|
|
337
|
+
|
|
338
|
+
- **先确认版本与入口**:pip show geolibre 看版本,geolibre-mcp --help 看参数;桌面版看 Help → About。教程可能对应 3.4/3.5,遇到差异以 3.7.0 的实际行为为准。
|
|
339
|
+
- **装包前确认 Python 版本**:PyPI 的 geolibre 3.7.0 要求 Python >= 3.11;低版本解释器会直接安装失败,不要误判为网络问题。
|
|
340
|
+
- **MCP 路径要显式**:Windows 上 JSON 里写正向斜杠(C:/Users/you/maps),反斜杠需成对转义,容易出错。
|
|
341
|
+
- **验证产物**:写完工程先 json.load 检查图层数与 mapView,再用浏览器打开导出的 HTML 看渲染;不要只看工具返回的成功。
|
|
342
|
+
- **写操作确认**:export_html、save_project 与 MCP 的覆盖写会改写磁盘文件;覆盖前确认目标,或先写新文件名。
|
|
343
|
+
|
|
344
|
+
## 相关技能
|
|
345
|
+
|
|
346
|
+
- **duckdb-spatial** — SQL 工作区背后的空间分析引擎:[../duckdb-spatial/SKILL.md](../duckdb-spatial/SKILL.md)
|
|
347
|
+
- **openlayers** — 自建 Web 地图前端时的核心库:[../openlayers/SKILL.md](../openlayers/SKILL.md)
|
|
348
|
+
- **cesiumjs** — GeoLibre 的 3D 球渲染引擎之一:[../cesiumjs/SKILL.md](../cesiumjs/SKILL.md)
|
|
349
|
+
- **qgis-process** — 桌面 GIS 的另一种无头批处理路径:[../qgis-process/SKILL.md](../qgis-process/SKILL.md)
|
|
350
|
+
- **opengis-all** — 全流程 GIS 索引:[../opengis-all/SKILL.md](../opengis-all/SKILL.md)
|
|
351
|
+
|
|
352
|
+
## 参考资源
|
|
353
|
+
- 官方文档:<https://geolibre.app/getting-started/>
|
|
354
|
+
- 下载页:<https://geolibre.app/downloads/>
|
|
355
|
+
- Python 包文档:<https://geolibre.app/python/>
|
|
356
|
+
- 功能列表:<https://geolibre.app/features/>
|
|
357
|
+
- 渲染引擎对比:<https://geolibre.app/user-guide/rendering-engines/>
|
|
@@ -1,15 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: geometry-api-java
|
|
3
3
|
description: "Use when working with Esri geometry types (Point, Polyline, Polygon, Envelope) in Java — GeometryEngine, com.esri.geometry:esri-geometry-api:2.2.4, WKT/WKB/GeoJSON/Esri JSON I/O, geodesic distance; also when GeometryEngine has no intersects or WKB method and you need OperatorFactoryLocal, or when 2.3.1 coordinates fail to resolve on Maven Central. Esri Geometry API for Java."
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
- spatial
|
|
9
|
-
- wkt
|
|
10
|
-
- wkb
|
|
11
|
-
- geojson
|
|
12
|
-
- geodesic
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "java, geometry, esri, spatial, wkt, wkb, geojson, geodesic"
|
|
13
8
|
---
|
|
14
9
|
|
|
15
10
|
> **项目地址:** <https://github.com/Esri/geometry-api-java>
|
|
@@ -18,7 +13,7 @@ tags:
|
|
|
18
13
|
>
|
|
19
14
|
> **Maven Central:** `com.esri.geometry:esri-geometry-api`
|
|
20
15
|
>
|
|
21
|
-
> **最新版本:** 2.2.4(Maven Central,截至 2026-
|
|
16
|
+
> **最新版本:** 2.2.4(Maven Central,截至 2026-11);上游源码 2.3.1(2026-10-09),未发布到 Central
|
|
22
17
|
>
|
|
23
18
|
> **许可证:** Apache-2.0
|
|
24
19
|
|
|
@@ -124,8 +119,8 @@ MapGeometry mapGeom = new MapGeometry(pt, srWGS84);
|
|
|
124
119
|
```java
|
|
125
120
|
SpatialReference sr = SpatialReference.create(4326);
|
|
126
121
|
|
|
127
|
-
//
|
|
128
|
-
|
|
122
|
+
// 缓冲区(返回 Polygon)
|
|
123
|
+
Polygon buffered = GeometryEngine.buffer(point, sr, 100.0);
|
|
129
124
|
|
|
130
125
|
// 交集
|
|
131
126
|
Geometry inter = GeometryEngine.intersect(polygon1, polygon2, sr);
|
|
@@ -334,7 +329,7 @@ Geometry polygon = GeometryEngine.geometryFromWkt(
|
|
|
334
329
|
|
|
335
330
|
SpatialReference sr = SpatialReference.create(4326);
|
|
336
331
|
|
|
337
|
-
// 2.
|
|
332
|
+
// 2. 缓冲区分析(GeometryEngine.buffer 返回 Polygon)
|
|
338
333
|
Polygon buffered = GeometryEngine.buffer(polygon, sr, 2.0);
|
|
339
334
|
|
|
340
335
|
// 3. 相交判断(算子调用)
|
|
@@ -376,10 +371,9 @@ if (hit) {
|
|
|
376
371
|
|
|
377
372
|
---
|
|
378
373
|
|
|
379
|
-
##
|
|
374
|
+
## AI 使用建议
|
|
380
375
|
|
|
381
|
-
-
|
|
382
|
-
- **执行环境**:先 `mvn -v` 与 `java -version` 确认工具链(JDK 8+ 即可编译,建议 17/21 运行),Windows 上用 `pwsh` 执行;`%JAVA_HOME%`/`JAVA_HOME` 与 `mvn` 实际使用的 JDK 可能不同,报 `Unsupported class file major version` 时按 `mvn -v` 显示的 JDK 判断。
|
|
376
|
+
- **执行环境**:先 `mvn -v` 与 `java -version` 确认工具链(JDK 8+ 即可编译,建议 17/21 运行),Windows 上用 PowerShell 执行;`%JAVA_HOME%`/`JAVA_HOME` 与 `mvn` 实际使用的 JDK 可能不同,报 `Unsupported class file major version` 时按 `mvn -v` 显示的 JDK 判断。
|
|
383
377
|
- **依赖坐标**:`com.esri.geometry:esri-geometry-api:2.2.4` 是 Maven Central 最新(2020-09 发布);上游 2.3.1(2026-10-09)未发布到 Central。先 `mvn dependency:get -Dartifact=com.esri.geometry:esri-geometry-api:2.2.4` 确认可解析,解析失败时报告“依赖不可下载”,不要自行改成 2.3.1 或别处坐标。
|
|
384
378
|
- **离线与网络**:首次 `mvn` 会拉依赖,无网或私服缺包时报 `Could not resolve dependencies`;不要为绕过它去改 `settings.xml`、加未知仓库或降级版本,先向用户要可用镜像。
|
|
385
379
|
- **验证产物**:写最小 main(或 JUnit)断言三件事——`geometryFromWkt` → `geometryToWkt` 往返等价、`GeometryEngine.buffer(poly, sr, 2.0)` 后 `getEnvelope()` 向外扩张、`geometryToGeoJson` 能被 `geoJsonToGeometry` 重新读入;`mvn -q -DskipTests package` 只证明能编译,不代表几何正确。
|
|
@@ -1,37 +1,30 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: geometry-api-net
|
|
3
3
|
description: "Use when working with Esri geometry types (Point, Polyline, Polygon, Envelope) in .NET/C# — GeometryEngine, NuGet OpenGIS.Esri.Geometry.Core 1.0.9, WKT/EWKT, WKB, GeoJSON and Esri JSON I/O, System.Text.Json converters, geodesic distance; also for unclosed polygon rings, Geometry base-class casts after overlay, or the retired Esri/geometry-api-net repo. Esri Geometry API for .NET."
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
- spatial
|
|
9
|
-
- wkt
|
|
10
|
-
- wkb
|
|
11
|
-
- geojson
|
|
12
|
-
- geodesic
|
|
13
|
-
- csharp
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "dotnet, geometry, esri, spatial, wkt, wkb, geojson, geodesic, csharp"
|
|
14
8
|
---
|
|
15
9
|
|
|
16
10
|
> **项目地址:** <https://github.com/znlgis/geometry-api-net>
|
|
17
11
|
>
|
|
18
12
|
> **官方文档:** <https://github.com/znlgis/geometry-api-net/wiki>
|
|
19
13
|
>
|
|
20
|
-
>
|
|
21
|
-
>
|
|
22
|
-
> **注意:** 原 Esri 仓库(github.com/Esri/geometry-api-net)已不再维护(404)。此分支由 znlgis 社区维护,已重命名为 OpenGIS.Esri.Geometry。
|
|
14
|
+
> **最新版本:** 1.0.9(2026-09-21 发布,[NuGet](https://www.nuget.org/packages/OpenGIS.Esri.Geometry.Core);截至 2026-11)
|
|
23
15
|
>
|
|
24
16
|
> **许可证:** LGPL-2.1
|
|
25
|
-
>
|
|
26
|
-
>
|
|
17
|
+
>
|
|
18
|
+
> **注意:** 原 Esri 仓库(github.com/Esri/geometry-api-net)已停止维护(404);此分支由 znlgis 社区维护,包名与命名空间已改为 `OpenGIS.Esri.Geometry`。
|
|
27
19
|
|
|
28
20
|
## 概述
|
|
29
21
|
|
|
30
|
-
这是一个 .NET Standard 2.0 的空间几何计算库,提供 6
|
|
22
|
+
这是一个 .NET Standard 2.0 的空间几何计算库,提供 6 种几何类型(Point、MultiPoint、Line、Polyline、Polygon、Envelope)、35 个算子类(`Operators` 命名空间 27 个几何算子 + `IO` 命名空间 8 个读写算子,含 8 个 DE-9IM 谓词:Contains/Crosses/Disjoint/Equals/Intersects/Overlaps/Touches/Within)和 4 种序列化格式(WKT/EWKT、WKB/EWKB、GeoJSON、Esri JSON)。
|
|
31
23
|
|
|
32
|
-
-
|
|
33
|
-
- **JSON
|
|
34
|
-
-
|
|
24
|
+
- **核心包**:`OpenGIS.Esri.Geometry.Core`(`GeometryEngine` 提供 39 个静态便捷方法)
|
|
25
|
+
- **JSON 扩展包**:`OpenGIS.Esri.Geometry.Json`(System.Text.Json 转换器)
|
|
26
|
+
- **许可证**:LGPL-2.1-only
|
|
27
|
+
- **能力边界**:不提供 `MakeValid`,`Simplify` 只做抽稀、不修复自相交环;需要几何修复请在上游(GEOS/PostGIS/JTS)完成后再导入。
|
|
35
28
|
|
|
36
29
|
## 快速开始
|
|
37
30
|
|
|
@@ -166,6 +159,50 @@ result.IsRightSide // bool, 是否在多路径几何的右侧
|
|
|
166
159
|
|
|
167
160
|
---
|
|
168
161
|
|
|
162
|
+
## 典型工作流
|
|
163
|
+
|
|
164
|
+
端到端:WKT 读入 → 有效性校验 → 叠加分析 → 输出 GeoJSON 与 Esri JSON。
|
|
165
|
+
|
|
166
|
+
```csharp
|
|
167
|
+
using OpenGIS.Esri.Geometry.Core;
|
|
168
|
+
using OpenGIS.Esri.Geometry.Core.Geometries;
|
|
169
|
+
using OpenGIS.Esri.Geometry.Core.IO;
|
|
170
|
+
|
|
171
|
+
// 1. 从 WKT 读入输入几何(环由库自动闭合)
|
|
172
|
+
Geometry parcel = GeometryEngine.GeometryFromWkt(
|
|
173
|
+
"POLYGON ((0 0, 10 0, 10 10, 0 10, 0 0))");
|
|
174
|
+
Geometry zone = GeometryEngine.GeometryFromWkt(
|
|
175
|
+
"POLYGON ((5 5, 15 5, 15 15, 5 15, 5 5))");
|
|
176
|
+
|
|
177
|
+
// 2. 校验:先确认几何本身可用,不要拿 0 容差去"修复"
|
|
178
|
+
if (!parcel.IsValid() || !zone.IsValid())
|
|
179
|
+
throw new InvalidOperationException("输入几何无效,请先修正数据");
|
|
180
|
+
|
|
181
|
+
// 3. 叠加:求交集(5×5 的方形重叠区)
|
|
182
|
+
Geometry overlapArea = GeometryEngine.Intersection(parcel, zone);
|
|
183
|
+
bool intersects = GeometryEngine.Intersects(parcel, zone); // true
|
|
184
|
+
double area = GeometryEngine.Area(overlapArea); // 约 25(内部容差带来 1e-6 级误差)
|
|
185
|
+
|
|
186
|
+
// 4. 输出两种格式
|
|
187
|
+
string geoJson = GeometryEngine.GeometryToGeoJson(overlapArea);
|
|
188
|
+
string esriJson = EsriJsonExportOperator.Instance.Execute(overlapArea);
|
|
189
|
+
|
|
190
|
+
// 5. 回读校验:序列化再反序列化,几何应一致
|
|
191
|
+
Geometry roundTrip = GeometryEngine.GeometryFromGeoJson(geoJson);
|
|
192
|
+
bool same = GeometryEngine.Equals(overlapArea, roundTrip);
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
**输出与验收**:
|
|
196
|
+
|
|
197
|
+
- `overlapArea` 是 `(5,5)-(10,10)` 的矩形,`GeometryEngine.Area()` 实测约 `24.999998`(默认容差 `1e-10` 下的浮点结果,不要断言严格等于 25)。
|
|
198
|
+
- `geoJson` 形如 `{"type":"Polygon","coordinates":[[[10,5],...]]}`;`esriJson` 形如 `{"rings":[[[10,5],...]]}`。
|
|
199
|
+
- `same` 必须为 `true`;若为 `false`,先检查环是否闭合、坐标顺序是否一致。
|
|
200
|
+
- `GeometryEngine.Simplify(geometry, tolerance)` 的 `tolerance` 必须为正,传 `0.0` 会抛 `ArgumentException: Tolerance must be positive`;且 `Simplify` 只做抽稀,不保证把自相交环修成有效面,需修复无效数据请在上游处理。
|
|
201
|
+
|
|
202
|
+
> 注意:集合运算返回 `Geometry` 基类,需要面积/环等具体成员时按实际类型(`Polygon`/`Polyline`)转型后再用。
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
169
206
|
## 常见开发场景
|
|
170
207
|
|
|
171
208
|
### 场景 1:判断点是否在多边形内
|
|
@@ -304,30 +341,31 @@ dotnet run --project samples/OpenGIS.Esri.Geometry.Samples
|
|
|
304
341
|
|
|
305
342
|
---
|
|
306
343
|
|
|
307
|
-
## DeepSeek Harness 使用建议
|
|
308
|
-
|
|
309
|
-
- **加载与引用**:用 `skill("geometry-api-net")` 加载(用户也可输入 `/geometry-api-net`);`reference/geometry-types.md` 按需 `read`,路径相对加载结果中的 Base directory;技能目录只读,示例工程建在会话工作区。
|
|
310
|
-
- **执行环境**:先 `dotnet --version`(库目标 `netstandard2.0`,可被 net6/net8/net9/net10 引用);Windows 上用 `pwsh` 执行 `dotnet` 命令,`dotnet new console -o demo && cd demo` 建最小工程。
|
|
311
|
-
- **依赖坐标**:`dotnet add package OpenGIS.Esri.Geometry.Core --version 1.0.9`(NuGet 最新 1.0.9,2026-09-21),需要 `System.Text.Json` 转换器时再装 `OpenGIS.Esri.Geometry.Json`;还原失败报 `NU1101` 说明源或版本不可用,报告“依赖不可下载”,不要自己编版本号。
|
|
312
|
-
- **验证产物**:最小控制台程序断言三件事——`GeometryEngine.GeometryFromWkt` → `GeometryToWkt` 往返、`GeometryEngine.Contains(polygon, point)` 返回 true、`GeometryEngine.Buffer(point, 5.0).GetEnvelope()` 为 (XMin=5,YMin=15,XMax=15,YMax=25),再 `dotnet run` 看实际输出;`dotnet build` 成功不代表几何结果正确。
|
|
313
|
-
- **构建与测试**:`dotnet build` 编译、`dotnet test` 跑 xUnit、`dotnet run --project samples/OpenGIS.Esri.Geometry.Samples` 跑示例(需在仓库 checkout 内,且该路径存在);输出在 `bin/`、`obj/`,不要提交。
|
|
314
|
-
- **编译期陷阱**:`Polygon.AddRing` 必须闭合(首尾点相同)否则面积/包含判断异常;集合运算返回 `Geometry` 基类,要按 `Point`/`Polygon` 转型后再用;容差 `GeometryConstants.DefaultTolerance`(1e-10)是内部常量,无法外部调整。
|
|
315
|
-
- **大地测量前提**:`GeodesicDistance`/`GeodesicArea` 基于 WGS84(Vincenty),输入必须是经纬度;对投影坐标(如 EPSG:3857 米制)调用会得到无意义结果。
|
|
316
|
-
- **安全与权限**:`dotnet restore` 需访问 NuGet 源,离线时先确认本地缓存;修改全局 `NuGet.config`、安装 SDK 或写入系统目录前先征得用户同意,命令输出里不要回显私有源凭据。
|
|
317
|
-
|
|
318
344
|
## 常见问题
|
|
319
345
|
|
|
320
346
|
| 问题 | 解决 |
|
|
321
347
|
|------|------|
|
|
322
348
|
| NuGet 安装后找不到命名空间 | 同时安装 `OpenGIS.Esri.Geometry.Core` 与(可选)`OpenGIS.Esri.Geometry.Json`;命名空间为 `OpenGIS.Esri.Geometry.Core.*` |
|
|
323
|
-
| Polygon 面积 / 包含判断异常 |
|
|
324
|
-
|
|
|
349
|
+
| Polygon 面积 / 包含判断异常 | 环必须闭合(首尾点相同);注意 `IsValid()` 对自相交环较宽松,可能返回 true |
|
|
350
|
+
| `Simplify` 抛 `ArgumentException: Tolerance must be positive` | 容差必须为正,不能传 `0.0`;`Simplify` 只抽稀,不修复自相交 |
|
|
351
|
+
| 浮点坐标比较误差 | 内部容差 `GeometryConstants.DefaultTolerance`(1e-10),为内部常量、不可外部配置;面积等断言用近似比较 |
|
|
325
352
|
| 集合运算返回值类型不符预期 | 返回 `Geometry` 基类,需按实际类型做类型转换后使用 |
|
|
326
353
|
| 无法 `new` 算子实例 | 所有 Operator 类通过 `Instance` 属性获取 Lazy 单例 |
|
|
327
354
|
| 修改 `GetRing()` / `GetPath()` 结果报错 | 返回 `IReadOnlyList<Point>` 只读视图,需要复制后修改 |
|
|
328
355
|
| `GeodesicDistance` 结果异常 | 基于 WGS84(Vincenty 公式),输入必须是经纬度坐标;`GeodesicArea` 使用球面超量公式 |
|
|
329
356
|
| GeoJSON 导出类型与预期不符 | 单路径 Polyline 导出为 `LineString`,多路径导出为 `MultiLineString`;Envelope 导出为 `Polygon` |
|
|
330
357
|
|
|
358
|
+
## AI 使用建议
|
|
359
|
+
|
|
360
|
+
- **本技能的组织**:主文件给高频用法,完整参数表与高级示例在 `reference/geometry-types.md`,需要时再展开;示例工程与生成的数据写到工作目录,不要改动技能目录本身。
|
|
361
|
+
- **执行环境**:先 `dotnet --version`(库目标 `netstandard2.0`,可被 net6/net8/net9/net10 引用);Windows 上用 PowerShell 执行 `dotnet` 命令,`dotnet new console -o demo && cd demo` 建最小工程。
|
|
362
|
+
- **依赖坐标**:`dotnet add package OpenGIS.Esri.Geometry.Core --version 1.0.9`(NuGet 最新 1.0.9,2026-09-21),需要 `System.Text.Json` 转换器时再装 `OpenGIS.Esri.Geometry.Json`;还原失败报 `NU1101` 说明源或版本不可用,报告“依赖不可下载”,不要自己编版本号。
|
|
363
|
+
- **验证产物**:最小控制台程序断言三件事——`GeometryEngine.GeometryFromWkt` → `GeometryToWkt` 往返、`GeometryEngine.Contains(polygon, point)` 返回 true、`GeometryEngine.Buffer(point, 5.0).GetEnvelope()` 为 (XMin=5,YMin=15,XMax=15,YMax=25),再 `dotnet run` 看实际输出;`dotnet build` 成功不代表几何结果正确。
|
|
364
|
+
- **构建与测试**:`dotnet build` 编译、`dotnet test` 跑 xUnit、`dotnet run --project samples/OpenGIS.Esri.Geometry.Samples` 跑示例(需在仓库 checkout 内,且该路径存在);输出在 `bin/`、`obj/`,不要提交。
|
|
365
|
+
- **编译期陷阱**:`Polygon.AddRing` 必须闭合(首尾点相同)否则面积/包含判断异常;集合运算返回 `Geometry` 基类,要按 `Point`/`Polygon` 转型后再用;容差 `GeometryConstants.DefaultTolerance`(1e-10)是内部常量,无法外部调整。
|
|
366
|
+
- **大地测量前提**:`GeodesicDistance`/`GeodesicArea` 基于 WGS84(Vincenty),输入必须是经纬度;对投影坐标(如 EPSG:3857 米制)调用会得到无意义结果。
|
|
367
|
+
- **安全与权限**:`dotnet restore` 需访问 NuGet 源,离线时先确认本地缓存;修改全局 `NuGet.config`、安装 SDK 或写入系统目录前先征得用户同意,命令输出里不要回显私有源凭据。
|
|
368
|
+
|
|
331
369
|
## 相关技能
|
|
332
370
|
|
|
333
371
|
- **nettopologysuite** — .NET JTS 移植(几何计算核心):[../nettopologysuite/SKILL.md](../nettopologysuite/SKILL.md)
|