Richiedere gli aggiornamenti di posizione

L'uso appropriato delle informazioni sulla posizione può essere utile agli utenti della tua app. Ad esempio, se la tua app aiuta l'utente a orientarsi mentre cammina o guida oppure se la tua app monitora la posizione degli asset, deve recuperare la posizione del dispositivo a intervalli regolari. Oltre alla posizione geografica (latitudine e longitudine), potresti voler fornire all'utente ulteriori informazioni quali la direzione (orientamento orizzontale), l'altitudine o la velocità del dispositivo. Queste informazioni, e altro ancora, sono disponibili nell'oggetto Location che l'app può recuperare dal provider di posizione con fusibile. Di conseguenza, l'API aggiorna periodicamente l'app con la migliore posizione disponibile, in base ai provider di localizzazione attualmente disponibili, come Wi-Fi e GPS (Global Positioning System). La precisione della posizione è determinata dai fornitori, dalle autorizzazioni di accesso alla posizione richieste e dalle opzioni impostate nella richiesta di posizione.

Questa lezione mostra come richiedere aggiornamenti regolari sulla posizione di un dispositivo utilizzando il metodo requestLocationUpdates() nel provider di posizione fuso.

Ottenere l'ultima posizione nota

L'ultima posizione nota del dispositivo fornisce una pratica base da cui iniziare, garantendo che l'app abbia una posizione nota prima di avviare gli aggiornamenti periodici della posizione. La lezione Ottenere l'ultima posizione nota mostra come ottenere l'ultima posizione nota chiamando getLastLocation(). Gli snippet nelle sezioni seguenti presuppongono che la tua app abbia già recuperato l'ultima posizione nota e l'abbia archiviata come oggetto Location nella variabile globale mCurrentLocation.

Invia una richiesta di posizione

Prima di richiedere aggiornamenti della posizione, l'app deve connettersi ai servizi di geolocalizzazione ed effettuare una richiesta di posizione. Nella lezione sulla modifica delle impostazioni di geolocalizzazione viene spiegato come eseguire questa operazione. Una volta effettuata la richiesta di posizione, puoi avviare gli aggiornamenti regolari chiamando il numero requestLocationUpdates().

A seconda della forma della richiesta, il provider della località fusa richiama il metodo di callback LocationCallback.onLocationResult() e lo passa un elenco di Location oggetti oppure emette un PendingIntent contenente la località nei suoi dati estesi. La precisione e la frequenza degli aggiornamenti dipendono dalle autorizzazioni di accesso alla posizione richieste e dalle opzioni impostate nell'oggetto richiesta di posizione.

Questa lezione spiega come ricevere l'aggiornamento utilizzando l'approccio di callback di LocationCallback. Richiama requestLocationUpdates(), passando la tua istanza dell'oggetto LocationRequest e poi LocationCallback. Definisci un metodo startLocationUpdates() come mostrato nel seguente esempio di codice:

Kotlin

override fun onResume() {
    super.onResume()
    if (requestingLocationUpdates) startLocationUpdates()
}

private fun startLocationUpdates() {
    fusedLocationClient.requestLocationUpdates(locationRequest,
            locationCallback,
            Looper.getMainLooper())
}

Java

@Override
protected void onResume() {
    super.onResume();
    if (requestingLocationUpdates) {
        startLocationUpdates();
    }
}

private void startLocationUpdates() {
    fusedLocationClient.requestLocationUpdates(locationRequest,
            locationCallback,
            Looper.getMainLooper());
}

Nota che lo snippet di codice riportato sopra fa riferimento a un flag booleano, requestingLocationUpdates, utilizzato per monitorare se l'utente ha attivato o disattivato gli aggiornamenti della località. Se gli utenti hanno disattivato gli aggiornamenti della località, puoi informarli dei requisiti relativi alle località della tua app. Per ulteriori informazioni su come conservare il valore del flag booleano nelle istanze dell'attività, consulta Salvare lo stato dell'attività.

Definisci il callback per l'aggiornamento della località

Il provider della posizione incorporata richiama il metodo di callback LocationCallback.onLocationResult(). L'argomento in entrata contiene un oggetto elenco Location contenente la latitudine e la longitudine della località. Il seguente snippet mostra come implementare l'interfaccia LocationCallback e definire il metodo, poi ottenere il timestamp dell'aggiornamento della posizione e visualizzare la latitudine, la longitudine e il timestamp nell'interfaccia utente dell'app:

Kotlin

private lateinit var locationCallback: LocationCallback

// ...

override fun onCreate(savedInstanceState: Bundle?) {
    // ...

    locationCallback = object : LocationCallback() {
        override fun onLocationResult(locationResult: LocationResult?) {
            locationResult ?: return
            for (location in locationResult.locations){
                // Update UI with location data
                // ...
            }
        }
    }
}

Java

private LocationCallback locationCallback;

// ...

@Override
protected void onCreate(Bundle savedInstanceState) {
    // ...

    locationCallback = new LocationCallback() {
        @Override
        public void onLocationResult(LocationResult locationResult) {
            if (locationResult == null) {
                return;
            }
            for (Location location : locationResult.getLocations()) {
                // Update UI with location data
                // ...
            }
        }
    };
}

Interrompi aggiornamenti posizione

Valuta se vuoi interrompere gli aggiornamenti della posizione quando l'attività non è più attiva, ad esempio quando l'utente passa a un'altra app o a un'altra attività nella stessa app. Questo può essere utile per ridurre il consumo di energia, a condizione che l'app non debba raccogliere informazioni anche quando è in esecuzione in background. Questa sezione mostra come interrompere gli aggiornamenti nel metodo onPause() dell'attività.

Per interrompere gli aggiornamenti della posizione, chiama removeLocationUpdates(), passando un LocationCallback, come mostrato nel seguente esempio di codice:

Kotlin

override fun onPause() {
    super.onPause()
    stopLocationUpdates()
}

private fun stopLocationUpdates() {
    fusedLocationClient.removeLocationUpdates(locationCallback)
}

Java

@Override
protected void onPause() {
    super.onPause();
    stopLocationUpdates();
}

private void stopLocationUpdates() {
    fusedLocationClient.removeLocationUpdates(locationCallback);
}

Utilizza un valore booleano, requestingLocationUpdates, per monitorare se gli aggiornamenti della località sono attualmente attivati. Nel metodo onResume() dell'attività, controlla se gli aggiornamenti della posizione sono attualmente attivi e attivali in caso contrario:

Kotlin

override fun onResume() {
    super.onResume()
    if (requestingLocationUpdates) startLocationUpdates()
}

Java

@Override
protected void onResume() {
    super.onResume();
    if (requestingLocationUpdates) {
        startLocationUpdates();
    }
}

Salva lo stato dell'attività

Una modifica alla configurazione del dispositivo, ad esempio una modifica dell'orientamento dello schermo o della lingua, può causare l'eliminazione dell'attività corrente. L'app deve quindi archiviare tutte le informazioni necessarie per ricreare l'attività. Un modo per farlo è tramite uno stato dell'istanza archiviato in un oggetto Bundle.

Il seguente esempio di codice mostra come utilizzare il callback onSaveInstanceState() dell'attività per salvare lo stato dell'istanza:

Kotlin

override fun onSaveInstanceState(outState: Bundle?) {
    outState?.putBoolean(REQUESTING_LOCATION_UPDATES_KEY, requestingLocationUpdates)
    super.onSaveInstanceState(outState)
}

Java

@Override
protected void onSaveInstanceState(Bundle outState) {
    outState.putBoolean(REQUESTING_LOCATION_UPDATES_KEY,
            requestingLocationUpdates);
    // ...
    super.onSaveInstanceState(outState);
}

Definisci un metodo updateValuesFromBundle() per ripristinare i valori salvati dall'istanza precedente dell'attività, se disponibili. Chiama il metodo dal metodo onCreate() dell'attività, come mostrato nel seguente esempio di codice:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    // ...
    updateValuesFromBundle(savedInstanceState)
}

private fun updateValuesFromBundle(savedInstanceState: Bundle?) {
    savedInstanceState ?: return

    // Update the value of requestingLocationUpdates from the Bundle.
    if (savedInstanceState.keySet().contains(REQUESTING_LOCATION_UPDATES_KEY)) {
        requestingLocationUpdates = savedInstanceState.getBoolean(
                REQUESTING_LOCATION_UPDATES_KEY)
    }

    // ...

    // Update UI to match restored state
    updateUI()
}

Java

@Override
public void onCreate(Bundle savedInstanceState) {
    // ...
    updateValuesFromBundle(savedInstanceState);
}

private void updateValuesFromBundle(Bundle savedInstanceState) {
    if (savedInstanceState == null) {
        return;
    }

    // Update the value of requestingLocationUpdates from the Bundle.
    if (savedInstanceState.keySet().contains(REQUESTING_LOCATION_UPDATES_KEY)) {
        requestingLocationUpdates = savedInstanceState.getBoolean(
                REQUESTING_LOCATION_UPDATES_KEY);
    }

    // ...

    // Update UI to match restored state
    updateUI();
}

Per saperne di più sul salvataggio dello stato dell'istanza, consulta la sezione relativa al riferimento della classe Attività Android.

Nota: per un'archiviazione più permanente, puoi archiviare le preferenze dell'utente nelle SharedPreferences dell'app. Imposta la preferenza condivisa nel metodo onPause() della tua attività e recupera la preferenza in onResume(). Per ulteriori informazioni sul salvataggio delle preferenze, consulta la pagina Salvataggio di insiemi di valori-chiave.

Risorse aggiuntive

Per saperne di più, consulta le seguenti risorse:

Campioni

  • App di esempio per dimostrare la ricezione di aggiornamenti della posizione in Android.