@dsh-gis/dsh-opengis-skill 0.2.0 → 0.4.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 +126 -1
- package/README.md +51 -25
- package/adaptations/brutile.md +6 -6
- package/adaptations/cesiumjs.md +6 -6
- package/adaptations/common.md +20 -13
- package/adaptations/deck-gl.md +6 -6
- package/adaptations/duckdb-spatial.md +6 -6
- package/adaptations/gdal-api.md +6 -6
- package/adaptations/gdal.md +6 -6
- package/adaptations/geolibre.md +6 -6
- package/adaptations/geometry-api-java.md +6 -6
- package/adaptations/geometry-api-net.md +6 -6
- package/adaptations/geonode.md +6 -6
- package/adaptations/geopandas.md +6 -6
- package/adaptations/geopipe-agent.md +6 -6
- package/adaptations/geos.md +8 -0
- package/adaptations/geoserver-cloud.md +6 -6
- package/adaptations/geoserver-rest-api.md +6 -6
- package/adaptations/geoserver.md +6 -6
- package/adaptations/geotools.md +6 -6
- package/adaptations/grass-gis.md +6 -6
- package/adaptations/jts.md +6 -6
- package/adaptations/kepler-gl.md +6 -6
- package/adaptations/leaflet.md +6 -6
- package/adaptations/mapbox-gl-js.md +6 -6
- package/adaptations/maplibre-gl-js.md +8 -0
- package/adaptations/maplibre-native.md +8 -0
- package/adaptations/mapserver.md +6 -6
- package/adaptations/mapsui.md +6 -6
- package/adaptations/nettopologysuite.md +6 -6
- package/adaptations/opendronemap.md +8 -0
- package/adaptations/opengis-all.md +7 -6
- package/adaptations/opengis-daf.md +7 -6
- package/adaptations/opengis-utils-for-java.md +6 -6
- package/adaptations/opengis-utils-for-net.md +6 -6
- package/adaptations/openlayers.md +6 -6
- package/adaptations/pdal.md +6 -6
- package/adaptations/postgis.md +6 -6
- package/adaptations/proj.md +6 -6
- package/adaptations/projnet4geoapi.md +6 -6
- package/adaptations/pyqgis.md +6 -6
- package/adaptations/qgis-process.md +6 -6
- package/adaptations/qgis-server.md +6 -6
- package/adaptations/shapely.md +6 -6
- package/adaptations/sharpmap.md +6 -6
- package/adaptations/spatialite.md +6 -6
- package/adaptations/stac-cog-titiler.md +8 -0
- package/adaptations/whitebox-tools.md +6 -6
- package/assets/brutile/SKILL.md +6 -12
- package/assets/cesiumjs/SKILL.md +14 -18
- package/assets/deck-gl/SKILL.md +9 -15
- package/assets/duckdb-spatial/SKILL.md +41 -25
- package/assets/gdal/SKILL.md +11 -18
- package/assets/gdal/reference/raster-tools.md +14 -0
- package/assets/gdal/reference/vector-tools.md +5 -0
- package/assets/gdal-api/SKILL.md +8 -16
- 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 +11 -17
- package/assets/geometry-api-java/SKILL.md +5 -10
- package/assets/geometry-api-net/SKILL.md +5 -11
- package/assets/geometry-api-net/reference/geometry-types.md +5 -0
- package/assets/geonode/SKILL.md +8 -15
- package/assets/geopandas/SKILL.md +46 -17
- package/assets/geopandas/reference/core-api.md +55 -0
- package/assets/geopipe-agent/SKILL.md +7 -14
- package/assets/geopipe-agent/reference/steps-reference.md +12 -0
- package/assets/geopipe-agent/reference/workflows.md +8 -0
- package/assets/geos/SKILL.md +372 -0
- package/assets/geoserver/SKILL.md +6 -13
- package/assets/geoserver-cloud/SKILL.md +12 -21
- package/assets/geoserver-rest-api/SKILL.md +5 -12
- package/assets/geoserver-rest-api/reference/endpoints.md +16 -0
- package/assets/geotools/SKILL.md +5 -12
- package/assets/geotools/reference/raster-rendering.md +5 -0
- package/assets/geotools/reference/vector-io.md +7 -0
- package/assets/grass-gis/SKILL.md +36 -18
- package/assets/jts/SKILL.md +5 -12
- package/assets/jts/reference/geometry-operations.md +13 -0
- package/assets/kepler-gl/SKILL.md +10 -16
- package/assets/leaflet/SKILL.md +19 -23
- package/assets/mapbox-gl-js/SKILL.md +11 -16
- package/assets/maplibre-gl-js/SKILL.md +478 -0
- package/assets/maplibre-native/SKILL.md +383 -0
- package/assets/mapserver/SKILL.md +12 -16
- package/assets/mapsui/SKILL.md +29 -18
- package/assets/nettopologysuite/SKILL.md +5 -11
- package/assets/opendronemap/SKILL.md +309 -0
- package/assets/opengis-all/SKILL.md +14 -19
- package/assets/opengis-all/reference/data-stages.md +7 -0
- package/assets/opengis-all/reference/workflow-cheatsheets.md +7 -0
- package/assets/opengis-daf/SKILL.md +5 -13
- package/assets/opengis-utils-for-java/SKILL.md +7 -11
- package/assets/opengis-utils-for-java/reference/common-tasks.md +4 -0
- package/assets/opengis-utils-for-net/SKILL.md +5 -10
- package/assets/opengis-utils-for-net/reference/code-patterns.md +4 -0
- package/assets/opengis-utils-for-net/reference/util-classes.md +10 -0
- package/assets/openlayers/SKILL.md +16 -20
- package/assets/pdal/SKILL.md +15 -13
- package/assets/postgis/SKILL.md +21 -26
- package/assets/proj/SKILL.md +5 -12
- package/assets/projnet4geoapi/SKILL.md +6 -12
- package/assets/pyqgis/SKILL.md +5 -10
- 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 +5 -12
- package/assets/qgis-process/reference/algorithm-cheatsheet.md +6 -0
- package/assets/qgis-server/SKILL.md +7 -13
- package/assets/shapely/SKILL.md +29 -14
- package/assets/shapely/reference/operations-reference.md +42 -0
- package/assets/sharpmap/SKILL.md +5 -11
- package/assets/spatialite/SKILL.md +15 -16
- package/assets/stac-cog-titiler/SKILL.md +420 -0
- package/assets/whitebox-tools/SKILL.md +28 -19
- package/lib/adaptations.d.ts +18 -0
- package/lib/adaptations.js +164 -7
- package/lib/catalog.d.ts +7 -1
- package/lib/catalog.js +9 -1
- package/lib/index.d.ts +9 -0
- package/lib/index.js +48 -3
- package/lib/skill-file.d.ts +12 -0
- package/lib/skill-file.js +107 -16
- package/locale/en.json +1 -1
- package/locale/zh.json +1 -1
- package/package.json +8 -3
- package/upstream.json +74 -64
|
@@ -1,16 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: grass-gis
|
|
3
3
|
description: "Use when doing GIS geoprocessing with GRASS GIS headlessly — grass --exec and --tmp-project for servers and CI, g.region computational region management, r.* raster, v.* vector, r3.* 3D raster and t.* temporal modules, r.import/v.import data import, or Python scripting with grass.script, grass.script.array and grass.tools."
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
- python
|
|
9
|
-
- cli
|
|
10
|
-
- headless
|
|
11
|
-
- temporal
|
|
12
|
-
- automation
|
|
13
|
-
- qgis
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "gis, raster, vector, python, cli, headless, temporal, automation, qgis"
|
|
14
8
|
---
|
|
15
9
|
|
|
16
10
|
> **项目地址:** <https://github.com/OSGeo/grass>
|
|
@@ -19,13 +13,15 @@ tags:
|
|
|
19
13
|
>
|
|
20
14
|
> **手册入口:** <https://grass.osgeo.org/grass-stable/manuals/>
|
|
21
15
|
>
|
|
22
|
-
> **最新版本:** 8.5.0(截至 2026-
|
|
16
|
+
> **最新版本:** 8.5.0(截至 2026-11,[GitHub Releases](https://github.com/OSGeo/grass/releases/tag/8.5.0);8.4 系列最新补丁 8.4.2)
|
|
23
17
|
>
|
|
24
|
-
>
|
|
18
|
+
> **运行要求:** 8.5 起要求 GDAL 3.7+、PROJ 9.0+、Python 3.10+、C++17(conda-forge 包已自带这些依赖)
|
|
19
|
+
>
|
|
20
|
+
> **许可证:** GPL-2.0-or-later
|
|
25
21
|
|
|
26
22
|
## 概述
|
|
27
23
|
|
|
28
|
-
GRASS
|
|
24
|
+
GRASS(Geographic Resources Analysis Support System,8.5 起官方品牌名从 "GRASS GIS" 简化为 "GRASS")是 OSGeo 创始项目之一,提供栅格、拓扑矢量、三维栅格、影像与时序数据的分析能力。它以模块化命令体系为核心:每个功能是一个独立命令(模块),既可交互使用,也可通过 `grass --exec` 在无头会话中执行。计算区域(computational region)与地图数据范围分离管理,是理解其行为的关键概念。Python 生态(`grass.script`、PyGRASS、`grass.jupyter`)使其适合脚本化与自动化。
|
|
29
25
|
|
|
30
26
|
核心特点:
|
|
31
27
|
|
|
@@ -33,7 +29,8 @@ GRASS GIS(Geographic Resources Analysis and Support System)是 OSGeo 创始
|
|
|
33
29
|
- **计算区域独立管理**:栅格模块在 `g.region` 定义的窗口上运算,与地图本身范围解耦。
|
|
34
30
|
- **无头执行**:`grass --exec` / `--tmp-project` / `--tmp-mapset` 支持服务器与 CI 场景。
|
|
35
31
|
- **时空框架**:`t.*` 模块管理 strds / str3ds / stvds 时空数据集。
|
|
36
|
-
- **Python 接口**:`grass.script`(命令封装)、`grass.script.array`(NumPy 读写栅格)、`grass.tools`(8.
|
|
32
|
+
- **Python 接口**:`grass.script`(命令封装)、`grass.script.array`(NumPy 读写栅格)、`grass.tools`(8.5 新增的面向对象工具调用)、`grass.jupyter`(笔记本集成)。
|
|
33
|
+
- **8.5 亮点**:`grass.tools` 新 Python API;`g.list`、`g.region`、`r.info`、`r.univar`、`r.stats`、`r.report`、`v.info`、`v.what`、`v.db.connect` 等几十个模块支持 JSON 输出;`r.mapcalc`、`r.texture`、`r.horizon` 支持 `nprocs` 并行;同一地图集可存多份掩膜(`r.mask.status` 查看);新增 `r.smooth.edgepreserve`。
|
|
37
34
|
|
|
38
35
|
## 环境准备
|
|
39
36
|
|
|
@@ -231,7 +228,7 @@ elev_ft.write(mapname="elev_ft", overwrite=True)
|
|
|
231
228
|
elev3d = garray.array3d(mapname="elev3d")
|
|
232
229
|
```
|
|
233
230
|
|
|
234
|
-
8.
|
|
231
|
+
8.5 新增面向对象的工具调用接口 `grass.tools`(模块名中的点替换为下划线,支持 NumPy 输入输出,官方说明 8.5 中仍是实验性、预计 8.6 稳定);8.4.x 及更早版本没有该模块,只能用 `grass.script`:
|
|
235
232
|
|
|
236
233
|
```python
|
|
237
234
|
from grass.tools import Tools
|
|
@@ -242,7 +239,28 @@ tools.r_random_surface(output="surface", seed=42)
|
|
|
242
239
|
print(tools.g_region(flags="p", format="json")["cells"])
|
|
243
240
|
```
|
|
244
241
|
|
|
245
|
-
`grass.jupyter` 提供 Jupyter 集成(`init`、`Map`、`Map3D`、`InteractiveMap`、`SeriesMap`、`TimeSeriesMap` 等)。
|
|
242
|
+
`grass.jupyter` 提供 Jupyter 集成(`init`、`Map`、`Map3D`、`InteractiveMap`、`SeriesMap`、`TimeSeriesMap` 等)。8.5 起 `InteractiveMap` 增加查询按钮与简单几何绘制,`Map3D` 增加 `save()`,`SeriesMap` / `TimeSeriesMap` 支持并行。
|
|
243
|
+
|
|
244
|
+
8.5 的 8 个模块支持 JSON 输出,脚本里优先用 `format="json"` 拿结构化结果,不要解析人类可读文本:
|
|
245
|
+
|
|
246
|
+
```bash
|
|
247
|
+
# 8.5 新增 JSON 输出的代表模块
|
|
248
|
+
g.list type=raster format=json
|
|
249
|
+
g.region -p format=json
|
|
250
|
+
r.univar map=elevation format=json
|
|
251
|
+
r.stats input=elevation format=json
|
|
252
|
+
v.info map=roads format=json
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
8.5 起一个地图集可存多份掩膜,`r.mask.status` 报告当前掩膜状态;Python 里用 `grass.script` 的 `RegionManager` / `MaskManager` 上下文管理器做作用域内的区域/掩膜切换:
|
|
256
|
+
|
|
257
|
+
```python
|
|
258
|
+
import grass.script as gs
|
|
259
|
+
|
|
260
|
+
with gs.RegionManager(raster="elevation"), gs.MaskManager(mask_name="mask"):
|
|
261
|
+
gs.parse_command("r.univar", map="elevation", format="json")
|
|
262
|
+
# 退出上下文后区域与掩膜自动还原
|
|
263
|
+
```
|
|
246
264
|
|
|
247
265
|
### 与 QGIS 集成
|
|
248
266
|
|
|
@@ -290,7 +308,7 @@ grass $HOME/grassdata/ndvi_project/PERMANENT --exec sh -c '
|
|
|
290
308
|
2. **无头场景用 `--exec` 单行执行**:避免交互式会话依赖;CI 优先使用 `--tmp-project` 保持幂等。
|
|
291
309
|
3. **临时项目内先导出结果**:`--tmp-project` / `--tmp-mapset` 结束时目录被删除。
|
|
292
310
|
4. **覆盖已有地图加 `--overwrite`**:否则模块报地图已存在并退出非零。
|
|
293
|
-
5. **Python 中结构化解析**:用 `gs.parse_command(..., format="json")` 或 `flags="g"` 获取 dict
|
|
311
|
+
5. **Python 中结构化解析**:用 `gs.parse_command(..., format="json")` 或 `flags="g"` 获取 dict,不要手工解析人类可读输出;8.5 起 `g.list`、`g.region`、`r.info`、`r.univar`、`r.stats`、`r.report`、`v.info`、`v.what`、`v.db.connect` 等几十个模块都支持 `format="json"`。
|
|
294
312
|
6. **Python 会话内改动区域用 `gs.use_temp_region()`**:临时区域随会话结束自动还原。
|
|
295
313
|
7. **导入优先用 `r.import` / `v.import`**:自动重投影到项目 CRS,避免 CRS 不一致导致的分析错误。
|
|
296
314
|
8. **`--exec` 脚本加 shebang**:缺失 shebang 会报 `Exec format error`。
|
|
@@ -313,7 +331,7 @@ grass $HOME/grassdata/ndvi_project/PERMANENT --exec sh -c '
|
|
|
313
331
|
## AI 使用建议
|
|
314
332
|
|
|
315
333
|
- **执行环境**:命令在终端 / shell 中执行(Windows 用 PowerShell)。正文里 `grass ... --exec sh -c '...'` 的多行引用在 PowerShell 下不可靠,改为把模块序列写进 `.py` 脚本(首行 `#!/usr/bin/env python3`),再 `grass --tmp-project EPSG:3857 --exec python3 analysis.py`。
|
|
316
|
-
- **先探测版本**:`grass --version`(应为 8.5.0,LTR 8.4.2)、`grass --tmp-project EPSG:3857 --exec g.region -p
|
|
334
|
+
- **先探测版本**:`grass --version`(应为 8.5.0,LTR 8.4.2)、`grass --tmp-project EPSG:3857 --exec g.region -p`;`grass.tools` 自 8.5.0 起提供,8.4.x/LTR 上 Python 脚本改用 `gs.run_command`。
|
|
317
335
|
- **验证产物**:`--tmp-project` 内的地图最后必须导出——`r.out.gdal input=slope output=/work/slope.tif format=GTiff`,随后 `gdalinfo -json slope.tif` 核对 CRS 与范围;会话内核对用 `g.region -p format=json`、`g.list type=raster`。
|
|
318
336
|
- **区域语义优先**:栅格模块只处理计算区域内的像元,结果范围不对先看 `g.region -p`;重复运行加 `--overwrite`,否则模块报地图已存在并非零退出。
|
|
319
337
|
- **错误识别**:GRASS 模块的失败以 `ERROR:` 开头并返回非零码(如 `Raster map <x> not found`),据此区分地图名、区域为空还是输出已存在问题,不要只读最后一行日志。
|
package/assets/jts/SKILL.md
CHANGED
|
@@ -1,24 +1,17 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: jts
|
|
3
3
|
description: "Use when doing precise 2D computational geometry in Java with org.locationtech.jts:jts-core 1.20.0 — GeometryFactory construction, contains/intersects predicates, overlay via OverlayNGRobust, buffer, STRtree and PreparedGeometry speedups, WKT/WKB/GeoJSON I/O, and fixing TopologyException or unclosed rings."
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
- topology
|
|
9
|
-
- spatial
|
|
10
|
-
- de9im
|
|
11
|
-
- wkt
|
|
12
|
-
- wkb
|
|
13
|
-
- geojson
|
|
14
|
-
- gis
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "java, geometry, topology, spatial, de9im, wkt, wkb, geojson, gis"
|
|
15
8
|
---
|
|
16
9
|
|
|
17
10
|
> **项目地址:** <https://github.com/locationtech/jts>
|
|
18
11
|
>
|
|
19
12
|
> **Maven Central:** `org.locationtech.jts:jts-core`
|
|
20
13
|
>
|
|
21
|
-
> **最新版本:** 1.20.0(截至 2026-
|
|
14
|
+
> **最新版本:** 1.20.0(截至 2026-11,[Maven Central](https://central.sonatype.com/artifact/org.locationtech.jts/jts-core))
|
|
22
15
|
>
|
|
23
16
|
> **许可证:** Eclipse Public License 2.0 / Eclipse Distribution License 1.0(BSD 风格)
|
|
24
17
|
>
|
|
@@ -1,5 +1,18 @@
|
|
|
1
1
|
# JTS Geometry Operations and Index Reference
|
|
2
2
|
|
|
3
|
+
## Contents
|
|
4
|
+
|
|
5
|
+
- 空间关系判断
|
|
6
|
+
- 集合运算
|
|
7
|
+
- 几何分析
|
|
8
|
+
- 几何简化
|
|
9
|
+
- 精度模型
|
|
10
|
+
- 格式读写
|
|
11
|
+
- 空间索引
|
|
12
|
+
- PreparedGeometry(加速重复判断)
|
|
13
|
+
- 线性参考
|
|
14
|
+
- 仿射变换
|
|
15
|
+
|
|
3
16
|
> 这是 [../SKILL.md](../SKILL.md) 的补充文件,收录空间关系、集合运算、几何分析、格式读写与空间索引的完整参考。
|
|
4
17
|
|
|
5
18
|
---
|
|
@@ -1,26 +1,19 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: kepler-gl
|
|
3
|
-
description: "Use when building React/Redux web apps or Jupyter notebooks for large-scale geospatial visual exploration with Kepler.gl 3.3.0-alpha.
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
- webgl
|
|
9
|
-
- geospatial
|
|
10
|
-
- data-visualization
|
|
11
|
-
- map-layers
|
|
12
|
-
- jupyter
|
|
13
|
-
- python
|
|
14
|
-
- maplibre
|
|
3
|
+
description: "Use when building React/Redux web apps or Jupyter notebooks for large-scale geospatial visual exploration with Kepler.gl 3.3.0-alpha.20 — @kepler.gl/components KeplerGl, @kepler.gl/actions addDataToMap, @kepler.gl/processors processGeojson/processCsvData, and the Python keplergl widget. Also for fixing blank maps from a missing reducer or wrong getState (react-redux 'Could not find ... in the context of Connect(...)'), Mapbox token basemap errors, and oversized addDataToMap payloads."
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "javascript, react, redux, webgl, geospatial, data-visualization, map-layers, jupyter, python, maplibre"
|
|
15
8
|
---
|
|
16
9
|
|
|
17
10
|
> **项目地址:** <https://github.com/keplergl/kepler.gl>
|
|
18
11
|
>
|
|
19
12
|
> **官方文档:** <https://docs.kepler.gl/>
|
|
20
13
|
>
|
|
21
|
-
>
|
|
14
|
+
> **最新版本:** 3.3.0-alpha.20(2026-11-08,npm `kepler.gl` `latest` 标签与 [GitHub Release v3.3.0-alpha.20](https://github.com/keplergl/kepler.gl/releases) 一致;仍为 3.3 预发布线,4.0 尚无稳定版)
|
|
22
15
|
>
|
|
23
|
-
> **PyPI:** `keplergl` 0.4.0(Jupyter 小组件,版本节奏落后于前端,截至 2026-
|
|
16
|
+
> **PyPI:** `keplergl` 0.4.0(Jupyter 小组件,版本节奏落后于前端,截至 2026-11)
|
|
24
17
|
>
|
|
25
18
|
> **许可证:** MIT
|
|
26
19
|
|
|
@@ -75,7 +68,7 @@ UMD 构建的库名为 `KeplerGl`,AMD 加载时同样以 `KeplerGl` 注册;
|
|
|
75
68
|
```bash
|
|
76
69
|
pip install keplergl==0.4.0
|
|
77
70
|
|
|
78
|
-
# 或使用 conda
|
|
71
|
+
# 或使用 conda(注意:conda-forge 当前仍停在 0.3.2,需要 0.4.0 请用 pip)
|
|
79
72
|
conda install -c conda-forge keplergl
|
|
80
73
|
```
|
|
81
74
|
|
|
@@ -290,7 +283,7 @@ React 侧的等价流程是:`processGeojson` / `processCsvData` 解析 → `di
|
|
|
290
283
|
## AI 使用建议
|
|
291
284
|
|
|
292
285
|
- **执行环境**:`npm install` / `pnpm install`、`pip install keplergl` 在终端中执行 或 `ops_bash`,长输出重定向到文件再分段读。
|
|
293
|
-
- **先探测版本**:`npm ls kepler.gl @kepler.gl/components @kepler.gl/actions`,子包必须与主包同为 3.3.0-alpha.
|
|
286
|
+
- **先探测版本**:`npm ls kepler.gl @kepler.gl/components @kepler.gl/actions`,子包必须与主包同为 3.3.0-alpha.20;Python 侧 `python -c "import keplergl; print(keplergl.__version__)"` 应为 0.4.0。
|
|
294
287
|
- **验证产物**:前端用 `npm run build` 确认编译,再用 `npx serve dist` 起本地静态服务;是否真出图只能由浏览器确认,AI 助手通常看不到浏览器画面,请用户看画面与控制台,环境支持读图时用截图核对。
|
|
295
288
|
- **无 GPU 环境**:无头环境无法验证 WebGL 渲染,构建通过不等于地图可用,此时不要报告「已渲染」。
|
|
296
289
|
- **常见症状**:空白组件先查 reducer 与 `getState`;无图层查 `dataId` 与字段类型;token 报错查底图样式。
|
|
@@ -299,6 +292,7 @@ React 侧的等价流程是:`processGeojson` / `processCsvData` 解析 → `di
|
|
|
299
292
|
## 相关技能
|
|
300
293
|
|
|
301
294
|
- **deck-gl** — Kepler.gl 的渲染底座,自定义图层与拾取需直接操作 deck.gl:[../deck-gl/SKILL.md](../deck-gl/SKILL.md)
|
|
295
|
+
- **maplibre-gl-js** — Kepler.gl 默认底图所用的开源渲染库(免 token):[../maplibre-gl-js/SKILL.md](../maplibre-gl-js/SKILL.md)
|
|
302
296
|
- **mapbox-gl-js** — 使用 Mapbox 官方样式与 token 时的对应技能:[../mapbox-gl-js/SKILL.md](../mapbox-gl-js/SKILL.md)
|
|
303
297
|
- **openlayers** — 传统 2D WebGIS 方案,适合与 Kepler.gl 做能力对比:[../openlayers/SKILL.md](../openlayers/SKILL.md)
|
|
304
298
|
- **geopandas** — Python 侧数据预处理与投影转换:[../geopandas/SKILL.md](../geopandas/SKILL.md)
|
package/assets/leaflet/SKILL.md
CHANGED
|
@@ -1,17 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: leaflet
|
|
3
3
|
description: "Use when adding lightweight 2D tile maps to web pages with leaflet 1.9.4 — L.map/L.tileLayer, markers, popups, GeoJSON overlays, layer control, [lat, lng] ordering, or debugging blank maps, broken default marker icons after bundling, and sizing fixed by invalidateSize()."
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
- map
|
|
9
|
-
- geojson
|
|
10
|
-
- tile-layer
|
|
11
|
-
- markers
|
|
12
|
-
- plugins
|
|
13
|
-
- vue
|
|
14
|
-
- react
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "javascript, web, 2d, map, geojson, tile-layer, markers, plugins, vue, react"
|
|
15
8
|
---
|
|
16
9
|
|
|
17
10
|
> **项目地址:** <https://github.com/Leaflet/Leaflet>
|
|
@@ -22,7 +15,7 @@ tags:
|
|
|
22
15
|
>
|
|
23
16
|
> **示例:** <https://leafletjs.com/examples.html>
|
|
24
17
|
>
|
|
25
|
-
> **最新版本:** 1.9.4(截至 2026-
|
|
18
|
+
> **最新版本:** 1.9.4(截至 2026-11,[npm `leaflet`](https://www.npmjs.com/package/leaflet) dist-tag `latest` 与 [GitHub Release](https://github.com/Leaflet/Leaflet/releases) 一致;1.9.4 发布于 2023-05,仍是**当前稳定版**。2.0 尚在 beta 阶段(`v2.0.0-beta.3`,2026-11-10),未发布稳定版,生产环境沿用 1.x)
|
|
26
19
|
>
|
|
27
20
|
> **许可证:** BSD-2-Clause
|
|
28
21
|
|
|
@@ -337,23 +330,26 @@ export default function MapView() {
|
|
|
337
330
|
|
|
338
331
|
## 常见问题
|
|
339
332
|
|
|
340
|
-
|
|
|
341
|
-
|
|
342
|
-
|
|
|
343
|
-
|
|
|
344
|
-
|
|
|
345
|
-
| `L is not defined` | CDN
|
|
346
|
-
|
|
|
347
|
-
|
|
|
348
|
-
|
|
|
349
|
-
|
|
|
333
|
+
| 报错 / 现象 | 原因 | 处置 |
|
|
334
|
+
|------|------|------|
|
|
335
|
+
| 报错 `Uncaught Error: Map container is already initialized.` | 同一个 DOM 容器被 `L.map()` 初始化两次(React StrictMode 双调用、热更新、路由复用组件最常见) | 复用前先 `map.remove()` 并把引用置空;React 在 `useEffect` 的 cleanup 里 `remove()`,初始化前判断容器是否已带 `_leaflet_id` |
|
|
336
|
+
| 报错 `Uncaught Error: Map container not found.` | `L.map(id)` 执行时容器 DOM 尚未挂载,或 id 与模板不一致 | 等 DOM 就绪再初始化(React `useEffect`、Vue `onMounted`),并核对传入的 id/元素 |
|
|
337
|
+
| 报错 `Uncaught Error: Map container is being reused by another instance` | 容器仍被一个未销毁的 `Map` 实例占用 | 先 `remove()` 旧实例再初始化;同一容器不要并存两个地图 |
|
|
338
|
+
| 报错 `Uncaught ReferenceError: L is not defined` | CDN 脚本未加载、加载失败,或自定义代码先于 `leaflet.js` 执行 | 先引 `leaflet.js` 再执行业务代码;npm 下确认 `import L from 'leaflet'` 且打包产物真的包含它 |
|
|
339
|
+
| 地图区域空白 / 不显示 | 容器没有显式高度(Leaflet 不自带尺寸),或初始化后容器尺寸才变化 | 给 `#map` 设 `height`(如 `400px`);尺寸变化后调用 `map.invalidateSize()` |
|
|
340
|
+
| 默认标记图标 404 / 显示为破图 | npm + 打包器下 `leaflet.css` 里相对的默认图标路径失效 | 显式设置 `L.Icon.Default` 的 `iconUrl`/`iconRetinaUrl`/`shadowUrl`,或改用 CDN 引入 CSS 与图片 |
|
|
341
|
+
| 地图在弹窗 / 隐藏容器中显示错乱 | 容器尺寸在初始化时已知为零,或标签页切回后尺寸变化 | 容器可见后再初始化,并在可见性变化后调用 `map.invalidateSize()` |
|
|
342
|
+
| 点跑到别的位置 / 坐标颠倒 | 参数顺序是 `[lat, lng]`,而 GeoJSON 是 `[lng, lat]` | 统一在入口处用 `L.latLng(lat, lng)` 或 `coordsToLatLng` 转换,不要混用两种顺序 |
|
|
343
|
+
| 组件切换后内存持续增长 | 卸载时未调用 `map.remove()`,或自定义事件未 `off` 解绑 | cleanup 中 `map.remove()`;自定义监听器用具名函数并 `map.off(type, handler)` |
|
|
344
|
+
| 瓦片加载失败 / 跨域报错 | 瓦片 URL 模板错误,或瓦片服务未返回 CORS 头 | 核对 `{z}/{x}/{y}` 模板与该服务实际路径;WMS 需服务端放行跨域,前端 `crossOrigin` 选项按需设置 |
|
|
345
|
+
| 地图与 Vue/React 响应式冲突 | 把 `L.map` 实例放进 `reactive`/`useState`,代理了 Leaflet 内部对象 | 用普通变量或 `useRef` 持有实例,不要放进响应式容器 |
|
|
350
346
|
|
|
351
347
|
---
|
|
352
348
|
|
|
353
349
|
## AI 使用建议
|
|
354
350
|
|
|
355
351
|
- **执行环境**:`npm install`、`npm run build` 在终端中执行;纯静态页面可用 `python -m http.server 5173` 起服务(`python` 不存在时用 `py -3`)。
|
|
356
|
-
- **先探测版本**:`npm ls leaflet`(未装则 `npm view leaflet version`);本技能按 1.9.4 编写,CDN 的 `integrity` SRI 哈希只对应 1.9.4,换版本必须同步换哈希。
|
|
352
|
+
- **先探测版本**:`npm ls leaflet`(未装则 `npm view leaflet version`);本技能按 1.9.4 编写,CDN 的 `integrity` SRI 哈希只对应 1.9.4,换版本必须同步换哈希。Leaflet 2.0 目前只有 beta(`2.0.0-beta.3`),API 与插件兼容性仍在变动,回答里默认给 1.9.4 方案。
|
|
357
353
|
- **验证产物**:构建后 `curl.exe -I http://localhost:5173/assets/<入口>.js` 确认 200;联网时还可 `curl.exe -I https://unpkg.com/leaflet@1.9.4/dist/leaflet.js` 核对 CDN 版本;AI 助手通常看不到浏览器画面,把 URL 和“应看到瓦片与标记”交给用户,环境支持读图时用截图核对。
|
|
358
354
|
- **图标与坐标**:npm + 打包器下默认 marker 图标会 404,需显式设置 `L.Icon.Default` 的 `iconUrl`/`iconRetinaUrl`/`shadowUrl`;坐标一律 `[lat, lng]`,GeoJSON 是 `[lng, lat]`。
|
|
359
355
|
- **生命周期**:SPA 卸载必须 `map.remove()` 并解绑自定义事件;容器隐藏或尺寸变化后 `map.invalidateSize()`。
|
|
@@ -1,16 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: mapbox-gl-js
|
|
3
|
-
description: "Use when building vector web maps with mapbox-gl 3.
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
- vector-tiles
|
|
9
|
-
- webgl
|
|
10
|
-
- 3d-terrain
|
|
11
|
-
- data-driven-styling
|
|
12
|
-
- style-spec
|
|
13
|
-
- access-token
|
|
3
|
+
description: "Use when building vector web maps with mapbox-gl 3.34.2 — WebGL rendering, Style Spec layers, data-driven expressions, setTerrain raster-dem, fill-extrusion, or debugging 401 'A valid Mapbox access token is required', 'Style is not done loading', and pk./sk. token handling. Note: v2+ is proprietary under Mapbox TOS and requires a token; MapLibre GL JS is the open-source fork."
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
category: gis
|
|
7
|
+
tags: "javascript, web, map, vector-tiles, webgl, 3d-terrain, data-driven-styling, style-spec, access-token"
|
|
14
8
|
---
|
|
15
9
|
|
|
16
10
|
> **项目地址:** <https://github.com/mapbox/mapbox-gl-js>
|
|
@@ -19,7 +13,7 @@ tags:
|
|
|
19
13
|
>
|
|
20
14
|
> **API 参考:** <https://docs.mapbox.com/mapbox-gl-js/api/>
|
|
21
15
|
>
|
|
22
|
-
> **最新版本:** 3.
|
|
16
|
+
> **最新版本:** 3.34.2(截至 2026-11,npm `mapbox-gl` 与 GitHub Release 一致;[CHANGELOG](https://github.com/mapbox/mapbox-gl-js/blob/main/CHANGELOG.md))
|
|
23
17
|
>
|
|
24
18
|
> **许可证:** v2+ 为 Mapbox 专有许可(v1.x 为 BSD-3-Clause;需 Mapbox 账号 access token)
|
|
25
19
|
|
|
@@ -67,8 +61,8 @@ v3 提供更小的 ESM 入口:`import * as mapboxgl from 'mapbox-gl/esm'`。
|
|
|
67
61
|
<head>
|
|
68
62
|
<meta charset="utf-8" />
|
|
69
63
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
70
|
-
<link href="https://api.mapbox.com/mapbox-gl-js/v3.
|
|
71
|
-
<script src="https://api.mapbox.com/mapbox-gl-js/v3.
|
|
64
|
+
<link href="https://api.mapbox.com/mapbox-gl-js/v3.34.2/mapbox-gl.css" rel="stylesheet" />
|
|
65
|
+
<script src="https://api.mapbox.com/mapbox-gl-js/v3.34.2/mapbox-gl.js"></script>
|
|
72
66
|
<style>
|
|
73
67
|
/* 容器必须显式设置高度,否则地图不可见 */
|
|
74
68
|
#map { height: 400px; }
|
|
@@ -382,7 +376,7 @@ map.on('load', () => {
|
|
|
382
376
|
1. **token 安全**:前端只用 `pk.` public token,配置 URL restrictions;`sk.` secret token 仅限服务端
|
|
383
377
|
2. **许可与费用**:v2+ 受 Mapbox TOS 约束,免费层每月 50,000 次地图加载(map loads),超出按量计费,额度与价格以 <https://www.mapbox.com/pricing> 为准;开源或零成本场景评估 MapLibre GL JS
|
|
384
378
|
3. **等待样式加载**:`addSource` / `addLayer` / `setTerrain` 必须在 `load` 事件之后调用
|
|
385
|
-
4. **固定版本**:CDN 引用固定版本号(如 `v3.
|
|
379
|
+
4. **固定版本**:CDN 引用固定版本号(如 `v3.34.2`),JS 与 CSS 版本保持一致
|
|
386
380
|
5. **坐标顺序**:Mapbox GL JS 使用 `[经度, 纬度]`,与 GeoJSON 一致,与 Leaflet 的 `[lat, lng]` 相反
|
|
387
381
|
6. **大数据量**:优先矢量瓦片而非大量 GeoJSON;GeoJSON 点数据开启 `cluster` 聚合
|
|
388
382
|
7. **资源清理**:SPA 卸载组件时调用 `map.remove()`,注销自定义事件监听
|
|
@@ -409,7 +403,7 @@ map.on('load', () => {
|
|
|
409
403
|
## AI 使用建议
|
|
410
404
|
|
|
411
405
|
- **执行环境**:`npm install`、`npm run build` 在终端中执行;Windows 下用 `npm.cmd`,长构建放后台运行。
|
|
412
|
-
- **先探测版本**:`npm ls mapbox-gl`(未装则 `npm view mapbox-gl version`);本技能按 3.
|
|
406
|
+
- **先探测版本**:`npm ls mapbox-gl`(未装则 `npm view mapbox-gl version`);本技能按 3.34.2 编写,CDN 的 JS 与 CSS 必须同为 `v3.34.2`,联网时 `curl.exe -I https://api.mapbox.com/mapbox-gl-js/v3.34.2/mapbox-gl.js` 应为 200。
|
|
413
407
|
- **验证产物**:`npm run build` 后 `npx serve dist`,`curl.exe -I http://localhost:5173/` 确认入口;地图是否真加载、有没有 401 只能看浏览器 Network(`api.mapbox.com`),AI 助手通常看不到浏览器画面,请用户确认或提供截图后再判断。
|
|
414
408
|
- **token 安全**:前端只允许 `pk.` 公开 token,`sk.` 绝不能进构建产物;用 `VITE_MAPBOX_TOKEN` 等环境变量注入,提交前用 agent 的 `grep` 搜 `sk.` 与硬编码 `pk.`,回答和日志里不要回显 token。
|
|
415
409
|
- **许可提醒**:v2+ 是 Mapbox 专有许可并受配额计费约束;用户要求开源或免 token 时改写为 MapLibre(`maplibregl` 替代 `mapboxgl`,`mapbox://` 样式换成自建瓦片)。
|
|
@@ -418,6 +412,7 @@ map.on('load', () => {
|
|
|
418
412
|
|
|
419
413
|
## 相关技能
|
|
420
414
|
|
|
415
|
+
- **maplibre-gl-js** — 本库 v1 的开源分支,免 token、BSD-3-Clause,API 高度兼容:[../maplibre-gl-js/SKILL.md](../maplibre-gl-js/SKILL.md)
|
|
421
416
|
- **leaflet** — 轻量 2D 瓦片地图,无需 token,适合简单场景:[../leaflet/SKILL.md](../leaflet/SKILL.md)
|
|
422
417
|
- **openlayers** — 功能全面的开源 2D WebGIS 库(投影、MVT、高级交互):[../openlayers/SKILL.md](../openlayers/SKILL.md)
|
|
423
418
|
- **cesiumjs** — 三维地球与 3D Tiles 可视化:[../cesiumjs/SKILL.md](../cesiumjs/SKILL.md)
|