@wenle_2523097/agri-map 1.0.0 → 1.0.2

package/README.md

@@ -184,6 +184,69 @@ const markers: MarkerData[] = [
 | `onCreate` | `(result) => void` | - | 新建回调 |
 | `onMove` | `(result) => void` | - | 移动回调 |
 | `onDelete` | `(result) => void` | - | 删除回调 |
+| `cluster` | `boolean \| MarkerClusterConfig` | `false` | 聚合配置 |
+| `onClusterClick` | `(count, markers) => void` | - | 聚合气泡点击回调 |
+| `icons` | `MarkerIconsConfig` | - | 统一图标配置 |
+
+#### 聚合功能
+
+Marker 组件支持标注点聚合，在小缩放级别下将相近的标注点聚合为气泡显示，提升大量标注点时的渲染性能。
+
+```tsx
+// 启用默认聚合
+<Marker
+  dataSource={markers}
+  cluster={true}
+/>
+
+// 自定义聚合配置
+<Marker
+  dataSource={markers}
+  cluster={{
+    radius: 60,        // 聚合半径（像素），默认 40
+    maxZoom: 16,       // 最大聚合 zoom 级别，默认 18
+    minPoints: 3,      // 最小聚合点数，默认 2
+    onClickBehavior: 'expand',  // 点击行为：'zoom' 或 'expand'
+  }}
+  onClusterClick={(count, markers) => {
+    console.log(`点击了包含 ${count} 个点的聚合`);
+  }}
+/>
+
+// 自定义聚合气泡图标
+<Marker
+  dataSource={markers}
+  cluster={true}
+  icons={{
+    cluster: {
+      icon: 'marker-yellow',
+      colors: ['#1890ff', '#faad14', '#ff4d4f'],
+      animated: true,
+      showCount: true,
+    },
+    default: { icon: 'point', iconSize: [32, 32] },
+    selected: { icon: 'position-red' },
+  }}
+/>
+```
+
+#### MarkerClusterConfig
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `radius` | `number` | `40` | 聚合半径（像素） |
+| `maxZoom` | `number` | `18` | 聚合生效的最大 zoom 级别 |
+| `minPoints` | `number` | `2` | 最小聚合点数 |
+| `onClickBehavior` | `'zoom' \| 'expand'` | `'zoom'` | 点击聚合气泡后的行为 |
+
+#### MarkerIconsConfig
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| `default` | `MarkerIconItemConfig` | 默认状态图标配置 |
+| `selected` | `MarkerIconItemConfig` | 选中状态图标配置 |
+| `editing` | `MarkerIconItemConfig` | 编辑中状态图标配置 |
+| `cluster` | `ClusterIconConfig` | 聚合气泡图标配置 |
 
 ---
 
@@ -343,7 +406,7 @@ import { ConfigProvider } from 'agri-map';
 ```tsx
 import {
   Icons,
-  RedrawIcon,
+  PlotRedrawIcon,
   ClipIcon,
   MoveIcon,
   DeleteIcon,