Define una interfaz para proporcionar datos de ubicación, generalmente a un objeto GoogleMap.
Un objeto GoogleMap tiene un proveedor de ubicación integrado para su capa my-location, pero puede ser replaced con otro que implemente esta interfaz.
Un objeto GoogleMap activa su proveedor de ubicación mediante activate(OnLocationChangedListener). Mientras está activo (entre activate(OnLocationChangedListener) y deactivate()), un proveedor de ubicación debe enviar actualizaciones de ubicación periódicas al objeto de escucha registrado en activate(OnLocationChangedListener). El proveedor debe usar los servicios de ubicación de forma inteligente, según el estado del ciclo de vida del mapa. Por ejemplo, solo debería usar servicios que consumen mucha batería (como GPS) de vez en cuando o cuando una actividad se ejecuta en primer plano.
Resumen de clases anidadas
| Interfaz | LocationSource.OnLocationChangedListener | Controla una actualización de ubicación. | |
Resumen de métodos públicos
| abstract void | |
| abstract void |
deactivate()
Desactiva este proveedor.
|
Métodos públicos
público abstracto void activar (objeto de escucha LocationSource.OnLocationChangedListener)
Activa este proveedor. Este proveedor notificará al objeto de escucha proporcionado de forma periódica, hasta que llames a deactivate(). Las notificaciones se transmitirán en la conversación principal.
Parámetros
| objeto de escucha | objeto de escucha que se llama cuando hay una nueva ubicación disponible |
|---|
Arroja
| IllegalStateException | si este proveedor ya está activo |
|---|---|
| IllegalArgumentException | si listener es null
|
public resumen void desactivar ()
Desactiva este proveedor. La devolución de llamada registrada anteriormente no recibirá notificaciones de más actualizaciones.
Arroja
| IllegalStateException | si este proveedor ya está inactivo |
|---|