shaoxing-geo-tools 0.0.8 → 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 +102 -61
- 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 +12 -2
- package/dist/geoToolsWorker-IYdeZCAE.js +0 -16
- package/dist/wasmApi-zNV2PTPj.js +0 -335
package/README.md
CHANGED
|
@@ -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,9 +38,9 @@
|
|
|
37
38
|
|
|
38
39
|
根据传入的地理范围(GeoJSON),返回该区域覆盖的行政区划数据(仅对绍兴市有效)。
|
|
39
40
|
|
|
40
|
-
| 参数 | 类型
|
|
41
|
-
|
|
42
|
-
| geo
|
|
41
|
+
| 参数 | 类型 | 说明 |
|
|
42
|
+
| ---- | ------- | -------------- |
|
|
43
|
+
| geo | GeoJSON | 输入的地理范围 |
|
|
43
44
|
|
|
44
45
|
**用途:** 在地图上选中一个区域后,查询该区域所包含的行政区(区/县),是否跨越绍兴市等信息。
|
|
45
46
|
|
|
@@ -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,14 +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
|
+
**用途:** 用于展示基站/无人机等设备的信号覆盖范围、服务半径等。 **提示:** distances数组和opacities数组的长度必须一致。
|
|
104
104
|
|
|
105
105
|
---
|
|
106
106
|
|
|
@@ -112,10 +112,10 @@
|
|
|
112
112
|
|
|
113
113
|
> ⚠️ **注意:** 返回的数组元素数量 ≤ 传入的数组元素数量(不合法数据会被自动删除)。
|
|
114
114
|
|
|
115
|
-
| 参数
|
|
116
|
-
|
|
117
|
-
| geo_jsons
|
|
118
|
-
| toleranceMeters | number
|
|
115
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
116
|
+
| --------------- | ---------------- | ------ | ---------------------------------------- |
|
|
117
|
+
| geo_jsons | Array\<GeoJSON\> | — | 需要简化的 GeoJSON 数组 |
|
|
118
|
+
| toleranceMeters | number | `11` | 简化容差(米),该距离内的相邻点将被合并 |
|
|
119
119
|
|
|
120
120
|
**用途:** 减少高精度 GeoJSON 的数据量,提升渲染和传输性能。默认值 11 米 ≈ turf 的 `tolerance: 0.0001`。
|
|
121
121
|
|
|
@@ -127,20 +127,20 @@
|
|
|
127
127
|
|
|
128
128
|
计算一组空间(多边形/面)的额外元信息。
|
|
129
129
|
|
|
130
|
-
| 参数
|
|
131
|
-
|
|
132
|
-
| geo_jsons
|
|
133
|
-
| mapSizes
|
|
134
|
-
| paddingRatio | number
|
|
130
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
131
|
+
| ------------ | ---------------- | -------------- | ------------------------------ |
|
|
132
|
+
| geo_jsons | Array\<GeoJSON\> | — | 空间 GeoJSON 数组(面要素) |
|
|
133
|
+
| mapSizes | [number, number] | `[4910, 1311]` | 地图视口尺寸(像素) |
|
|
134
|
+
| paddingRatio | number | `0.5` | 边距比例,用于计算最佳缩放级别 |
|
|
135
135
|
|
|
136
136
|
**返回值包含:**
|
|
137
137
|
|
|
138
|
-
| 字段
|
|
139
|
-
|
|
140
|
-
| area
|
|
141
|
-
| center
|
|
142
|
-
| zoom
|
|
143
|
-
| cityCodes | string[]
|
|
138
|
+
| 字段 | 类型 | 说明 |
|
|
139
|
+
| --------- | ---------- | ------------------------------ |
|
|
140
|
+
| area | number | 空间面积(平方米) |
|
|
141
|
+
| center | [lng, lat] | 空间中心点坐标 |
|
|
142
|
+
| zoom | number | 空间在当前视口下的最佳缩放级别 |
|
|
143
|
+
| cityCodes | string[] | 空间覆盖的区县编码列表 |
|
|
144
144
|
|
|
145
145
|
**用途:** 展示空域信息时,需要面积、中心点、最佳缩放级别等元数据。
|
|
146
146
|
|
|
@@ -152,33 +152,67 @@
|
|
|
152
152
|
|
|
153
153
|
计算一组航线(线)的额外元信息。
|
|
154
154
|
|
|
155
|
-
| 参数
|
|
156
|
-
|
|
157
|
-
| geo_jsons
|
|
158
|
-
| mapSizes
|
|
159
|
-
| paddingRatio | number
|
|
155
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
156
|
+
| ------------ | ---------------- | -------------- | ------------------------------ |
|
|
157
|
+
| geo_jsons | Array\<GeoJSON\> | — | 航线 GeoJSON 数组(线要素) |
|
|
158
|
+
| mapSizes | [number, number] | `[4910, 1311]` | 地图视口尺寸(像素) |
|
|
159
|
+
| paddingRatio | number | `0.5` | 边距比例,用于计算最佳缩放级别 |
|
|
160
160
|
|
|
161
161
|
**返回值包含:**
|
|
162
162
|
|
|
163
|
-
| 字段
|
|
164
|
-
|
|
165
|
-
| length
|
|
166
|
-
| center
|
|
167
|
-
| zoom
|
|
168
|
-
| cityCodes | string[]
|
|
163
|
+
| 字段 | 类型 | 说明 |
|
|
164
|
+
| --------- | ---------- | ------------------------------ |
|
|
165
|
+
| length | number | 航线长度(米) |
|
|
166
|
+
| center | [lng, lat] | 航线中心点坐标 |
|
|
167
|
+
| zoom | number | 航线在当前视口下的最佳缩放级别 |
|
|
168
|
+
| cityCodes | string[] | 航线经过的区县编码列表 |
|
|
169
169
|
|
|
170
170
|
**用途:** 展示航线时,需要长度、中心点、最佳缩放级别等信息。
|
|
171
171
|
|
|
172
172
|
---
|
|
173
173
|
|
|
174
|
-
### 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)`
|
|
175
209
|
|
|
176
210
|
**获取绍兴市边界**
|
|
177
211
|
|
|
178
212
|
从 WASM 中读取绍兴市行政边界 GeoJSON(`FeatureCollection`),可按米为单位设置简化容差来减少数据量。
|
|
179
213
|
|
|
180
|
-
| 参数
|
|
181
|
-
|
|
214
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
215
|
+
| --------------- | -------------- | ------ | -------------------------------------------- |
|
|
182
216
|
| toleranceMeters | number \| null | `null` | 简化容差(米),不传或传 `null` 返回完整边界 |
|
|
183
217
|
|
|
184
218
|
**返回值:** 解析结果为 `{ valid, message, data }`,`data` 为 `FeatureCollection<Polygon>`。
|
|
@@ -187,14 +221,14 @@
|
|
|
187
221
|
|
|
188
222
|
---
|
|
189
223
|
|
|
190
|
-
###
|
|
224
|
+
### 12. `getDistrictBoundary(toleranceMeters)`
|
|
191
225
|
|
|
192
226
|
**获取绍兴市各区县边界**
|
|
193
227
|
|
|
194
228
|
从 WASM 中读取绍兴市各区县行政边界 GeoJSON(`FeatureCollection`),每个区县为一个 Feature,可按米为单位设置简化容差。
|
|
195
229
|
|
|
196
|
-
| 参数
|
|
197
|
-
|
|
230
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
231
|
+
| --------------- | -------------- | ------ | -------------------------------------------- |
|
|
198
232
|
| toleranceMeters | number \| null | `null` | 简化容差(米),不传或传 `null` 返回完整边界 |
|
|
199
233
|
|
|
200
234
|
**返回值:** 解析结果为 `{ valid, message, data }`,`data` 为 `FeatureCollection<Polygon>`。
|
|
@@ -204,6 +238,7 @@
|
|
|
204
238
|
---
|
|
205
239
|
|
|
206
240
|
## 使用示例
|
|
241
|
+
|
|
207
242
|
```javascript
|
|
208
243
|
import geoTools from 'shaoxing-geo-tools'
|
|
209
244
|
|
|
@@ -231,14 +266,20 @@ geoTools.getCityBoundary().then(result => {})
|
|
|
231
266
|
const simplifiedCityBoundary = await geoTools.getCityBoundary(50)
|
|
232
267
|
geoTools.getCityBoundary(50).then(result => {})
|
|
233
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 => {})
|
|
276
|
+
|
|
234
277
|
// 获取各区县边界
|
|
235
278
|
const districtBoundary = await geoTools.getDistrictBoundary()
|
|
236
279
|
geoTools.getDistrictBoundary(50).then(result => {})
|
|
237
280
|
```
|
|
238
281
|
|
|
239
282
|
## 架构说明
|
|
283
|
+
|
|
240
284
|
- 通信采用 `encode/decode` 进行二进制序列化,使用 `Transferable` 传输避免内存拷贝
|
|
241
285
|
- 请求通过 `requestId` 匹配,利用 `pendingRequests` Map 管理异步 Promise
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|