LocationSource

公共接口 LocationSource

定义用于提供位置数据(通常提供给 GoogleMap 对象)的接口。

GoogleMap 对象具有用于其“我的位置”图层的内置位置信息提供程序,但它可以是 replaced,并可与其他实现此接口的提供程序搭配使用。

GoogleMap 对象使用 activate(OnLocationChangedListener) 激活其位置信息提供程序。处于活动状态时(在 activate(OnLocationChangedListener)deactivate() 之间),位置信息提供程序应将定期位置信息更新推送到在 activate(OnLocationChangedListener) 中注册的监听器。提供程序需负责根据地图的生命周期状态明智地使用位置信息服务。例如,它应仅偶尔使用高耗电量服务(如 GPS),或仅在 activity 位于前台时使用。

嵌套类摘要

接口 LocationSource.OnLocationChangedListener 处理位置信息更新。

公共方法摘要

abstract void
activate(LocationSource.OnLocationChangedListener 监听器)
激活此提供方。
abstract void
deactivate()
停用此提供商。

公共方法

public abstract void activate (LocationSource.OnLocationChangedListener 监听器)

激活此提供方。此提供程序会定期通知所提供的监听器,直到您调用 deactivate()。通知将在主线程上广播。

参数
监听器 在新位置可用时调用的监听器
抛出
IllegalStateException 如果此提供方已处于活动状态
IllegalArgumentException 如果 listenernull

public abstract void deactivate ()

停用此提供商。之前注册的回调不会收到任何进一步更新通知。

抛出
IllegalStateException 如果此提供商已处于非活动状态