Google consiglia di utilizzare le API di posizione e contesto in Google Play Services nelle app che richiedono servizi di localizzazione. 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 basate su Google.
L'utilizzo di Google Play Services è l'opzione preferita per ottenere i servizi di localizzazione nella tua app per i seguenti motivi:
- Google Play Services fornisce un'interfaccia semplice e una superficie API più pulita.
- Specifichi una qualità del servizio desiderata e le API gestiscono le tecnologie sottostanti per te.
- Le API dei servizi Google Play sono ottimizzate per le prestazioni e l'utilizzo della batteria.
- Le API Google Play Services vengono gestite attivamente. Google migliora costantemente gli algoritmi e aggiunge nuove funzionalità.
Aggiorna la tua app
I seguenti passaggi 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 il geofencing, il riconoscimento dell'attività e la consapevolezza.
- Sostituisci l'utilizzo dell'API per la posizione del framework con l'API del fornitore di servizi di localizzazione combinata.
- Rimuovi i riferimenti all'API di localizzazione del framework.
Configurare Google Play Services nel progetto
Per rendere disponibili le API di localizzazione e contesto per il tuo progetto, devi aggiungere un riferimento al repository Maven di Google e dichiarare una dipendenza dalle API richieste. Per maggiori informazioni, vedi Configurare i servizi Google Play.
Utilizzare l'API delle impostazioni di localizzazione
Utilizzando l'API delle impostazioni di localizzazione, le app forniscono il livello di QoS desiderato e l'API richiede all'utente le modifiche appropriate alle impostazioni di sistema. Segui questi passaggi per utilizzare l'API delle impostazioni di localizzazione nella tua app:
- Richiedi le autorizzazioni di accesso alla posizione nel manifest dell'app.
- Configura un oggetto
LocationRequest, che specifica il livello di QoS desiderato. - Utilizza l'API delle impostazioni di localizzazione per controllare le impostazioni attuali.
Per ulteriori informazioni, vedi Modifica delle impostazioni di geolocalizzazione o consulta gli esempi di geolocalizzazione di Google Play per il codice di esempio.
Utilizzare Google Play Services per funzionalità complesse
Le librerie dei servizi Google Play 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ù precisi e riducendo l'impatto sulla durata della batteria.
Incorpora queste librerie nella tua app anziché scrivere soluzioni personalizzate tue:
Sostituisci l'API di localizzazione del framework con l'API Fused Location Provider
Puoi utilizzare l'API Fused Location Provider per ottenere dati sulla posizione, come
latitudine e longitudine. L'API Fused Location Provider utilizza un oggetto Location, proprio come l'API framework di localizzazione, 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 Location del framework con modifiche minime al
resto dell'app.
Recuperare l'ultima posizione nota è un buon punto di partenza per molte esperienze, perché è un'operazione rapida che utilizza i dati sulla posizione richiesti da qualsiasi client sul dispositivo. Per monitorare periodicamente la posizione, la tua app può iscriversi per ricevere aggiornamenti sulla posizione, che fornisce dati aggiornati e consente esperienze più complesse.
Rimuovere i riferimenti all'API Location 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 Fused Location Provider. In genere puoi rimuovere dalla tua app i componenti che
gestiscono i diversi fornitori, come GPS e Wi-Fi. Le
API per la posizione e il contesto gestiscono automaticamente questi fornitori.
Testare l'app
Per eseguire un'app che utilizza l'ultima versione di Google Play Services, devi disporre di un dispositivo con l'app Play Store installata e devi aver eseguito l'accesso a un Account Google. Per lo sviluppo, puoi utilizzare le seguenti opzioni:
- Un dispositivo fisico connesso all'ambiente di sviluppo tramite un cavo USB.
- Un emulatore con l'app Play Store installata.
Per ulteriori informazioni su come connettere un dispositivo fisico all'ambiente di sviluppo, vedi Eseguire app su un dispositivo hardware. Per creare un emulatore che includa l'app Play Store, consulta Creare e gestire dispositivi virtuali.