MapBox v10 Android（Java）找不到OnMapClickListener的解决方案咨询

问题背景 #

在MapBox v9版本中，我们可以通过以下代码处理地图点击事件：

mapBoxMap.addOnMapClickListener(OnMapClicked);

升级到v10版本后，Java代码中找不到上述旧用法，仅能找到Kotlin示例，需要对应的Java实现方案。

解决方案 #

MapBox v10对Java的点击事件API做了调整，现在需要通过MapboxMap.OnMapClickListener接口来实现，提供两种常用实现方式：

方式一：让Activity/Fragment实现接口

让承载地图的Activity或Fragment直接实现MapboxMap.OnMapClickListener接口，在接口方法中处理点击逻辑：

public class MapActivity extends AppCompatActivity implements MapboxMap.OnMapClickListener {
    private MapView mapView;
    private MapboxMap mapboxMap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_map);

        mapView = findViewById(R.id.mapView);
        mapView.onCreate(savedInstanceState);

        // 加载地图样式，完成后设置点击监听器
        mapView.getMapboxMap().loadStyleUri(Style.MAPBOX_STREETS, style -> {
            mapboxMap = mapView.getMapboxMap();
            // 绑定点击监听器
            mapboxMap.addOnMapClickListener(MapActivity.this);
        });
    }

    // 实现点击事件处理方法
    @Override
    public boolean onMapClick(@NonNull Point point) {
        // 获取点击的经纬度坐标
        double lat = point.latitude();
        double lng = point.longitude();
        Toast.makeText(this, "点击坐标：" + lat + ", " + lng, Toast.LENGTH_SHORT).show();
        
        // 返回true表示已处理事件，false则事件会继续传递
        return true;
    }

    // 处理MapView生命周期，避免内存泄漏
    @Override
    protected void onStart() {
        super.onStart();
        mapView.onStart();
    }

    @Override
    protected void onResume() {
        super.onResume();
        mapView.onResume();
    }

    @Override
    protected void onPause() {
        super.onPause();
        mapView.onPause();
    }

    @Override
    protected void onStop() {
        super.onStop();
        mapView.onStop();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        // 移除监听器
        if (mapboxMap != null) {
            mapboxMap.removeOnMapClickListener(this);
        }
        mapView.onDestroy();
    }
}

方式二：使用匿名内部类

如果不想让组件实现接口，也可以通过匿名内部类快速绑定点击事件：

// 确保在样式加载完成后执行
mapboxMap.addOnMapClickListener(new MapboxMap.OnMapClickListener() {
    @Override
    public boolean onMapClick(@NonNull Point point) {
        // 自定义点击逻辑
        Toast.makeText(MapActivity.this, "地图被点击", Toast.LENGTH_SHORT).show();
        return true;
    }
});

关键注意点 #

• 必须在地图样式加载完成（loadStyleUri的回调内）后设置点击监听器，否则可能出现空指针异常
• onMapClick方法返回布尔值：返回true表示事件已被处理，不会再向下传递；返回false则事件会继续传递给其他监听器
• 在组件销毁时记得移除监听器，避免内存泄漏

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