Se usi le API di geolocalizzazione di Google Play Services, la tua app può richiedere l'ultima posizione nota del dispositivo dell'utente. Nella maggior parte dei casi, ti interessa la posizione attuale dell'utente, che di solito equivale all'ultima posizione nota del dispositivo.
In particolare, utilizza il provider di posizione integrato per recuperare l'ultima posizione nota del dispositivo. Il provider di posizione fuso è una delle API di geolocalizzazione in Google Play Services. Gestisce la tecnologia di localizzazione sottostante e fornisce un'API semplice in modo da poter specificare requisiti ad alto livello, come alta precisione o bassa potenza. Ottimizza inoltre l'utilizzo della batteria del dispositivo.
Nota: quando l'app è in esecuzione in background, l'accesso alla posizione deve essere fondamentale per la funzionalità di base dell'app ed è accompagnato da un'informativa adeguata agli utenti.
Questa lezione mostra come effettuare una singola richiesta per la posizione di un
dispositivo utilizzando il metodo
getLastLocation()
nel provider di posizione combinato.
Configurare Google Play Services
Per accedere al fornitore di posizione fuso, il progetto di sviluppo della tua app deve includere Google Play Services. Scarica e installa il componente Google Play Services tramite SDK Manager e aggiungi la libreria al tuo progetto. Per maggiori dettagli, consulta la guida alla configurazione di Google Play Services.
Specifica le autorizzazioni app
Le app le cui funzionalità utilizzano i servizi di geolocalizzazione devono richiedere le autorizzazioni di accesso alla posizione, a seconda dei casi d'uso di queste funzionalità.
Crea client dei servizi di geolocalizzazione
Nel metodo onCreate()
della tua attività,
crea un'istanza del client del provider di località Fused come mostrato nello snippet di codice riportato di seguito.
Kotlin
private lateinit var fusedLocationClient: FusedLocationProviderClient override fun onCreate(savedInstanceState: Bundle?) { // ... fusedLocationClient = LocationServices.getFusedLocationProviderClient(this) }
Java
private FusedLocationProviderClient fusedLocationClient; // .. @Override protected void onCreate(Bundle savedInstanceState) { // ... fusedLocationClient = LocationServices.getFusedLocationProviderClient(this); }
Visualizza l'ultima posizione nota
Una volta creato il client dei servizi di geolocalizzazione, puoi ottenere l'ultima posizione nota del dispositivo di un utente. Quando la tua app è
connessa a questi dispositivi, puoi utilizzare il metodo
getLastLocation()
del fornitore di posizione integrato per recuperare la posizione del dispositivo. La precisione della posizione restituita da questa chiamata è determinata dall'impostazione di autorizzazione che inserisci nel file manifest dell'app, come descritto nella guida su come richiedere le autorizzazioni di accesso alla posizione.
Per richiedere l'ultima posizione nota, chiama il metodo
getLastLocation()
. Il seguente snippet di codice illustra la richiesta e una semplice gestione della
risposta:
Kotlin
fusedLocationClient.lastLocation .addOnSuccessListener { location : Location? -> // Got last known location. In some rare situations this can be null. }
Java
fusedLocationClient.getLastLocation() .addOnSuccessListener(this, new OnSuccessListener<Location>() { @Override public void onSuccess(Location location) { // Got last known location. In some rare situations this can be null. if (location != null) { // Logic to handle location object } } });
Il metodo getLastLocation()
restituisce un Task
che puoi utilizzare per ottenere un oggetto Location
con le coordinate di latitudine e longitudine di una posizione geografica. L'oggetto location può essere null
nelle
seguenti situazioni:
- La geolocalizzazione è disattivata nelle impostazioni del dispositivo. Il risultato potrebbe essere
null
anche se l'ultima posizione è stata recuperata in precedenza, perché la disattivazione della posizione comporta anche la cancellazione della cache. - Il dispositivo non ha mai registrato la sua posizione, come nel caso di un nuovo dispositivo o di un dispositivo ripristinato alle impostazioni di fabbrica.
- Google Play Services sul dispositivo è stato riavviato e non è presente alcun client Fused Location Provider attivo che abbia richiesto la posizione dopo il riavvio dei servizi. Per evitare questa situazione, puoi creare un nuovo client e richiedere aggiornamenti della posizione autonomamente. Per ulteriori informazioni, consulta la sezione Ricezione di aggiornamenti sulla posizione.
Scegli la stima della località migliore
FusedLocationProviderClient
offre diversi metodi per recuperare le informazioni sulla posizione del dispositivo. Scegli una delle seguenti opzioni, a seconda del caso d'uso della tua app:
getLastLocation()
ottiene una stima della posizione più rapidamente e riduce al minimo l'utilizzo della batteria che può essere attribuito alla tua app. Tuttavia, le informazioni sulla posizione potrebbero non essere aggiornate se nessun altro client ha utilizzato attivamente la posizione di recente.getCurrentLocation()
riceve una posizione più aggiornata e precisa in modo più coerente. Tuttavia, questo metodo può causare il calcolo della posizione attiva sul dispositivoQuesto è il modo consigliato per ottenere una nuova posizione, quando possibile, ed è più sicuro rispetto ad alternative come l'avvio e la gestione degli aggiornamenti della posizione autonomamente utilizzando
requestLocationUpdates()
. Se la tua app chiamarequestLocationUpdates()
, a volte l'app può consumare grandi quantità di energia se la posizione non è disponibile o se la richiesta non viene interrotta correttamente dopo aver ottenuto una nuova posizione.
Risorse aggiuntive
Per ulteriori informazioni sul recupero della posizione attuale in Android, visualizza i seguenti materiali:
Campioni
- App di esempio per dimostrare le best practice durante il recupero della posizione attuale.