Compose中GoogleMap的locationSource属性使用疑问及正确用法

核心本质 #

locationSource是GoogleMap组件和自定义位置数据源之间的官方绑定通道，核心作用是让Map自动管理位置监听的生命周期，同时将你的位置数据同步到Map的内置定位蓝点上——这和你自己手动处理位置逻辑是完全两码事。

你的两个问题拆解 #

1. 为什么自定义MyLocationSourceImpl的activate没被自动调用？
   只有满足两个条件，GoogleMap才会主动调用绑定的LocationSource的activate：

   • 必须将你的MyLocationSourceImpl赋值给GoogleMap的locationSource属性；
   • 必须开启myLocationEnabled = true（开启Map的定位蓝点显示）。
     此时Map会自动传入它内部的LocationSource.OnLocationChangedListener——这个Listener是用来更新Map上的定位蓝点的，不是你手动指定的自定义Listener。

2. 为什么手动调用activate不配置locationSource也能工作？
   你手动调用的是自己实现的activate逻辑，本质是让你的位置数据源给你自己的Listener发送位置数据，这和GoogleMap的内置定位功能完全无关。你只是在独立处理位置逻辑，Map本身并没有接入你的数据源，比如你看不到Map上的定位蓝点（或者蓝点用的是系统默认的位置服务）。

什么时候需要用locationSource？ #

• 当你需要用自定义位置数据源驱动Map的定位蓝点时：比如你不用系统的FusedLocationProvider，而是自己实现了位置服务，或者需要对位置数据做预处理（平滑、过滤、模拟位置）后再显示到Map上；
• 当你想让Map自动管理位置监听的生命周期：比如Map组件不可见（Compose导航到其他页面）时，GoogleMap会自动调用deactivate停止监听，避免耗电；当Map回到前台时，又会自动调用activate恢复监听，不用你自己写生命周期判断逻辑。

正确用法示例 #

// 自定义LocationSource，绑定Map的定位蓝点更新
class MyLocationSourceImpl(private val customLocationProvider: CustomLocationProvider) : LocationSource {
    private var mapListener: LocationSource.OnLocationChangedListener? = null

    override fun activate(listener: LocationSource.OnLocationChangedListener) {
        mapListener = listener
        // 启动自定义位置服务，并将位置传给Map的Listener
        customLocationProvider.startListening { location ->
            mapListener?.onLocationChanged(location)
        }
    }

    override fun deactivate() {
        mapListener = null
        customLocationProvider.stopListening()
    }
}

// Compose中集成
GoogleMap(
    modifier = Modifier.fillMaxSize(),
    myLocationEnabled = true, // 必须开启，触发Map的位置监听逻辑
    locationSource = remember { MyLocationSourceImpl(customLocationProvider) }
)

内容的提问来源于stack exchange，提问作者lolo.io