Android 地图 SDK（点聚合功能已经整合到地图SDK中）

ClusterManager：点聚合管理类

1、为了实现聚合功能，需要对ClusterManager进行初始化

  // 实例化点聚合管理者
    mClusterManager = new ClusterManager<MarkerClusterItem>(this, tencentMap);

 // 默认聚合策略，调用时不必添加，如果需要其他聚合策略可以按以下代码修改
    NonHierarchicalDistanceBasedAlgorithm<MarkerClusterItem> ndba = new NonHierarchicalDistanceBasedAlgorithm<>(this);
 // 设置点聚合生效距离，以dp为单位
    ndba.setMaxDistanceAtZoom(35);
 // 设置策略
    mClusterManager.setAlgorithm(ndba);

 // 设置聚合渲染器，默认使用的是DefaultClusterRenderer，可以不调用下列代码
    DefaultClusterRenderer<MarkerClusterItem> renderer = new DefaultClusterRenderer<>(this, tencentMap, mClusterManager);
 // 设置最小聚合数量，默认为4，这里设置为2，即有2个以上不包括2个marker才会聚合
    renderer.setMinClusterSize(2);
 // 定义聚合的分段，当超过5个不足10个的时候，显示5+，其他分段同理
    renderer.setBuckets(new int[]{5, 10, 20, 50});
    mClusterManager.setRenderer(renderer);

2 、要使用腾讯地图提供的聚合功能，需要实现 ClusterItem 接口

public class MarkerClusterItem implements ClusterItem {
    private final LatLng mLatLng;

    // 自定义实例化方法
    public MarkerClusterItem(double latitude, double longitude) {
        // TODO Auto-generated constructor stub
        mLatLng = new LatLng(latitude, longitude);
    }

    @Override
    public LatLng getPosition() {
        // TODO Auto-generated method stub
        return mLatLng;
    }
}

3、添加聚合数据

List<TencentMapItem> items = new ArrayList<TencentMapItem>();
items.add(new TencentMapItem(39.984059，116.307621));
items.add(new TencentMapItem(39.981954，116.304703));
items.add(new TencentMapItem(39.984355，116.312256));
items.add(new TencentMapItem(39.980442，116.315346));
items.add(new TencentMapItem(39.981527，116.308994));
items.add(new TencentMapItem(39.979751，116.310539));
items.add(new TencentMapItem(39.977252，116.305776));
items.add(new TencentMapItem(39.984026，116.316419));
items.add(new TencentMapItem(39.976956，116.314874));
items.add(new TencentMapItem(39.978501，116.311827));
items.add(new TencentMapItem(39.980277，116.312814));
items.add(new TencentMapItem(39.980236，116.369022));
items.add(new TencentMapItem(39.978838，116.368486));
items.add(new TencentMapItem(39.977161，116.367488));
items.add(new TencentMapItem(39.915398，116.396713));
items.add(new TencentMapItem(39.937645，116.455421));
items.add(new TencentMapItem(39.896304，116.321182));
items.add(new TencentMapItem(31.254487，121.452827));
items.add(new TencentMapItem(31.225133，121.485443));
items.add(new TencentMapItem(31.216912，121.442528));
items.add(new TencentMapItem(31.251552，121.500893));
items.add(new TencentMapItem(31.249204，121.455917));
items.add(new TencentMapItem(22.546885，114.042892));
items.add(new TencentMapItem(22.538086，113.999805));
items.add(new TencentMapItem(22.534756，114.082031));
mClusterManager.addItems(items);

4、设置聚合

tencentMap.setOnCameraChangeListener(mClusterManager);

添加聚合点数据和视图之后，需要在合适的地方调用聚合管理者的 cluster 方法来刷新聚合,调用如下：

 //移除聚合管理者
 mClusterManager.clearItems();
 //重新聚合时调用,如更改聚合配置或刷新地图状态
 mClusterManager.cluster();

使用产品

iOS 地图 SDK（点聚合能力是由iOS 地图 SDK Utils提供的，该工具包目前已经整合在SDK中）

核心类说明

1. QMUAnnotation：聚合点数据类，可被聚合的原始点数据。
2. QMUClusterManager：聚合点管理类，本类为聚合点功能的入口，通过此类的实例来配置聚合功能，和管理数据。
3. QMUClusterAnnotationView：聚合点样式类，一般与QMUClusterAnnotation配套使用。该类包含了一个View，一个背景图片，一个显示文字，可修改显示效果后直接使用。

示例核心点讲解

1. 创建聚合点管理者 QMUClusterManager

1. QMUClusterManager 对象需要通过 QMapView 对象来实例化，因此要注意在创建时需要保证 QMapView 已经实例化：

   self.manager = [[QMUClusterManager alloc] initWithMap:self.mapView];
   

2. manager 对象提供了 CGFloat distance 属性，该属性用于控制聚合的范围，单位为屏幕坐标：

   // 两个聚合点距离小于等于56时，触发聚合
   self.manager.distance = 56;
   

3. manager 可以设置代理对象，控制器实现 <QMUClusterProtocol> 协议可以控制聚合：

   // 该方法用于控制两个点是否可以聚合，返回YES且符合 distance 的距离时才会触发聚合
   // 如果没有实现该方法，则默认距离条件的点就会被聚合
   - (BOOL)clusterAnnotation:(QMUAnnotation*)anno1 withAnnotation:(QMUAnnotation*)anno2 {
       return YES;
   }
   

2. 创建聚合点数据对象 QMUAnnotation

1. 在示例中创建了 QMUAnnotation 的子类 TypedClustableAnnotation，用户通过继承来给数据点添加自定义信息，如在本示例中添加了额外的 int type 属性，用户可以根据业务需要来重载父类方法去控制聚合：

   @implementation TypedClustableAnnotation
   
   - (id)copyWithZone:(nullable NSZone *)zone {
       TypedClustableAnnotation* copy = [[super copyWithZone:zone] init];
       copy.type = self.type;
       return self;
   }
   
   /// 可根据自己的业务需要来决定是否重载和如何实现重载.
   - (BOOL)isEqual:(id)object {
       // 根据type来判断两个聚合点是否为同一个点
       if (self.type != [(TypedClustableAnnotation*)object type]) {
           return NO;
       }
       
       return [super isEqual:object];
   }
   
   @end
   

2. 在项目中的 Resources 文件夹中提供了文本文件 cluster.txt，该文件包含了演示的所有聚合点数据的经纬坐标和一个自定义信息：

   // 经度，纬度，type
   116.307621 39.984059 0
   

3. 通过扫描文本文档中的内容来创建聚合点对象：

   TypedClustableAnnotation *annotation = [[TypedClustableAnnotation alloc] init];
   annotation.coordinate = CLLocationCoordinate2DMake(latitude, longitude);
   annotation.type = hotValue;
   // title属性可以用于展示InfoWindow
   annotation.title = [NSString stringWithFormat:@"聚合数: %f", hotValue];
   

4. 最后，建议将聚合点对象添加至数组中，然后统一设置给聚合管理者：

   // 创建聚合点对象数组
   NSArray *clusterData = [self loadClusterData];
   // 将聚合点设置给管理者对象
   [self.manager addAnnotations:clusterData];
   

3. 创建 QMUClusterAnnotationView

1. QMUClusterAnnotationView 继承自 QAnnotationView，使用方法也基本相同，通过 QMapView 的代理方法来创建点聚合视图：

   - (QAnnotationView *)mapView:(QMapView *)mapView viewForAnnotation:(id<QAnnotation>)annotation {
       if ([annotation isKindOfClass:[QMUClusterAnnotation class]]) {
               
           QMUClusterAnnotationView *annotationView = (QMUClusterAnnotationView*)[mapView dequeueReusableAnnotationViewWithIdentifier:clusterReuseIndetifier];
           clusterAnnotation.title = [NSString stringWithFormat:@"聚和值: %lu", clusterAnnotation.items.count];
               
           if (annotationView == nil) {
               annotationView = [[QMUClusterAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:clusterReuseIndetifier];
           }
               
           // 此处代码为配置视图的属性，将在下面介绍
           ......
               
           return annotationView;
           }
       }
       
       return nil;
   }
   

2. QMUClusterAnnotation 为 QMUAnnotation 的子类，代表了经过聚合计算后的单个聚合点数据，该类提供的 NSUInteger count 属性表达了该聚合点包含的原始点个数，通过属性可以判断点是聚合点还是原始点，进而根据业务需要来自定义：

   if (clusterAnnotation.count > 1) {
       // 如果 count > 1，该点为聚合点
       static NSString *clusterReuseIndetifier = @"cluster";
       QMUClusterAnnotationView *annotationView = (QMUClusterAnnotationView*)[mapView dequeueReusableAnnotationViewWithIdentifier:clusterReuseIndetifier];
   	
       // 此处省略代码为配置聚合点视图属性，可在Demo中查看
       ......
   } else {
       // 如果 count = 1，该点为原始点
       static NSString *hippoReuseIndetifier = @"clusterOrigin";
       QAnnotationView *annotationView = [mapView dequeueReusableAnnotationViewWithIdentifier:hippoReuseIndetifier];
   	
       // 此处省略代码为配置点视图属性，可在Demo中查看
       ...... 
   }
   

4. 创建聚合点信息窗口 InfoWindow

1. 与 QAnnotationView 相同，需要先设置 BOOL canShowCallout 属性为YES：

   annotationView.canShowCallout = YES;
   

2. 可以通过 QMapView 的代理方法来创建自定义信息窗口：

   - (UIView *)mapView:(QMapView *)mapView customCalloutForAnnotationView:(QAnnotationView *)annotationView {
   
       if ([annotationView.annotation isKindOfClass:[QMUClusterAnnotation class]]) {
           UIView *view = [[UIView alloc] init];
           view.backgroundColor = [UIColor whiteColor];
           
           // 此处省略为信息窗口自定义代码，可在Demo中查看
           ......
           
           return view;
       }
   
       return nil;
   }
   

5. 自定义点聚合视图

• 在Demo中可以切换点聚合的默认样式和自定义样式，用户可以通过类似于Demo中的 BOOL isCustom 标记属性来控制样式：

  if (_isCustom) {
      // 自定义聚合视图
      annotationView.image = [UIImage imageNamed:@"hongbao"];
      annotationView.backgroundColor = [UIColor clearColor];
      annotationView.bounds = CGRectMake(0, 0, 30, 40);
  } else {
      // 默认聚合视图
      annotationView.bounds = CGRectMake(0, 0, self.manager.distance, self.manager.distance);
      annotationView.layer.cornerRadius = self.manager.distance / 2;
  }
  

注意点

1. 添加聚合点数据和视图之后，需要在合适的地方调用聚合管理者的 - (void)refreshCluster; 方法来刷新聚合，如地图视野发生改变时：

   - (void)mapView:(QMapView *)mapView regionDidChangeAnimated:(BOOL)animated gesture:(BOOL)bGesture
   {
       // 需要在合适的时机调用刷新接口，比如视野变动
       [self.manager refreshCluster];
   }
   
   

2. 如果聚合点数据处理较多，建议在子线程中做处理。

3. 如果需要移除聚合点，可以调用聚合管理者的 remove 和 clear 方法来移除，注意移除之后要调用刷新方法：

   // 移除原始被聚合点
   - (void)removeAnnotaion:(QMUAnnotation*)anno;
   // 移除批量的原始被聚合点
   - (void)removeAnnotations:(NSArray*)annos;
   // 移除所有的原始被聚合点
   - (void)clearAnnotations;