嘿，这个问题我之前也碰到过！其实核心原因是Kotlin里val和var的区别，加上MarkerOptions本身的Builder模式设计导致的，咱们一步步来解决：

为什么会报错？ #

你尝试用markerOptions!!.icon = ...这种写法时，会触发两个问题：

1. markerOptions是val类型的参数：在Kotlin中，val代表只读变量，你不能重新给这个变量赋值新的对象，也不能直接修改它的“属性字段”（如果这个属性没有开放可写权限的话）。
2. MarkerOptions的icon是通过方法设置的：它采用Builder模式设计，没有公开可直接赋值的icon字段，必须调用它的icon()方法来设置图标。

正确的实现方式 #

不管是自定义单个标记的图标，还是聚类组的图标，都要通过MarkerOptions的icon()方法来设置，下面是完整的示例代码：

1. 自定义ClusterRenderer类 #

class CustomClusterRenderer(
    private val context: Context,
    map: GoogleMap,
    clusterManager: ClusterManager<YourClusterItem>
) : DefaultClusterRenderer<YourClusterItem>(context, map, clusterManager) {

    // 自定义单个标记的图标
    override fun onBeforeClusterItemRendered(item: YourClusterItem, markerOptions: MarkerOptions) {
        // 加载自定义标记图标（可以是资源文件，也可以是Bitmap）
        val customMarkerIcon = BitmapDescriptorFactory.fromResource(R.drawable.your_custom_marker)
        // 调用icon()方法设置，而不是直接赋值
        markerOptions.icon(customMarkerIcon)
        // 还可以链式设置其他属性
        markerOptions.title(item.title)
            .snippet(item.snippet)
    }

    // 自定义聚类组的图标（比如带数字的聚合图标）
    override fun onBeforeClusterRendered(cluster: Cluster<YourClusterItem>, markerOptions: MarkerOptions) {
        // 生成带聚类数量的自定义图标
        val clusterIcon = createClusterIconWithCount(cluster.size)
        markerOptions.icon(clusterIcon)
    }

    // 生成带数字的聚类图标（示例）
    private fun createClusterIconWithCount(count: Int): BitmapDescriptor {
        // 加载背景图
        val backgroundBitmap = BitmapFactory.decodeResource(context.resources, R.drawable.cluster_bg)
        // 创建可编辑的Bitmap副本
        val editableBitmap = backgroundBitmap.copy(Bitmap.Config.ARGB_8888, true)
        val canvas = Canvas(editableBitmap)

        // 设置绘制数字的Paint参数
        val textPaint = Paint().apply {
            color = Color.WHITE
            textSize = 45f
            textAlign = Paint.Align.CENTER
            isAntiAlias = true
            typeface = Typeface.DEFAULT_BOLD
        }

        // 计算文字绘制位置（居中）
        val xPos = editableBitmap.width / 2f
        val yPos = editableBitmap.height / 2f - (textPaint.descent() + textPaint.ascent()) / 2f

        // 绘制数字
        canvas.drawText(count.toString(), xPos, yPos, textPaint)

        return BitmapDescriptorFactory.fromBitmap(editableBitmap)
    }
}

2. 在Activity/Fragment中初始化ClusterManager和Renderer #

// 初始化ClusterManager
val clusterManager = ClusterManager<YourClusterItem>(this, googleMap)
// 设置自定义Renderer
val customRenderer = CustomClusterRenderer(this, googleMap, clusterManager)
clusterManager.renderer = customRenderer

// 向ClusterManager添加聚类数据
clusterManager.addItems(yourClusterItemList)
// 绑定地图事件
googleMap.setOnCameraIdleListener(clusterManager)
googleMap.setOnMarkerClickListener(clusterManager)

关键要点总结 #

• 永远不要尝试直接给markerOptions变量重新赋值（比如markerOptions = MarkerOptions()），因为它是val类型。
• 所有MarkerOptions的属性（包括icon、title、snippet等）都要通过它的对应方法来设置（比如icon()、title()），这是Builder模式的标准用法。
• 如果需要动态生成图标（比如带数字的聚类图标），可以通过Canvas绘制Bitmap，再转成BitmapDescriptor传入icon()方法。

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