Google Maps Android：仅缩放级别>15时高效显示千级Marker的非弃用方案

嘿，这个场景我太熟悉了——要在Google Maps Android上控制缩放级别高于15时显示上千个Marker，还要解决性能问题，之前的旧方案确实容易踩坑。我给你分享几个经过实践验证的高效方案，都是官方推荐或者业内常用的：

这是处理大量Marker最稳妥的方案，Google Maps Utils库提供的ClusterManager已经帮我们做了性能优化，比如Marker复用、视图回收，完全能应对上千个Marker的场景，还能轻松结合缩放级别控制。

实现思路： #

• 当地图缩放级别>15时，禁用聚类，显示单个Marker；
• 缩放级别≤15时，启用聚类，把邻近的Marker合并成一个聚类标记，减少渲染压力。

代码示例（Kotlin）： #

首先添加依赖（Gradle）：

implementation 'com.google.maps.android:android-maps-utils:2.2.0'

然后在onMapReady里初始化：

private lateinit var clusterManager: ClusterManager<MyMarkerItem>
private lateinit var googleMap: GoogleMap

override fun onMapReady(map: GoogleMap) {
    googleMap = map
    setupClusterManager()
    loadMarkerData()
}

private fun setupClusterManager() {
    clusterManager = ClusterManager(this, googleMap)
    
    // 监听相机 idle 事件，用来判断缩放级别
    googleMap.setOnCameraIdleListener {
        val currentZoom = googleMap.cameraPosition.zoom
        // 根据缩放级别自定义渲染逻辑
        clusterManager.renderer = object : DefaultClusterRenderer<MyMarkerItem>(this, googleMap, clusterManager) {
            override fun shouldRenderAsCluster(cluster: Cluster<MyMarkerItem>): Boolean {
                // 缩放>15时，不聚类，显示单个Marker；否则正常聚类
                return currentZoom <= 15 && cluster.size > 1
            }
        }
        // 触发聚类更新
        clusterManager.cluster()
    }
    
    // 把Marker点击事件交给ClusterManager处理
    googleMap.setOnMarkerClickListener(clusterManager)
}

private fun loadMarkerData() {
    // 模拟1000个Marker数据
    val markerItems = mutableListOf<MyMarkerItem>()
    repeat(1000) { index ->
        // 替换成你的真实坐标
        val lat = 39.9 + Math.random() * 0.2
        val lng = 116.3 + Math.random() * 0.2
        markerItems.add(MyMarkerItem(LatLng(lat, lng), "Marker $index"))
    }
    clusterManager.addItems(markerItems)
}

// 自定义数据类，实现ClusterItem接口
data class MyMarkerItem(
    private val position: LatLng,
    private val title: String
) : ClusterItem {
    override fun getPosition(): LatLng = position
    override fun getTitle(): String? = title
    override fun getSnippet(): String? = null
}

这个方案的优势是：ClusterManager会自动处理Marker的复用和内存管理，不会因为一次性加载上千个Marker导致UI卡顿或者内存溢出，而且缩放级别的控制逻辑清晰。

如果你的Marker是固定位置的（比如门店、景点这类静态数据），数量甚至超过几千个，那Tile Overlay会是更高效的选择。它的原理是预渲染地图瓦片（把Marker画在瓦片上），然后在地图上叠加这些瓦片，性能比单个Marker好太多，因为瓦片是批量加载和渲染的。

实现思路： #

• 提前用工具（比如Mapbox Studio、GDAL）把Marker渲染成对应缩放级别的瓦片；
• 监听地图缩放级别，当>15时加载瓦片叠加层，否则隐藏。

代码示例： #

private var tileOverlay: TileOverlay? = null

googleMap.setOnCameraIdleListener {
    val currentZoom = googleMap.cameraPosition.zoom
    if (currentZoom > 15) {
        if (tileOverlay == null) {
            val tileProvider = object : TileProvider {
                override fun getTile(x: Int, y: Int, zoom: Int): Tile? {
                    // 这里从本地assets或者服务器加载对应瓦片
                    return try {
                        val inputStream = assets.open("tiles/$zoom/$x/$y.png")
                        val tileBytes = inputStream.readBytes()
                        Tile(256, 256, tileBytes)
                    } catch (e: Exception) {
                        null // 瓦片不存在时返回null
                    }
                }
            }
            tileOverlay = googleMap.addTileOverlay(TileOverlayOptions().tileProvider(tileProvider))
        } else {
            tileOverlay?.isVisible = true
        }
    } else {
        tileOverlay?.isVisible = false
    }
}

• 复用Marker图标：不要每个Marker都创建新的BitmapDescriptor，提前缓存一个共用图标，减少内存消耗：

  val sharedMarkerIcon = BitmapDescriptorFactory.fromResource(R.drawable.your_marker_icon)
  

• 后台加载数据：如果Marker数据是从网络获取的，一定要在后台线程处理，避免阻塞UI；
• 避免不必要的Marker更新：只有当缩放级别确实变化时，才调整聚类或瓦片的显示状态，不要频繁触发更新。

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