shaoxing-geo-tools 0.0.7 → 0.0.9
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 +108 -63
- package/dist/geoToolsWorker-ByYNHbFM.js +16 -0
- package/dist/index.d.ts +1 -5
- package/dist/index.js +29 -2
- package/dist/wasmApi-Dxic4sxN.js +347 -0
- package/package.json +14 -3
- package/dist/geoToolsWorker-CTS0SJgH.js +0 -16
- package/dist/wasmApi-1NHF35d0.js +0 -566
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
## 通用说明
|
|
6
6
|
|
|
7
|
-
- 所有函数均返回 `Promise`,通过 Worker
|
|
7
|
+
- 所有函数均返回 `Promise`,通过 Worker 异步计算(如本身在Worker线程,则不开启新Worker),不阻塞主线程
|
|
8
8
|
- Worker 内部依赖 WASM 进行高性能空间计算
|
|
9
9
|
- 首次调用会自动初始化 Worker,后续复用同一实例
|
|
10
10
|
- 输入参数中的 `geo` 建议使用 `toRaw()` 处理,避免 Vue 响应式代理干扰
|
|
@@ -17,15 +17,16 @@
|
|
|
17
17
|
|
|
18
18
|
**设置默认地图视口和边距比例**
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
_绝大部分情况下无须设置_
|
|
21
21
|
|
|
22
|
-
设置地图视口的默认大小(像素)和边距默认比例,用于 `batchGetSpaceExtra` 和 `batchGetLineExtra` 中的 `zoom`
|
|
22
|
+
设置地图视口的默认大小(像素)和边距默认比例,用于 `batchGetSpaceExtra` 和 `batchGetLineExtra` 中的 `zoom`
|
|
23
|
+
计算。大部分情况下无需调用,使用默认值即可。
|
|
23
24
|
|
|
24
|
-
| 参数
|
|
25
|
-
|
|
26
|
-
| width
|
|
27
|
-
| height | number | `1311` | 地图视口高度(像素)
|
|
28
|
-
| ratio
|
|
25
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
26
|
+
| ------ | ------ | ------ | ---------------------------- |
|
|
27
|
+
| width | number | `4910` | 地图视口宽度(像素) |
|
|
28
|
+
| height | number | `1311` | 地图视口高度(像素) |
|
|
29
|
+
| ratio | number | `0.5` | 边距比例,值越大 `zoom` 越小 |
|
|
29
30
|
|
|
30
31
|
**用途:** 当地图容器大小或边距需求变化时,通过此函数同步更新默认参数,以确保后续 `zoom` 计算结果准确。
|
|
31
32
|
|
|
@@ -37,11 +38,11 @@
|
|
|
37
38
|
|
|
38
39
|
根据传入的地理范围(GeoJSON),返回该区域覆盖的行政区划数据(仅对绍兴市有效)。
|
|
39
40
|
|
|
40
|
-
| 参数 | 类型
|
|
41
|
-
|
|
42
|
-
| geo
|
|
41
|
+
| 参数 | 类型 | 说明 |
|
|
42
|
+
| ---- | ------- | -------------- |
|
|
43
|
+
| geo | GeoJSON | 输入的地理范围 |
|
|
43
44
|
|
|
44
|
-
**用途:**
|
|
45
|
+
**用途:** 在地图上选中一个区域后,查询该区域所包含的行政区(区/县),是否跨越绍兴市等信息。
|
|
45
46
|
|
|
46
47
|
---
|
|
47
48
|
|
|
@@ -51,9 +52,9 @@
|
|
|
51
52
|
|
|
52
53
|
对传入的点(Point)进行空间校验或查询。
|
|
53
54
|
|
|
54
|
-
| 参数 | 类型
|
|
55
|
-
|
|
56
|
-
| geo
|
|
55
|
+
| 参数 | 类型 | 说明 |
|
|
56
|
+
| ---- | ------- | ------------------ |
|
|
57
|
+
| geo | GeoJSON | 待检查的点几何对象 |
|
|
57
58
|
|
|
58
59
|
**用途:** 判断某个坐标点是否在特定区域内、是否合法等。
|
|
59
60
|
|
|
@@ -65,9 +66,9 @@
|
|
|
65
66
|
|
|
66
67
|
对传入的线(LineString)进行空间校验或查询。
|
|
67
68
|
|
|
68
|
-
| 参数 | 类型
|
|
69
|
-
|
|
70
|
-
| geo
|
|
69
|
+
| 参数 | 类型 | 说明 |
|
|
70
|
+
| ---- | ------- | ------------------ |
|
|
71
|
+
| geo | GeoJSON | 待检查的线几何对象 |
|
|
71
72
|
|
|
72
73
|
**用途:** 检查航线、路径等线状要素是否符合空间约束和geoJson标准。
|
|
73
74
|
|
|
@@ -79,9 +80,9 @@
|
|
|
79
80
|
|
|
80
81
|
对传入的多边形(Polygon)进行空间校验或查询。
|
|
81
82
|
|
|
82
|
-
| 参数 | 类型
|
|
83
|
-
|
|
84
|
-
| geo
|
|
83
|
+
| 参数 | 类型 | 说明 |
|
|
84
|
+
| ---- | ------- | ---------------------- |
|
|
85
|
+
| geo | GeoJSON | 待检查的多边形几何对象 |
|
|
85
86
|
|
|
86
87
|
**用途:** 检查空域、区域等面状要素的空间合法性。
|
|
87
88
|
|
|
@@ -93,13 +94,13 @@
|
|
|
93
94
|
|
|
94
95
|
计算一组 GeoJSON 在指定距离下的覆盖范围,并支持设置不同透明度。
|
|
95
96
|
|
|
96
|
-
| 参数
|
|
97
|
-
|
|
98
|
-
| geo_jsons | Array\<GeoJSON\> | —
|
|
99
|
-
| distances | Array\<number\>
|
|
100
|
-
| opacities | Array\<number\>
|
|
97
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
98
|
+
| --------- | ---------------- | ----------------- | ------------------------------ |
|
|
99
|
+
| geo_jsons | Array\<GeoJSON\> | — | 需要计算覆盖的 GeoJSON 数组 |
|
|
100
|
+
| distances | Array\<number\> | — | 覆盖距离(米),每个层级一个值 |
|
|
101
|
+
| opacities | Array\<number\> | `[0.2, 0.2, 0.2]` | 每层覆盖的透明度 |
|
|
101
102
|
|
|
102
|
-
**用途:** 用于展示基站/无人机等设备的信号覆盖范围、服务半径等。
|
|
103
|
+
**用途:** 用于展示基站/无人机等设备的信号覆盖范围、服务半径等。 **提示:** distances数组和opacities数组的长度必须一致。
|
|
103
104
|
|
|
104
105
|
---
|
|
105
106
|
|
|
@@ -111,10 +112,10 @@
|
|
|
111
112
|
|
|
112
113
|
> ⚠️ **注意:** 返回的数组元素数量 ≤ 传入的数组元素数量(不合法数据会被自动删除)。
|
|
113
114
|
|
|
114
|
-
| 参数
|
|
115
|
-
|
|
116
|
-
| geo_jsons
|
|
117
|
-
| toleranceMeters | number
|
|
115
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
116
|
+
| --------------- | ---------------- | ------ | ---------------------------------------- |
|
|
117
|
+
| geo_jsons | Array\<GeoJSON\> | — | 需要简化的 GeoJSON 数组 |
|
|
118
|
+
| toleranceMeters | number | `11` | 简化容差(米),该距离内的相邻点将被合并 |
|
|
118
119
|
|
|
119
120
|
**用途:** 减少高精度 GeoJSON 的数据量,提升渲染和传输性能。默认值 11 米 ≈ turf 的 `tolerance: 0.0001`。
|
|
120
121
|
|
|
@@ -126,20 +127,20 @@
|
|
|
126
127
|
|
|
127
128
|
计算一组空间(多边形/面)的额外元信息。
|
|
128
129
|
|
|
129
|
-
| 参数
|
|
130
|
-
|
|
131
|
-
| geo_jsons
|
|
132
|
-
| mapSizes
|
|
133
|
-
| paddingRatio | number
|
|
130
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
131
|
+
| ------------ | ---------------- | -------------- | ------------------------------ |
|
|
132
|
+
| geo_jsons | Array\<GeoJSON\> | — | 空间 GeoJSON 数组(面要素) |
|
|
133
|
+
| mapSizes | [number, number] | `[4910, 1311]` | 地图视口尺寸(像素) |
|
|
134
|
+
| paddingRatio | number | `0.5` | 边距比例,用于计算最佳缩放级别 |
|
|
134
135
|
|
|
135
136
|
**返回值包含:**
|
|
136
137
|
|
|
137
|
-
| 字段
|
|
138
|
-
|
|
139
|
-
| area
|
|
140
|
-
| center
|
|
141
|
-
| zoom
|
|
142
|
-
| cityCodes | string[]
|
|
138
|
+
| 字段 | 类型 | 说明 |
|
|
139
|
+
| --------- | ---------- | ------------------------------ |
|
|
140
|
+
| area | number | 空间面积(平方米) |
|
|
141
|
+
| center | [lng, lat] | 空间中心点坐标 |
|
|
142
|
+
| zoom | number | 空间在当前视口下的最佳缩放级别 |
|
|
143
|
+
| cityCodes | string[] | 空间覆盖的区县编码列表 |
|
|
143
144
|
|
|
144
145
|
**用途:** 展示空域信息时,需要面积、中心点、最佳缩放级别等元数据。
|
|
145
146
|
|
|
@@ -151,33 +152,67 @@
|
|
|
151
152
|
|
|
152
153
|
计算一组航线(线)的额外元信息。
|
|
153
154
|
|
|
154
|
-
| 参数
|
|
155
|
-
|
|
156
|
-
| geo_jsons
|
|
157
|
-
| mapSizes
|
|
158
|
-
| paddingRatio | number
|
|
155
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
156
|
+
| ------------ | ---------------- | -------------- | ------------------------------ |
|
|
157
|
+
| geo_jsons | Array\<GeoJSON\> | — | 航线 GeoJSON 数组(线要素) |
|
|
158
|
+
| mapSizes | [number, number] | `[4910, 1311]` | 地图视口尺寸(像素) |
|
|
159
|
+
| paddingRatio | number | `0.5` | 边距比例,用于计算最佳缩放级别 |
|
|
159
160
|
|
|
160
161
|
**返回值包含:**
|
|
161
162
|
|
|
162
|
-
| 字段
|
|
163
|
-
|
|
164
|
-
| length
|
|
165
|
-
| center
|
|
166
|
-
| zoom
|
|
167
|
-
| cityCodes | string[]
|
|
163
|
+
| 字段 | 类型 | 说明 |
|
|
164
|
+
| --------- | ---------- | ------------------------------ |
|
|
165
|
+
| length | number | 航线长度(米) |
|
|
166
|
+
| center | [lng, lat] | 航线中心点坐标 |
|
|
167
|
+
| zoom | number | 航线在当前视口下的最佳缩放级别 |
|
|
168
|
+
| cityCodes | string[] | 航线经过的区县编码列表 |
|
|
168
169
|
|
|
169
170
|
**用途:** 展示航线时,需要长度、中心点、最佳缩放级别等信息。
|
|
170
171
|
|
|
171
172
|
---
|
|
172
173
|
|
|
173
|
-
### 10. `
|
|
174
|
+
### 10. `batchCalcRouteMatch(routes, geoJsons, options)`
|
|
175
|
+
|
|
176
|
+
**批量计算路线匹配率**
|
|
177
|
+
|
|
178
|
+
计算当前飞行路线与预定航线或空域的匹配率(全部匹配率和部分匹配率)。
|
|
179
|
+
|
|
180
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
181
|
+
| -------- | ---------------- | ------ | --------------------------- |
|
|
182
|
+
| routes | Array\<GeoJSON\> | — | 当前飞行路线(线要素) |
|
|
183
|
+
| geoJsons | Array\<GeoJSON\> | — | 预定航线或空域(线/面要素) |
|
|
184
|
+
| options | object | `{}` | 距离阈值配置 |
|
|
185
|
+
|
|
186
|
+
**`options` 参数:**
|
|
187
|
+
|
|
188
|
+
| 字段 | 类型 | 默认值 | 说明 |
|
|
189
|
+
| ---------------------- | ------ | ------ | ---------------------------- |
|
|
190
|
+
| linePerfectDistance | number | `15` | 线路完全匹配距离阈值(米) |
|
|
191
|
+
| lineMaxDistance | number | `60` | 线路最大匹配距离阈值(米) |
|
|
192
|
+
| polygonPerfectDistance | number | `100` | 多边形完全匹配距离阈值(米) |
|
|
193
|
+
| polygonMaxDistance | number | `300` | 多边形最大匹配距离阈值(米) |
|
|
194
|
+
|
|
195
|
+
**返回值包含:**
|
|
196
|
+
|
|
197
|
+
| 字段 | 类型 | 说明 |
|
|
198
|
+
| ---------------- | ------ | ---------- |
|
|
199
|
+
| fullMatchRate | number | 全部匹配率 |
|
|
200
|
+
| partialMatchRate | number | 部分匹配率 |
|
|
201
|
+
|
|
202
|
+
**部分匹配率:** 是指在符合匹配的平均值(即剔除0%匹配率外的数据平均值)
|
|
203
|
+
|
|
204
|
+
**用途:** 计算无人机飞行路线与预定航线/空域的吻合程度,用于飞行合规性检查、航迹评估等场景。
|
|
205
|
+
|
|
206
|
+
---
|
|
207
|
+
|
|
208
|
+
### 11. `getCityBoundary(toleranceMeters)`
|
|
174
209
|
|
|
175
210
|
**获取绍兴市边界**
|
|
176
211
|
|
|
177
212
|
从 WASM 中读取绍兴市行政边界 GeoJSON(`FeatureCollection`),可按米为单位设置简化容差来减少数据量。
|
|
178
213
|
|
|
179
|
-
| 参数
|
|
180
|
-
|
|
214
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
215
|
+
| --------------- | -------------- | ------ | -------------------------------------------- |
|
|
181
216
|
| toleranceMeters | number \| null | `null` | 简化容差(米),不传或传 `null` 返回完整边界 |
|
|
182
217
|
|
|
183
218
|
**返回值:** 解析结果为 `{ valid, message, data }`,`data` 为 `FeatureCollection<Polygon>`。
|
|
@@ -186,14 +221,14 @@
|
|
|
186
221
|
|
|
187
222
|
---
|
|
188
223
|
|
|
189
|
-
###
|
|
224
|
+
### 12. `getDistrictBoundary(toleranceMeters)`
|
|
190
225
|
|
|
191
226
|
**获取绍兴市各区县边界**
|
|
192
227
|
|
|
193
228
|
从 WASM 中读取绍兴市各区县行政边界 GeoJSON(`FeatureCollection`),每个区县为一个 Feature,可按米为单位设置简化容差。
|
|
194
229
|
|
|
195
|
-
| 参数
|
|
196
|
-
|
|
230
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
231
|
+
| --------------- | -------------- | ------ | -------------------------------------------- |
|
|
197
232
|
| toleranceMeters | number \| null | `null` | 简化容差(米),不传或传 `null` 返回完整边界 |
|
|
198
233
|
|
|
199
234
|
**返回值:** 解析结果为 `{ valid, message, data }`,`data` 为 `FeatureCollection<Polygon>`。
|
|
@@ -203,13 +238,14 @@
|
|
|
203
238
|
---
|
|
204
239
|
|
|
205
240
|
## 使用示例
|
|
241
|
+
|
|
206
242
|
```javascript
|
|
207
243
|
import geoTools from 'shaoxing-geo-tools'
|
|
208
244
|
|
|
209
245
|
// 设置默认地图视口和边距比例, 也可以不设置,在 batchGetSpaceExtra 和 batchGetLineExtra 传入[1920, 1080]以及0.5
|
|
210
246
|
// setDefault设置后,batchGetSpaceExtra 和 batchGetLineExtra 中缺省就按设置的走
|
|
211
247
|
|
|
212
|
-
geoTools.setDefault(1920, 1080, 0.3)
|
|
248
|
+
geoTools.setDefault(1920, 1080, 0.3) // 可省略
|
|
213
249
|
|
|
214
250
|
// 获取行政区划
|
|
215
251
|
const districts = await geoTools.getDistricts(someGeoJson)
|
|
@@ -225,16 +261,25 @@ geoTools.batchGetSpaceExtra([polygonGeoJson]).then(result => {})
|
|
|
225
261
|
|
|
226
262
|
// 获取绍兴市边界
|
|
227
263
|
const cityBoundary = await geoTools.getCityBoundary()
|
|
264
|
+
geoTools.getCityBoundary().then(result => {})
|
|
228
265
|
// 或传入简化容差
|
|
229
266
|
const simplifiedCityBoundary = await geoTools.getCityBoundary(50)
|
|
267
|
+
geoTools.getCityBoundary(50).then(result => {})
|
|
268
|
+
|
|
269
|
+
// 线路匹配率计算
|
|
270
|
+
// option可不传,默认:航线为 15米内100%匹配,60米外0%匹配, 空域100米内100%匹配,300米外0%匹配
|
|
271
|
+
const matchResult = await geoTools.batchCalcRouteMatch([routeLineGeoJson], [presetRouteGeoJson], {
|
|
272
|
+
linePerfectDistance: 15,
|
|
273
|
+
lineMaxDistance: 60,
|
|
274
|
+
})
|
|
275
|
+
geoTools.batchCalcRouteMatch([routeLineGeoJson], [presetRouteGeoJson]).then(result => {})
|
|
230
276
|
|
|
231
277
|
// 获取各区县边界
|
|
232
278
|
const districtBoundary = await geoTools.getDistrictBoundary()
|
|
279
|
+
geoTools.getDistrictBoundary(50).then(result => {})
|
|
233
280
|
```
|
|
234
281
|
|
|
235
282
|
## 架构说明
|
|
283
|
+
|
|
236
284
|
- 通信采用 `encode/decode` 进行二进制序列化,使用 `Transferable` 传输避免内存拷贝
|
|
237
285
|
- 请求通过 `requestId` 匹配,利用 `pendingRequests` Map 管理异步 Promise
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|