shaoxing-geo-tools 0.0.1
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/README.md +171 -0
- package/dist/assets/geoToolsWorker-0NhYNQ6J.js +1 -0
- package/dist/index.js +134 -0
- package/package.json +33 -0
package/README.md
ADDED
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
# useGeoTools — Geo 空间计算工具库
|
|
2
|
+
|
|
3
|
+
基于 Web Worker + WASM 的地理空间计算工具集,提供异步、高性能的 GeoJSON 空间运算能力。
|
|
4
|
+
|
|
5
|
+
## 通用说明
|
|
6
|
+
|
|
7
|
+
- 所有函数均返回 `Promise`,通过 Worker 异步计算,不阻塞主线程
|
|
8
|
+
- Worker 内部依赖 WASM 进行高性能空间计算
|
|
9
|
+
- 首次调用会自动初始化 Worker,后续复用同一实例
|
|
10
|
+
- 输入参数中的 `geo` 建议使用 `toRaw()` 处理,避免 Vue 响应式代理干扰
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## 功能列表
|
|
15
|
+
|
|
16
|
+
### 1. `getDistricts(geo)`
|
|
17
|
+
|
|
18
|
+
**获取行政区划信息**
|
|
19
|
+
|
|
20
|
+
根据传入的地理范围(GeoJSON),返回该区域覆盖的行政区划数据(仅对绍兴市有效)。
|
|
21
|
+
|
|
22
|
+
| 参数 | 类型 | 说明 |
|
|
23
|
+
|------|------|------|
|
|
24
|
+
| geo | GeoJSON | 输入的地理范围 |
|
|
25
|
+
|
|
26
|
+
**用途:** 在地图上选中一个区域后,查询该区域所包含的行政区(区/县)信息。
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
### 2. `checkPoint(geo)`
|
|
31
|
+
|
|
32
|
+
**检查点**
|
|
33
|
+
|
|
34
|
+
对传入的点(Point)进行空间校验或查询。
|
|
35
|
+
|
|
36
|
+
| 参数 | 类型 | 说明 |
|
|
37
|
+
|------|------|------|
|
|
38
|
+
| geo | GeoJSON | 待检查的点几何对象 |
|
|
39
|
+
|
|
40
|
+
**用途:** 判断某个坐标点是否在特定区域内、是否合法等。
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
### 3. `checkLine(geo)`
|
|
45
|
+
|
|
46
|
+
**检查线**
|
|
47
|
+
|
|
48
|
+
对传入的线(LineString)进行空间校验或查询。
|
|
49
|
+
|
|
50
|
+
| 参数 | 类型 | 说明 |
|
|
51
|
+
|------|------|------|
|
|
52
|
+
| geo | GeoJSON | 待检查的线几何对象 |
|
|
53
|
+
|
|
54
|
+
**用途:** 检查航线、路径等线状要素是否符合空间约束(如是否穿越禁飞区)。
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
### 4. `checkPolygon(geo)`
|
|
59
|
+
|
|
60
|
+
**检查多边形**
|
|
61
|
+
|
|
62
|
+
对传入的多边形(Polygon)进行空间校验或查询。
|
|
63
|
+
|
|
64
|
+
| 参数 | 类型 | 说明 |
|
|
65
|
+
|------|------|------|
|
|
66
|
+
| geo | GeoJSON | 待检查的多边形几何对象 |
|
|
67
|
+
|
|
68
|
+
**用途:** 检查空域、区域等面状要素的空间合法性。
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
### 5. `batchGetCovers(geo_jsons, distances, opacities)`
|
|
73
|
+
|
|
74
|
+
**批量获取覆盖信息**
|
|
75
|
+
|
|
76
|
+
计算一组 GeoJSON 在指定距离下的覆盖范围,并支持设置不同透明度。
|
|
77
|
+
|
|
78
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
79
|
+
|------|------|--------|------|
|
|
80
|
+
| geo_jsons | Array\<GeoJSON\> | — | 需要计算覆盖的 GeoJSON 数组 |
|
|
81
|
+
| distances | Array\<number\> | — | 覆盖距离(米),每个层级一个值 |
|
|
82
|
+
| opacities | Array\<number\> | `[0.2, 0.2, 0.2]` | 每层覆盖的透明度 |
|
|
83
|
+
|
|
84
|
+
**用途:** 用于展示基站/无人机等设备的信号覆盖范围、服务半径等。
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
### 6. `batchSimplify(geo_jsons, toleranceMeters)`
|
|
89
|
+
|
|
90
|
+
**批量简化 GeoJSON 数据**
|
|
91
|
+
|
|
92
|
+
简化一组 GeoJSON 的几何精度,去除冗余顶点,减少数据量。简化过程中会自动剔除不合法的 GeoJSON。
|
|
93
|
+
|
|
94
|
+
> ⚠️ **注意:** 返回的数组元素数量 ≤ 传入的数组元素数量(不合法数据会被自动删除)。
|
|
95
|
+
|
|
96
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
97
|
+
|------|------|--------|------|
|
|
98
|
+
| geo_jsons | Array\<GeoJSON\> | — | 需要简化的 GeoJSON 数组 |
|
|
99
|
+
| toleranceMeters | number | `11` | 简化容差(米),该距离内的相邻点将被合并 |
|
|
100
|
+
|
|
101
|
+
**用途:** 减少高精度 GeoJSON 的数据量,提升渲染和传输性能。默认值 11 米 ≈ turf 的 `tolerance: 0.0001`。
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
### 7. `batchGetSpaceExtra(geo_jsons, mapSizes, paddingRatio)`
|
|
106
|
+
|
|
107
|
+
**批量获取空间额外信息**
|
|
108
|
+
|
|
109
|
+
计算一组空间(多边形/面)的额外元信息。
|
|
110
|
+
|
|
111
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
112
|
+
|------|------|--------|------|
|
|
113
|
+
| geo_jsons | Array\<GeoJSON\> | — | 空间 GeoJSON 数组(面要素) |
|
|
114
|
+
| mapSizes | [number, number] | `[4910, 1311]` | 地图视口尺寸(像素) |
|
|
115
|
+
| paddingRatio | number | `0.5` | 边距比例,用于计算最佳缩放级别 |
|
|
116
|
+
|
|
117
|
+
**返回值包含:**
|
|
118
|
+
|
|
119
|
+
| 字段 | 类型 | 说明 |
|
|
120
|
+
|------|------|------|
|
|
121
|
+
| area | number | 空间面积(平方米) |
|
|
122
|
+
| center | [lng, lat] | 空间中心点坐标 |
|
|
123
|
+
| bestZoom | number | 空间在当前视口下的最佳缩放级别 |
|
|
124
|
+
| cityCodes | string[] | 空间覆盖的区县编码列表 |
|
|
125
|
+
|
|
126
|
+
**用途:** 展示空域信息时,需要面积、中心点、最佳缩放级别等元数据。
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
### 8. `batchGetLineExtra(geo_jsons, mapSizes, paddingRatio)`
|
|
131
|
+
|
|
132
|
+
**批量获取航线额外信息**
|
|
133
|
+
|
|
134
|
+
计算一组航线(线)的额外元信息。
|
|
135
|
+
|
|
136
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
137
|
+
|------|------|--------|------|
|
|
138
|
+
| geo_jsons | Array\<GeoJSON\> | — | 航线 GeoJSON 数组(线要素) |
|
|
139
|
+
| mapSizes | [number, number] | `[4910, 1311]` | 地图视口尺寸(像素) |
|
|
140
|
+
| paddingRatio | number | `0.5` | 边距比例,用于计算最佳缩放级别 |
|
|
141
|
+
|
|
142
|
+
**返回值包含:**
|
|
143
|
+
|
|
144
|
+
| 字段 | 类型 | 说明 |
|
|
145
|
+
|------|------|------|
|
|
146
|
+
| length | number | 航线长度(米) |
|
|
147
|
+
| center | [lng, lat] | 航线中心点坐标 |
|
|
148
|
+
| bestZoom | number | 航线在当前视口下的最佳缩放级别 |
|
|
149
|
+
| cityCodes | string[] | 航线经过的区县编码列表 |
|
|
150
|
+
|
|
151
|
+
**用途:** 展示航线时,需要长度、中心点、最佳缩放级别等信息。
|
|
152
|
+
|
|
153
|
+
---
|
|
154
|
+
|
|
155
|
+
## 使用示例
|
|
156
|
+
javascript import useGeoTools from '@/useWorker/useGeoTools.js'
|
|
157
|
+
|
|
158
|
+
const { getDistricts, batchSimplify, batchGetSpaceExtra } = useGeoTools()
|
|
159
|
+
|
|
160
|
+
// 获取行政区划 const districts = await getDistricts(someGeoJson)
|
|
161
|
+
|
|
162
|
+
// 批量简化 const simplified = await batchSimplify([complexGeoJson], 11)
|
|
163
|
+
|
|
164
|
+
// 获取空间信息 const extras = await batchGetSpaceExtra([polygonGeoJson])
|
|
165
|
+
|
|
166
|
+
## 架构说明
|
|
167
|
+
- 通信采用 `encode/decode` 进行二进制序列化,使用 `Transferable` 传输避免内存拷贝
|
|
168
|
+
- 请求通过 `requestId` 匹配,利用 `pendingRequests` Map 管理异步 Promise
|
|
169
|
+
|
|
170
|
+
|
|
171
|
+
|