TomTom地图标记不显示：自定义MarkerOptions类型后标记无法加载

我尝试在当前位置添加TomTom地图标记，最初的实现代码如下：

mapFragment.getMapAsync { tomtomMap: TomTomMap ->
            val loc:GeoPoint = tomtommap.currentLocation!!.position
            val markerOptions =
                MarkerOptions(
                    coordinate = loc,
                    tag = "Tag",
                    pinImage = ImageFactory.fromResource(R.drawable.children),
                    pinIconImage = ImageFactory.fromResource(R.drawable.children),
                )
            tomtomMap.addMarker(markerOptions)
        }

因为无法传入Image类型参数，我直接修改了MarkerOptions类的pinImage和pinIconImage属性类型，从Image/Image?改为Int：

修改后的MarkerOptions #

data class MarkerOptions(
    val coordinate: GeoPoint,
    val pinImage: Int,
    val pinIconImage:  Int,
    val shieldImage: Image? = null,
    val tag: String? = null,
    val label: Label? = null,
    val balloonText: String = ""
)

修改前的MarkerOptions #

data class MarkerOptions(
    val coordinate: GeoPoint,
    val pinImage: Image,
    val pinIconImage: Image? = null,
    val shieldImage: Image? = null,
    val tag: String? = null,
    val label: Label? = null,
    val balloonText: String = ""
)

现在标记完全无法在地图上显示，怀疑是修改属性类型导致的问题。

原因分析与解决方案 #

核心原因 #

TomTom地图SDK的Marker渲染逻辑依赖Image对象而非资源ID（Int），你直接修改属性类型后，SDK内部无法将Int类型的资源ID自动转换为可渲染的Image对象，因此标记无法正常显示。此外，原代码中存在变量名拼写错误：tomtommap应为tomtomMap（首字母大写M），这也可能导致获取当前位置失败，进而标记不显示。

正确解决步骤 #

不要修改SDK原生的MarkerOptions类，而是解决“无法传入Image类型参数”的问题：

1. 确保正确导入TomTom的ImageFactory类：import com.tomtom.sdk.ui.map.image.ImageFactory
2. 修正变量名拼写错误，避免空指针异常（不要直接用!!，改用let判空）
3. 使用ImageFactory.fromResource()将资源ID转换为Image对象后传入原生MarkerOptions

修正后的完整代码

mapFragment.getMapAsync { tomtomMap: TomTomMap ->
    // 安全获取当前位置，避免空指针
    tomtomMap.currentLocation?.let { location ->
        val loc: GeoPoint = location.position
        val markerImage = ImageFactory.fromResource(R.drawable.children)
        val markerOptions = MarkerOptions(
            coordinate = loc,
            tag = "Tag",
            pinImage = markerImage,
            pinIconImage = markerImage
        )
        tomtomMap.addMarker(markerOptions)
    }
}

若需自定义MarkerOptions（不推荐） #

如果因特殊需求必须保留自定义的MarkerOptions类，需要在添加标记时手动将Int资源ID转换为Image对象，再使用原生SDK的MarkerOptions添加：

// 自定义MarkerOptions实例
val customMarkerOptions = MarkerOptions(
    coordinate = loc,
    tag = "Tag",
    pinImage = R.drawable.children,
    pinIconImage = R.drawable.children
)

// 转换资源ID为Image对象
val pinImage = ImageFactory.fromResource(customMarkerOptions.pinImage)
val pinIconImage = ImageFactory.fromResource(customMarkerOptions.pinIconImage)

// 使用原生MarkerOptions添加标记
val nativeMarkerOptions = com.tomtom.sdk.ui.map.marker.MarkerOptions(
    coordinate = customMarkerOptions.coordinate,
    tag = customMarkerOptions.tag,
    pinImage = pinImage,
    pinIconImage = pinIconImage
)
tomtomMap.addMarker(nativeMarkerOptions)

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