Android中如何借助Cluster Manager修改Google Map标记的可见性？

嘿，我太懂这种痛点了——3000+标记直接挨个改可见性，那卡顿感简直酸爽！Cluster Manager就是专门解决这种大量标记场景的利器，我来给你捋捋怎么用它高效实现复选框控制标记显示/隐藏：

核心思路 #

Cluster Manager的本质是管理ClusterItem数据对象，而非直接操作Marker。所以我们不需要再手动维护Marker列表，而是通过控制哪些ClusterItem被渲染，来实现标记的显示/隐藏，这种方式是批量优化过的，性能比直接操作单个Marker强太多。

步骤1：自定义带属性的ClusterItem #

首先给你的ClusterItem添加关键属性（比如对应复选框的类别），方便后续根据复选框状态过滤。比如：

public class MyClusterItem implements ClusterItem {
    private final LatLng mPosition;
    private final String mTitle;
    private final String mCategory; // 标记所属类别，对应复选框选项

    public MyClusterItem(LatLng position, String title, String category) {
        mPosition = position;
        mTitle = title;
        mCategory = category;
    }

    @Override
    public LatLng getPosition() { return mPosition; }
    @Override
    public String getTitle() { return mTitle; }
    @Override
    public String getSnippet() { return null; }

    // 获取类别用于筛选
    public String getCategory() { return mCategory; }
}

步骤2：自定义ClusterRenderer控制渲染逻辑 #

我们需要重写默认的ClusterRenderer，核心是通过isClusterItemVisible()方法判断哪些Item需要被渲染。这样当复选框状态变化时，只需要更新筛选条件，Renderer会自动处理渲染：

public class MyClusterRenderer extends DefaultClusterRenderer<MyClusterItem> {
    private Set<String> mSelectedCategories = new HashSet<>();

    public MyClusterRenderer(Context context, GoogleMap map, ClusterManager<MyClusterItem> clusterManager) {
        super(context, map, clusterManager);
    }

    // 更新选中的类别集合
    public void updateSelectedCategories(Set<String> selected) {
        mSelectedCategories.clear();
        mSelectedCategories.addAll(selected);
        notifyDataSetChanged(); // 通知重新渲染地图
    }

    // 核心：判断当前Item是否需要显示
    @Override
    protected boolean isClusterItemVisible(MyClusterItem item) {
        // 选中集合为空时显示所有标记，否则只显示选中类别的标记
        return mSelectedCategories.isEmpty() || mSelectedCategories.contains(item.getCategory());
    }

    // 可选：自定义标记样式（比如不同类别用不同图标）
    @Override
    protected void onBeforeClusterItemRendered(MyClusterItem item, MarkerOptions markerOptions) {
        super.onBeforeClusterItemRendered(item, markerOptions);
        if ("restaurant".equals(item.getCategory())) {
            markerOptions.icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_RED));
        } else if ("park".equals(item.getCategory())) {
            markerOptions.icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_GREEN));
        }
    }
}

步骤3：初始化ClusterManager并绑定地图 #

把ClusterManager和自定义Renderer绑定到Google Map上，同时加载所有标记数据：

// 初始化ClusterManager
ClusterManager<MyClusterItem> mClusterManager = new ClusterManager<>(this, mMap);
// 设置自定义Renderer
MyClusterRenderer mRenderer = new MyClusterRenderer(this, mMap, mClusterManager);
mClusterManager.setRenderer(mRenderer);

// 把地图的相机空闲事件和标记点击事件交给ClusterManager处理（可选，用于聚类交互）
mMap.setOnCameraIdleListener(mClusterManager);
mMap.setOnMarkerClickListener(mClusterManager);

// 加载所有标记数据到ClusterManager
List<MyClusterItem> allItems = new ArrayList<>();
// 遍历数据库数据，创建ClusterItem并添加
for (YourLocationData data : yourDatabaseDataList) {
    LatLng latLng = new LatLng(data.getLatitude(), data.getLongitude());
    MyClusterItem item = new MyClusterItem(latLng, data.getName(), data.getCategory());
    allItems.add(item);
}
mClusterManager.addItems(allItems);
// 触发初始聚类
mClusterManager.cluster();

步骤4：处理复选框交互 #

当用户点击复选框时，更新选中的类别集合，然后通知Renderer重新渲染：

// 示例：处理单个复选框的状态变化
checkBoxRestaurant.setOnCheckedChangeListener((buttonView, isChecked) -> {
    updateVisibleMarkers();
});

checkBoxPark.setOnCheckedChangeListener((buttonView, isChecked) -> {
    updateVisibleMarkers();
});

// 统一更新选中类别并通知渲染
private void updateVisibleMarkers() {
    Set<String> selectedCategories = new HashSet<>();
    if (checkBoxRestaurant.isChecked()) {
        selectedCategories.add("restaurant");
    }
    if (checkBoxPark.isChecked()) {
        selectedCategories.add("park");
    }
    // 其他复选框同理...
    mRenderer.updateSelectedCategories(selectedCategories);
}

额外优化点 #

• 动态添加新标记：当数据库扩容新增标记时，只需要创建新的MyClusterItem，调用mClusterManager.addItem(newItem)，ClusterManager会自动处理聚类和渲染，完全不用手动管理Marker。
• 聚类阈值调整：如果觉得聚类太频繁或太稀疏，可以通过mClusterManager.setMinClusterSize(int size)调整聚类的最小数量。

这种方式的优势在于，所有标记的管理和渲染都是ClusterManager批量处理的，它会自动优化地图上的绘制元素数量（比如把相邻标记聚合成一个聚类标记），比你之前挨个操作Marker的方式效率提升N倍，就算标记涨到几万条也能保持流畅。

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