如何在Xamarin Forms iOS地图渲染器中实现MKCreateClusterAnnotation聚类视图

前置要求 #

你的自定义大头针类必须实现IMKClusterable接口，MapKit才会将其纳入聚类逻辑：

public class CustomPin : MKPointAnnotation, IMKClusterable
{
    public int Id { get; set; }
    // 其他自定义属性（如标题、副标题等）
}

修复渲染器初始化代码 #

原代码中CreateClusterAnnotation的赋值方式错误，需直接绑定方法而非调用方法：

if (e.NewElement != null)
{
    var formsMap = (InitMap)e.NewElement;
    var nativeMap = Control as MKMapView;
    customPins = formsMap.InitCustomPins;
    
    nativeMap.GetViewForAnnotation = GetViewForAnnotation;
    // 绑定聚类标注创建方法，不要加()
    nativeMap.CreateClusterAnnotation = CreateClusterAnnotation;
}

实现聚类标注创建方法 #

CreateClusterAnnotation是MapKit触发聚类时的核心回调，在这里我们可以根据成员大头针的Id对聚类进行标识：

private MKClusterAnnotation CreateClusterAnnotation(MKMapView mapView, IMKAnnotation[] memberAnnotations)
{
    // 判断当前聚类是否包含Id=1的大头针
    bool containsId1 = memberAnnotations.Any(anno => anno is CustomPin pin && pin.Id == 1);
    
    var clusterAnnotation = new MKClusterAnnotation(memberAnnotations);
    // 用Subtitle存储聚类标识，后续设置样式时使用
    clusterAnnotation.Subtitle = containsId1 ? "group-id1" : "group-other";
    // 设置聚类标题为成员数量
    clusterAnnotation.Title = memberAnnotations.Length.ToString();
    
    return clusterAnnotation;
}

完善标注视图获取方法 #

修改GetViewForAnnotation，区分普通大头针和聚类标注，分别设置样式：

protected override MKAnnotationView GetViewForAnnotation(MKMapView mapView, IMKAnnotation annotation)
{
    MKAnnotationView annotationView = null;

    // 跳过用户位置标注
    if (annotation is MKUserLocation)
        return null;

    // 处理聚类标注
    if (annotation is MKClusterAnnotation clusterAnno)
    {
        const string reuseId = "ClusterPin";
        // 复用标注视图提升性能
        annotationView = mapView.DequeueReusableAnnotation(reuseId) as MKMarkerAnnotationView 
            ?? new MKMarkerAnnotationView(clusterAnno, reuseId);

        var markerView = (MKMarkerAnnotationView)annotationView;
        // 根据聚类标识设置气泡颜色
        if (clusterAnno.Subtitle == "group-id1")
        {
            markerView.MarkerTintColor = UIColor.Red;
        }
        else
        {
            markerView.MarkerTintColor = UIColor.SystemBlue; // 其他聚类默认颜色
        }
        // 显示聚类成员数量
        markerView.GlyphText = clusterAnno.MemberAnnotations.Length.ToString();
        markerView.DisplayPriority = MKFeatureDisplayPriority.DefaultHigh;

        return annotationView;
    }

    // 处理普通自定义大头针
    var customPin = annotation as CustomPin;
    if (customPin == null)
        return null;

    const string reuseId = "CustomPin";
    annotationView = mapView.DequeueReusableAnnotation(reuseId) as MKMarkerAnnotationView 
        ?? new MKMarkerAnnotationView(customPin, reuseId);

    annotationView.CanShowCallout = true;
    // 可选：给单个Id=1的大头针也设置红色气泡
    if (customPin.Id == 1)
    {
        ((MKMarkerAnnotationView)annotationView).MarkerTintColor = UIColor.Red;
    }

    return annotationView;
}

关键说明 #

1. 聚类触发前提：自定义大头针必须实现IMKClusterable，否则MapKit不会启动聚类逻辑
2. 聚类分组逻辑：通过CreateClusterAnnotation识别聚类内的大头针ID，为不同组的聚类打上标识
3. 性能优化：始终使用DequeueReusableAnnotation复用标注视图，避免频繁创建新视图导致性能问题
4. 样式区分：在GetViewForAnnotation中根据聚类标识设置不同的气泡颜色，实现按ID分组的视觉区分

内容的提问来源于stack exchange，提问作者Pxaml