shaoxing-geo-tools 0.0.1 → 0.0.3

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 CHANGED
@@ -13,7 +13,36 @@
13
13
 
14
14
  ## 功能列表
15
15
 
16
- ### 1. `getDistricts(geo)`
16
+ ### 1. `setMapSize(width, height)`
17
+
18
+ **设置地图视口默认尺寸**
19
+
20
+ 设置地图视口的默认大小(像素),用于 `batchGetSpaceExtra` 和 `batchGetLineExtra` 中的 `bestZoom` 计算。
21
+
22
+ | 参数 | 类型 | 默认值 | 说明 |
23
+ |------|------|--------|------|
24
+ | width | number | `4910` | 地图视口宽度(像素) |
25
+ | height | number | `1311` | 地图视口高度(像素) |
26
+
27
+ **用途:** 当地图容器大小变化时,通过此函数同步更新视口尺寸,以确保 `bestZoom` 计算结果准确。
28
+
29
+ ---
30
+
31
+ ### 2. `setPaddingRatio(ratio)`
32
+
33
+ **设置边距默认比例**
34
+
35
+ 设置用于计算最佳缩放级别的边距默认比例,值越大则缩放级别越小(视野更宽)。
36
+
37
+ | 参数 | 类型 | 默认值 | 说明 |
38
+ |------|------|--------|------|
39
+ | ratio | number | `0.5` | 边距比例,值越大 `bestZoom` 越小 |
40
+
41
+ **用途:** 调整空间/航线在视口中的边距,控制最佳缩放级别的计算结果。
42
+
43
+ ---
44
+
45
+ ### 3. `getDistricts(geo)`
17
46
 
18
47
  **获取行政区划信息**
19
48
 
@@ -27,7 +56,7 @@
27
56
 
28
57
  ---
29
58
 
30
- ### 2. `checkPoint(geo)`
59
+ ### 4. `checkPoint(geo)`
31
60
 
32
61
  **检查点**
33
62
 
@@ -41,7 +70,7 @@
41
70
 
42
71
  ---
43
72
 
44
- ### 3. `checkLine(geo)`
73
+ ### 5. `checkLine(geo)`
45
74
 
46
75
  **检查线**
47
76
 
@@ -55,7 +84,7 @@
55
84
 
56
85
  ---
57
86
 
58
- ### 4. `checkPolygon(geo)`
87
+ ### 6. `checkPolygon(geo)`
59
88
 
60
89
  **检查多边形**
61
90
 
@@ -69,7 +98,7 @@
69
98
 
70
99
  ---
71
100
 
72
- ### 5. `batchGetCovers(geo_jsons, distances, opacities)`
101
+ ### 7. `batchGetCovers(geo_jsons, distances, opacities)`
73
102
 
74
103
  **批量获取覆盖信息**
75
104
 
@@ -85,7 +114,7 @@
85
114
 
86
115
  ---
87
116
 
88
- ### 6. `batchSimplify(geo_jsons, toleranceMeters)`
117
+ ### 8. `batchSimplify(geo_jsons, toleranceMeters)`
89
118
 
90
119
  **批量简化 GeoJSON 数据**
91
120
 
@@ -102,7 +131,7 @@
102
131
 
103
132
  ---
104
133
 
105
- ### 7. `batchGetSpaceExtra(geo_jsons, mapSizes, paddingRatio)`
134
+ ### 9. `batchGetSpaceExtra(geo_jsons, mapSizes, paddingRatio)`
106
135
 
107
136
  **批量获取空间额外信息**
108
137
 
@@ -127,7 +156,7 @@
127
156
 
128
157
  ---
129
158
 
130
- ### 8. `batchGetLineExtra(geo_jsons, mapSizes, paddingRatio)`
159
+ ### 10. `batchGetLineExtra(geo_jsons, mapSizes, paddingRatio)`
131
160
 
132
161
  **批量获取航线额外信息**
133
162
 
@@ -153,15 +182,26 @@
153
182
  ---
154
183
 
155
184
  ## 使用示例
156
- javascript import useGeoTools from '@/useWorker/useGeoTools.js'
185
+ ```javascript
186
+ import useGeoTools from '@/useWorker/useGeoTools.js'
187
+
188
+ const { setMapSize, setPaddingRatio, getDistricts, batchSimplify, batchGetSpaceExtra } = useGeoTools()
189
+
190
+ // 设置地图视口尺寸
191
+ setMapSize(1920, 1080)
157
192
 
158
- const { getDistricts, batchSimplify, batchGetSpaceExtra } = useGeoTools()
193
+ // 设置边距比例
194
+ setPaddingRatio(0.3)
159
195
 
160
- // 获取行政区划 const districts = await getDistricts(someGeoJson)
196
+ // 获取行政区划
197
+ const districts = await getDistricts(someGeoJson)
161
198
 
162
- // 批量简化 const simplified = await batchSimplify([complexGeoJson], 11)
199
+ // 批量简化
200
+ const simplified = await batchSimplify([complexGeoJson], 11)
163
201
 
164
- // 获取空间信息 const extras = await batchGetSpaceExtra([polygonGeoJson])
202
+ // 获取空间信息
203
+ const extras = await batchGetSpaceExtra([polygonGeoJson])
204
+ ```
165
205
 
166
206
  ## 架构说明
167
207
  - 通信采用 `encode/decode` 进行二进制序列化,使用 `Transferable` 传输避免内存拷贝