Google consiglia di utilizzare le API di posizione e contesto in Google Play Services nelle app che richiedono servizi di geolocalizzazione. Se la tua app utilizza le API di geolocalizzazione del framework, è importante eseguire la migrazione a Google Play Services per usufruire delle funzionalità più recenti di Google.
L'utilizzo di Google Play Services è l'opzione preferita per ottenere servizi di localizzazione nella tua app per i seguenti motivi:
- Google Play Services fornisce un'interfaccia semplice e una superficie API più pulita.
- Specifichi la qualità del servizio che vuoi e le API gestiscono le tecnologie sottostanti per te.
- Le API di Google Play Services sono ottimizzate per le prestazioni e l'utilizzo della batteria.
- Le API di Google Play Services vengono gestite attivamente. Google migliora costantemente gli algoritmi e aggiunge nuove funzionalità.
Aggiorna la tua app
I passaggi seguenti descrivono la procedura per aggiornare un'app in modo che utilizzi le API di posizione e contesto:
- Configura Google Play Services nel tuo progetto.
- Utilizza l'API delle impostazioni di localizzazione per convalidare le impostazioni di localizzazione attuali.
- Utilizza Google Play Services per funzionalità complesse come geofencing, riconoscimento attività e awareness.
- Sostituisci l'utilizzo dell'API di geolocalizzazione del framework con l'API del provider di posizione fusa.
- Rimuovi i riferimenti all'API di geolocalizzazione del framework.
Configura Google Play Services nel tuo progetto
Per rendere disponibili le API di posizione e contesto per il tuo progetto, devi aggiungere un riferimento al repository Maven di Google e dichiarare una dipendenza dalle API richieste. Per saperne di più, consulta Configura Google Play Services.
Utilizza l'API delle impostazioni di geolocalizzazione
Utilizzando l'API delle impostazioni di localizzazione, le app forniscono il livello di QoS di cui hanno bisogno e l'API richiede all'utente le modifiche appropriate alle impostazioni di sistema. Per utilizzare l'API delle impostazioni di localizzazione nella tua app, segui questi passaggi:
- Richiedi le autorizzazioni di accesso alla posizione nel file manifest dell'app.
- Configura un oggetto
LocationRequest, che specifica il livello di QoS che vuoi. - Utilizza l'API delle impostazioni di localizzazione per controllare le impostazioni attuali.
Per saperne di più, consulta Modifica delle impostazioni di localizzazione o consulta gli esempi di posizione di Google Play per il codice di esempio.
Utilizza Google Play Services per funzionalità complesse
Le librerie di Google Play Services ti aiutano a implementare nuove esperienze utente basate sul contesto e sulla consapevolezza dell'ambiente circostante dell'utente. Le varie librerie di posizione e contesto sfruttano sensori aggiuntivi oltre alla posizione e lo fanno in modo efficiente dal punto di vista energetico, fornendo alla tua app dati più accurati e riducendo al contempo l'impatto sulla durata della batteria.
Incorpora queste librerie nella tua app anziché scrivere soluzioni personalizzate:
Sostituisci l'API di geolocalizzazione del framework con l'API del provider di geolocalizzazione integrata
Puoi utilizzare l'API del provider di posizione integrato per ottenere dati sulla posizione, come latitudine e longitudine. L'API Fused Location Provider utilizza un oggetto Location, proprio come l'API Location Framework, per rappresentare la posizione geografica. L'API fornisce funzionalità per ascoltare gli aggiornamenti della posizione e per ottenere l'ultima posizione nota. Tutte queste funzionalità rendono l'API Fused Location Provider un buon candidato per sostituire i componenti che utilizzano l'API di geolocalizzazione del framework con modifiche minime al resto dell'app.
Ottenere l'ultima posizione nota è un buon punto di partenza per molte esperienze perché si tratta di un'operazione rapida che utilizza i dati sulla posizione richiesti da qualsiasi client sul dispositivo. Per monitorare periodicamente la posizione, la tua app può registrarsi per ricevere aggiornamenti sulla posizione, che forniscono dati aggiornati e consentono esperienze più complesse.
Rimuovi i riferimenti all'API di geolocalizzazione del framework
Sostituisci i riferimenti alle classi nel pacchetto com.google.android.location con le classi del pacchetto com.google.android.gms.location, ad eccezione dei riferimenti alla classe Location, utilizzata dall'API del provider di geolocalizzazione integrata. In genere, puoi rimuovere dall'app i componenti che gestiscono i diversi provider, come GPS e Wi-Fi. Le API di posizione e contesto gestiscono automaticamente questi provider.
Testa la tua app
Per eseguire un'app che utilizza l'ultima versione di Google Play Services, devi avere un dispositivo su cui è installata l'app Play Store e devi aver eseguito l'accesso a un Account Google. Per scopi di sviluppo, puoi utilizzare le seguenti opzioni:
- Un dispositivo fisico collegato all'ambiente di sviluppo tramite un cavo USB.
- Un emulatore con l'app Play Store installata.
Per ulteriori informazioni sulla connessione di un dispositivo fisico al tuo ambiente di sviluppo, consulta Esegui app su un dispositivo hardware. Per creare un emulatore che include l'app Play Store, consulta Crea e gestisci dispositivi virtuali.