Swift中如何在Google Map集群管理器添加带IconView的标记

你遇到的核心问题是：Google Maps的GMUClusterManager默认渲染器只会处理GMSMarker的icon属性，不会识别iconView，所以你设置了自定义iconView的标记无法被集群管理器正确展示。下面是针对性的解决方案：

问题根源 #

GMUDefaultClusterRenderer在生成集群标记或单个标记时，只会从GMUClusterItem中提取位置、名称这类基础信息，然后创建默认的GMSMarker，不会继承你手动设置的iconView。要让集群管理器支持自定义视图标记，我们需要自定义渲染逻辑。

解决方案步骤 #

1. 扩展POIItem存储必要数据 #

先让你的POIItem能存储关联自定义视图所需的关键信息（推荐存数据而非直接存视图，避免内存冗余）：

class POIItem: NSObject, GMUClusterItem {
    var position: CLLocationCoordinate2D
    var name: String
    var itemId: String // 存储数据ID，用来匹配对应的addressWindow
    
    init(position: CLLocationCoordinate2D, name: String, itemId: String) {
        self.position = position
        self.name = name
        self.itemId = itemId
        super.init()
    }
}

2. 自定义集群渲染器 #

创建继承自GMUDefaultClusterRenderer的类，重写renderMarker方法，在这里为每个标记绑定自定义iconView：

class CustomClusterRenderer: GMUDefaultClusterRenderer {
    override func renderMarker(_ marker: GMSMarker) {
        super.renderMarker(marker)
        
        // 从标记的userData中获取关联的POIItem
        guard let item = marker.userData as? POIItem else { return }
        
        // 根据itemId加载对应的addressWindow视图
        let addressWindow = self.loadCustomAddressWindow(for: item.itemId)
        
        // 清空默认icon，确保iconView生效（Google Maps优先使用icon属性）
        marker.icon = nil
        marker.iconView = addressWindow
    }
    
    // 封装加载XIB视图的逻辑
    private func loadCustomAddressWindow(for itemId: String) -> UIView {
        // 替换成你加载addressWindow XIB的实际代码
        let window = Bundle.main.loadNibNamed("AddressWindow", owner: nil, options: nil)?.first as! UIView
        // 可根据itemId设置视图上的动态内容（比如地址文本）
        return window
    }
}

3. 修改集群管理器初始化与标记添加逻辑 #

初始化集群管理器时指定自定义渲染器，同时调整循环代码，把必要数据传入POIItem：

// 初始化集群管理器组件
let iconGenerator = GMUDefaultClusterIconGenerator()
let algorithm = GMUNonHierarchicalDistanceBasedAlgorithm()
// 使用自定义渲染器
let renderer = CustomClusterRenderer(mapView: yourMapView, clusterIconGenerator: iconGenerator)
let clusterManager = GMUClusterManager(map: yourMapView, algorithm: algorithm, renderer: renderer)

// 遍历数据添加集群项
for i in 0..<dataArr.count {
    guard let latitudeStr = dataArr[i].lat,
          let longitudeStr = dataArr[i].longs,
          let doubleLat = Double(latitudeStr),
          let doubleLong = Double(longitudeStr),
          let itemId = dataArr[i].id else { continue }
    
    let position = CLLocationCoordinate2D(latitude: doubleLat, longitude: doubleLong)
    let name = "Item \(i)"
    
    // 创建带itemId的POIItem
    let item = POIItem(position: position, name: name, itemId: itemId)
    clusterManager.add(item)
    
    // 存储数据（保持你原有逻辑）
    clusterDataArr.setValue(itemId, forKey: name)
}

// 执行集群计算与渲染
clusterManager.cluster()

关键注意事项 #

• 必须清空marker.icon，否则iconView不会被Google Maps优先使用。
• 自定义渲染器中，marker.userData会被自动关联到对应的POIItem，可以通过它获取数据来动态配置视图内容。
• 如果每个标记的addressWindow内容不同，一定要在loadCustomAddressWindow方法中根据itemId设置对应的内容。

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