Richiedere gli aggiornamenti di posizione

L'uso appropriato dei dati sulla posizione può essere utile per gli utenti della tua app. Ad esempio, se la tua app aiuta l'utente a trovare la strada mentre cammina o guida o se monitora la posizione degli asset, deve acquisire la posizione del dispositivo a intervalli regolari. Oltre alla posizione geografica (latitudine e longitudine), potresti voler fornire all'utente ulteriori informazioni, come il rilevamento (direzione di viaggio orizzontale), l'altitudine o la velocità del dispositivo. Queste informazioni e altre sono disponibili nell'oggetto Location che la tua app può recuperare dal Fused Location Provider. In risposta, l'API aggiorna periodicamente la tua app con la migliore posizione disponibile, in base ai provider di posizione attualmente disponibili, come Wi-Fi e sistema GPS. La precisione della posizione è determinata dai provider, dalle autorizzazioni di accesso alla posizione che hai richiesto e dalle opzioni impostate nella richiesta di accesso alla posizione.

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

Recupera l'ultima posizione nota

L'ultima posizione nota del dispositivo fornisce un punto di partenza utile, garantendo che l'app abbia una posizione nota prima di avviare gli aggiornamenti periodici della posizione. La lezione su come recuperare l'ultima posizione nota mostra come recuperare 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 gli aggiornamenti della posizione, l'app deve connettersi ai servizi di geolocalizzazione ed effettuare una richiesta di accesso alla posizione. La lezione sulla modifica delle impostazioni di localizzazione mostra come eseguire questa operazione. Una volta attiva una richiesta di posizione, puoi avviare gli aggiornamenti regolari chiamando requestLocationUpdates().

A seconda della forma della richiesta, il Fused Location Provider richiama il metodo di callback LocationCallback.onLocationResult() e gli passa un elenco di oggetti Location oppure emette un PendingIntent che contiene la posizione nei dati estesi. La precisione e la frequenza degli aggiornamenti sono influenzate dalle autorizzazioni di accesso alla posizione che hai richiesto e dalle opzioni impostate nell'oggetto della richiesta di accesso alla posizione.

Questa lezione mostra come ottenere l'aggiornamento utilizzando l'approccio di callback LocationCallback. Chiama requestLocationUpdates(), trasmetti l'istanza dell'oggetto LocationRequest e un LocationCallback. Definisci un metodo startLocationUpdates() come mostrato nell'esempio di codice seguente:

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

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

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

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

Tieni presente 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 posizione. Se gli utenti hanno disattivato gli aggiornamenti della posizione, puoi informarli dei requisiti per le località della tua app. Per saperne di più su come conservare il valore del flag booleano tra le istanze dell'attività, consulta Salva lo stato dell'attività.

Definisci il callback di aggiornamento della posizione

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

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
                // ...
            }
        }
    }
}

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 gli aggiornamenti della posizione

Valuta se interrompere gli aggiornamenti della posizione quando l'attività non è più attiva, ad esempio quando l'utente passa a un'altra app o a un'attività diversa nella stessa app. Questa opzione 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 nell'esempio di codice seguente:

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

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

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

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

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

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

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

Salva lo stato dell'attività

Una modifica alla configurazione del dispositivo, ad esempio un cambiamento dell'orientamento dello schermo o della lingua, può causare l'interruzione dell'attività corrente. L'app deve quindi memorizzare 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:

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

@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 nell'esempio di codice seguente:

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()
}

@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 documentazione di riferimento della classe Android Activity.

Nota: per un'archiviazione permanente, puoi memorizzare le preferenze dell'utente nel file SharedPreferences dell'app. Imposta la preferenza condivisa nel metodo onPause() della tua attività e recuperala in onResume(). Per saperne di più sul salvataggio delle preferenze, consulta Salvataggio dei set di coppie chiave-valore.

Risorse aggiuntive

Per saperne di più, consulta le seguenti risorse:

Esempi

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