Android中Mapbox调用addMarker方法出现IDE标红的问题

问题情况 #

调用addMarker时IDE标红无法使用，相关代码和依赖如下：

问题代码 #

private fun onMapReady() {
        mapView.getMapboxMap().setCamera(
            CameraOptions.Builder()
                .zoom(14.0)
                .build()
        )
        mapView.getMapboxMap().loadStyleUri(
            Style.MAPBOX_STREETS
        ) {
            initLocationComponent()
            setupGesturesListener()
        }

        val icon = IconFactory.getInstance(requireContext()).fromResource(R.drawable.ic_marker_uchebnoye)
        val marker = mapView.getMapboxMap().addMarker(
            MarkerOptions()
                .position(LatLng(51.50550, -0.07520))
                .icon(icon)
                .title("MarkerName")
                .snippet("MarkerDescription")
        )
    }

当前依赖配置 #

implementation 'com.mapbox.mapboxsdk:mapbox-android-sdk:9.0.0'
implementation 'com.mapbox.mapboxsdk:mapbox-sdk-services:5.8.0'
implementation 'com.mapbox.mapboxsdk:mapbox-sdk-geojson:5.8.0'
implementation 'com.mapbox.mapboxsdk:mapbox-sdk-turf:5.8.0'
implementation 'com.mapbox.mapboxsdk:mapbox-sdk-plugins:5.8.0'
implementation 'com.mapbox.mapboxsdk:mapbox-android-plugin-annotation-v9:0.9.0'

问题原因 #

1. Mapbox Android SDK 9.x版本中，MapboxMap类本身没有提供addMarker方法，必须通过Annotation Plugin来实现标记添加。
2. 代码调用时机错误——标记需要在地图样式加载完成后添加，否则会因地图未初始化完成导致异常。

解决步骤 #

1. 调整代码到样式加载回调内 #

把添加标记的逻辑移到loadStyleUri的回调Lambda中，确保地图样式加载完成后再执行标记操作。

2. 使用Annotation Plugin的API添加标记 #

通过MarkerManager来管理标记，修改后的代码如下：

private fun onMapReady() {
    mapView.getMapboxMap().setCamera(
        CameraOptions.Builder()
            .zoom(14.0)
            .build()
    )
    mapView.getMapboxMap().loadStyleUri(Style.MAPBOX_STREETS) { style ->
        initLocationComponent()
        setupGesturesListener()

        // 初始化MarkerManager
        val markerManager = MarkerManager(mapView, mapView.getMapboxMap(), style)
        val icon = IconFactory.getInstance(requireContext()).fromResource(R.drawable.ic_marker_uchebnoye)
        
        // 创建Marker并添加到管理器
        val marker = Marker(
            MarkerOptions()
                .position(LatLng(51.50550, -0.07520))
                .icon(icon)
                .title("MarkerName")
                .snippet("MarkerDescription")
        )
        markerManager.addMarker(marker)
    }
}

3. 确认导入正确的类 #

确保导入的是Annotation Plugin对应的类：

import com.mapbox.mapboxsdk.plugins.annotation.Marker
import com.mapbox.mapboxsdk.plugins.annotation.MarkerManager
import com.mapbox.mapboxsdk.plugins.annotation.MarkerOptions

4. 清理IDE缓存 #

如果修改后IDE仍标红，执行File -> Invalidate Caches / Restart，清理缓存后重新同步项目。

内容的提问来源于stack exchange，提问作者Илья Сергиенко