Definisce un'interfaccia per fornire dati sulla posizione, generalmente a un oggetto GoogleMap.
Un oggetto GoogleMap ha un provider di posizione integrato per il livello my-location, ma può essere replaced con un altro che implementa questa interfaccia.
Un oggetto GoogleMap attiva il proprio provider di località utilizzando activate(OnLocationChangedListener). Quando è attivo (tra activate(OnLocationChangedListener) e deactivate()), un provider di servizi di localizzazione deve eseguire il push
degli aggiornamenti periodici della posizione per il listener registrato in activate(OnLocationChangedListener). È responsabilità del provider utilizzare i servizi di geolocalizzazione in modo appropriato, in base allo stato del ciclo di vita della mappa. Ad esempio, i servizi che consumano molta batteria (come il GPS) dovrebbero essere utilizzati solo occasionalmente o solo quando un'attività è in primo piano.
Riepilogo dei corsi nidificati
| interfaccia | LocationSource.OnLocationChangedListener | Gestisce un aggiornamento della posizione. | |
Riepilogo del metodo pubblico
| astratto void | |
| astratto void |
deactivate()
Disattiva questo provider.
|
Metodi pubblici
Public abstract void activate (LocationSource.OnLocationChangedListener)
Attiva questo fornitore. Questo provider avviserà periodicamente il listener fornito, finché non chiamerai deactivate(). Le notifiche verranno trasmesse sul thread principale.
Parametri
| listener | che viene chiamato quando è disponibile una nuova posizione |
|---|
Tiri
| IllegalStateException | se questo provider è già attivo |
|---|---|
| IllegalArgumentException | se listener è null
|
pubblici abstract void disattiva ()
Disattiva questo provider. Il callback registrato in precedenza non riceve alcuna notifica di ulteriori aggiornamenti.
Tiri
| IllegalStateException | se il provider è già inattivo |
|---|