flutter_google_maps_widget_cluster_markers 是一个用于在 Flutter 中使用 Google 地图时实现标记聚类的插件。它可以帮助你在有大量标记时，将相近的标记聚合成一个集群，从而提高地图的可读性和性能。

安装插件

首先，你需要在 pubspec.yaml 文件中添加依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_google_maps_widget_cluster_markers: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

基本用法

1. 导入插件：

   import 'package:flutter_google_maps_widget_cluster_markers/flutter_google_maps_widget_cluster_markers.dart';
   

2. 创建地图控制器：

   final GoogleMapController _mapController;
   

3. 初始化地图：

   GoogleMap(
     initialCameraPosition: CameraPosition(
       target: LatLng(37.7749, -122.4194), // 初始位置
       zoom: 12.0,
     ),
     onMapCreated: (GoogleMapController controller) {
       _mapController = controller;
     },
     markers: _createMarkers(), // 创建标记
     onCameraMove: (CameraPosition position) {
       // 处理地图移动事件
     },
   );
   

4. 创建标记：

   Set<Marker> _createMarkers() {
     Set<Marker> markers = {};
     // 添加标记
     markers.add(Marker(
       markerId: MarkerId('marker1'),
       position: LatLng(37.7749, -122.4194),
       infoWindow: InfoWindow(title: 'Marker 1'),
     ));
     markers.add(Marker(
       markerId: MarkerId('marker2'),
       position: LatLng(37.7849, -122.4294),
       infoWindow: InfoWindow(title: 'Marker 2'),
     ));
     return markers;
   }
   

5. 使用聚类功能：

   MarkerClusterer(
     markers: _createMarkers(),
     onClusterTap: (Cluster cluster) {
       // 处理集群点击事件
     },
     onMarkerTap: (Marker marker) {
       // 处理标记点击事件
     },
     onCameraMove: (CameraPosition position) {
       // 处理地图移动事件
     },
   );
   

高级用法

1. 自定义集群图标：

   你可以通过 clusterIcon 参数来自定义集群图标：

   MarkerClusterer(
     markers: _createMarkers(),
     clusterIcon: BitmapDescriptor.defaultMarkerWithHue(BitmapDescriptor.hueRed),
     onClusterTap: (Cluster cluster) {
       // 处理集群点击事件
     },
   );
   

2. 调整聚类算法：

   你可以通过 algorithm 参数来调整聚类算法：

   MarkerClusterer(
     markers: _createMarkers(),
     algorithm: ClusterAlgorithm.gridBased(
       gridSize: 60, // 网格大小
     ),
     onClusterTap: (Cluster cluster) {
       // 处理集群点击事件
     },
   );
   

3. 处理地图移动事件：

   你可以通过 onCameraMove 参数来处理地图移动事件：

   MarkerClusterer(
     markers: _createMarkers(),
     onCameraMove: (CameraPosition position) {
       // 处理地图移动事件
     },
   );
   

示例代码

以下是一个完整的示例代码：

import 'package:flutter/material.dart';
import 'package:google_maps_flutter/google_maps_flutter.dart';
import 'package:flutter_google_maps_widget_cluster_markers/flutter_google_maps_widget_cluster_markers.dart';

class MapScreen extends StatefulWidget {
  [@override](/user/override)
  _MapScreenState createState() => _MapScreenState();
}

class _MapScreenState extends State<MapScreen> {
  GoogleMapController _mapController;

  Set<Marker> _createMarkers() {
    Set<Marker> markers = {};
    markers.add(Marker(
      markerId: MarkerId('marker1'),
      position: LatLng(37.7749, -122.4194),
      infoWindow: InfoWindow(title: 'Marker 1'),
    ));
    markers.add(Marker(
      markerId: MarkerId('marker2'),
      position: LatLng(37.7849, -122.4294),
      infoWindow: InfoWindow(title: 'Marker 2'),
    ));
    return markers;
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Google Maps Cluster Markers'),
      ),
      body: GoogleMap(
        initialCameraPosition: CameraPosition(
          target: LatLng(37.7749, -122.4194),
          zoom: 12.0,
        ),
        onMapCreated: (GoogleMapController controller) {
          _mapController = controller;
        },
        markers: _createMarkers(),
        onCameraMove: (CameraPosition position) {
          // 处理地图移动事件
        },
      ),
    );
  }
}

void main() => runApp(MaterialApp(
  home: MapScreen(),
));