公共接口 LocationSource
定义用于提供位置数据(通常提供给 GoogleMap
对象)的接口。
GoogleMap
对象具有用于其“我的位置”图层的内置位置信息提供程序,但它可以是 replaced
,并可与其他实现此接口的提供程序搭配使用。
GoogleMap
对象使用 activate(OnLocationChangedListener)
激活其位置信息提供程序。处于活动状态时(在 activate(OnLocationChangedListener)
和 deactivate()
之间),位置信息提供程序应将定期位置信息更新推送到在 activate(OnLocationChangedListener)
中注册的监听器。提供程序需负责根据地图的生命周期状态明智地使用位置信息服务。例如,它应仅偶尔使用高耗电量服务(如 GPS),或仅在 activity 位于前台时使用。
嵌套类摘要
接口 | LocationSource.OnLocationChangedListener | 处理位置信息更新。 |
公共方法摘要
abstract void | |
abstract void |
deactivate()
停用此提供商。
|
公共方法
public abstract void activate (LocationSource.OnLocationChangedListener 监听器)
激活此提供方。此提供程序会定期通知所提供的监听器,直到您调用 deactivate()
。通知将在主线程上广播。
参数
监听器 | 在新位置可用时调用的监听器 |
---|
抛出
IllegalStateException | 如果此提供方已处于活动状态 |
---|---|
IllegalArgumentException | 如果 listener 为 null
|
public abstract void deactivate ()
停用此提供商。之前注册的回调不会收到任何进一步更新通知。
抛出
IllegalStateException | 如果此提供商已处于非活动状态 |
---|