Prova la demo

Integrando l'SDK di navigazione per Android, la tua app può andare oltre il collegamento a una visualizzazione mappa esterna. Con la navigazione di Google Maps, la tua app può offrire recupero dinamico e report con un'unica visualizzazione dei dati sul percorso dell'utente. Questa guida illustra come eseguire le app demo dell'SDK per la navigazione, disponibili su GitHub.

Nota: l'SDK di navigazione è attualmente disponibile solo per clienti selezionati e devi abilitarlo per eseguire le app demo. Per maggiori informazioni, contatta il team di vendita.

Operazioni preliminari

Importante: a partire dalla versione 3.0 dell'SDK di navigazione per Android, puoi ottenere la versione più recente dell'SDK di navigazione per Android dal nostro Repository Maven. Questo è il metodo preferito per scaricare l'SDK. Per maggiori informazioni, consulta Configurare il progetto.

Per iniziare a utilizzare l'SDK di navigazione, assicurati di disporre dei seguenti elementi.

• Un rappresentante di Google Maps Platform per accedere a quanto segue:

  • Una chiave API di cui è stato eseguito il provisioning per l'utilizzo con l'SDK di navigazione. Devi fornire il tuo ID progetto, che puoi trovare nella dashboard principale della console Google Cloud, sotto il nome del progetto.
  • L'artefatto dell'SDK. Assicurati che il progetto sia configurato per l'utilizzo di Maven per l'SDK di navigazione.
  • Per i progetti che utilizzano la versione 4.99.0 e precedenti. Se non puoi utilizzare Maven, puoi scaricare l'elemento compresso dal Google Drive condiviso. Il file della libreria statica è il file .aar nella directory libs/ contenente l'SDK di navigazione come pacchetto AAR.
  • Una o più app demo.
  • Android Studio, l'ambiente di sviluppo consigliato per creare un'app con l'SDK di navigazione.

Questa documentazione è rivolta alle persone che hanno familiarità con lo sviluppo Android e concetti di programmazione orientata agli oggetti. Dovresti anche conoscere Google Maps dal punto di vista dell'utente.

Nota: se la tua app utilizza già l'SDK Maps, l'SDK di navigazione sostituisce l'SDK Maps sia per il livello della mappa che per le funzionalità di navigazione. Non puoi utilizzare l'SDK di navigazione e l'SDK di Maps nella stessa app.

Scarica le app demo

Google mette a disposizione due app per aiutarti a capire cosa offre l'SDK di navigazione in aggiunta alle API di Google Maps, a seconda del tuo livello di esperienza. Gli sviluppatori che conoscono le API di Google Maps possono concentrare la loro attenzione sulla demo di GoogleNavigator. Gli sviluppatori che utilizzano entrambi i progetti troveranno utili entrambe le app.

A partire dall'SDK di navigazione per Android v4.1, su GitHub sono entrambe disponibili per il download le seguenti app demo.

• Demo di navigazione di Google: mostra l'integrazione dei comportamenti e delle visualizzazioni dell'API in relazione all'esperienza dell'utente durante una sessione di navigazione guidata.

• Demo di GoogleMap: mostra i singoli comportamenti dell'interfaccia di GoogleMap per personalizzare l'aspetto e la presentazione delle mappe.

Una nota sull'utilizzo di Maven

Le app demo sono configurate per scaricare l'artefatto SDK dal repository Maven remoto utilizzando il plug-in Artifact Registry in Gradle. Assicurati di seguire le istruzioni per la configurazione del progetto per ottenere l'accesso all'SDK.

Nota: per le versioni 4.99.0 e precedenti, se vuoi comunque utilizzare il bundle AAR non elaborato nel progetto, puoi aggiungerlo al progetto nella directory libs. Dovrai quindi rimuovere tutti i riferimenti al plug-in artifactregistry e al rispettivo repository remoto e dichiarare la seguente dipendenza AAR nell'elemento build.gradle a livello di app: api(name: 'google_navigation', ext: 'aar')

Demo di GoogleNavigator

L'ultima demo di GoogleNavigator è disponibile su GitHub.

In fase di creazione

1. In Android Studio, importa l'app demo e consenti l'esecuzione di Gradle.

   Nota: l'app non carica la mappa finché non aggiorni local.defaults.properties con la chiave API di cui è stato eseguito il provisioning.

2. Apri local.defaults.properties e aggiorna il valore della proprietà MAPS_API_KEY:

     MAPS_API_KEY=YOUR_API_KEY
   

3. Fai clic su Crea ed esamina i dettagli di implementazione dell'SDK.

   • Nella classe Java, annotare il codice di implementazione.

   • Nel file XML di layout, controlla il testo e la progettazione del layout.

   • Nel file build.gradle, nota l'SDK nelle dipendenze.

Per ulteriori informazioni su come la chiave API viene aggiunta al manifest, consulta la documentazione del plug-in di Secrets Gradle.

In esecuzione

1. Collega un dispositivo Android al computer o utilizza un emulatore.

   • Dispositivo Android: consulta le instructions per attivare le opzioni per sviluppatori sul tuo dispositivo Android e configurare il sistema in modo che rilevi il dispositivo.
   • Emulatore; utilizza il Gestore di dispositivi virtuali (AVD) Android per configurare un dispositivo virtuale. Quando scegli un emulatore, assicurati di scegliere un'immagine che includa le API di Google.

2. In Android Studio, fai clic sull'opzione di menu Esegui (o sull'icona del pulsante di riproduzione), quindi scegli una destinazione per il deployment.

Una volta creata e lanciata, l'app presenta all'utente una pagina di destinazione con un elenco di opzioni.

Opzioni NavViewActivity e NavFragmentActivity

I nuovi utenti di NavSDK troveranno probabilmente queste due opzioni più utili.

Opzione 1: NavViewActivity mostra i comportamenti utilizzando NavigationView insieme a Navigator.

Opzione 2: la seconda opzione, denominata NavFragmentActivity, mostra i comportamenti utilizzando SupportNavigationFragment insieme a Navigator.

Quando fai clic su una di queste opzioni, visualizzerai quanto segue:

• l'interfaccia utente di navigazione
• Un pulsante "Imposta destinazione" nel menu dell'app
• un overlay con cui puoi interagire per richiamare in modo dinamico i metodi sull'API
• un menu extra con altre opzioni

Per iniziare, fai clic su Imposta destinazione e scegli un indirizzo. L'app quindi simula un viaggio dalla tua posizione corrente a quell'indirizzo. Utilizza l'overlay dei pannelli di controllo per vedere cosa succede quando chiami un'API. Ad esempio, puoi fare clic su Visualizza metodi per provare a forzare l'SDK in modalità notturna e vedere che aspetto ha.

Opzione SwappingMapAndNavActivity

Nota: questa opzione ti assiste nella transizione dalla versione 1 alla versione 4. Invitiamo a utilizzare NavigationView esclusivamente ove possibile, ma forniamo questo esempio su come utilizzarli insieme.

SwappingMapAndNavActivity mostra i seguenti pattern comuni:

• mostra un elemento MapView
• passando a una NavigationView quando inizia la navigazione
• tornando a una MapView al termine della navigazione

Demo di Google Maps

Nota: questa app non è disponibile per le versioni dell'SDK precedenti alla 4.1.

L'ultima demo di GoogleNavigator è disponibile su GitHub.

In fase di creazione

1. In Android Studio, importa l'app demo e consenti l'esecuzione di Gradle.

   Nota: l'app non caricherà la mappa finché non aggiorni local.defaults.properties con la chiave API di cui è stato eseguito il provisioning.

2. Apri local.defaults.properties e aggiorna il valore della proprietà MAPS_API_KEY:

     MAPS_API_KEY=YOUR_API_KEY
   

3. Fai clic su Crea ed esamina i dettagli di implementazione dell'SDK.

   • Nella classe Java, annotare il codice di implementazione.

   • Nel file XML di layout, controlla il testo e la progettazione del layout.

   • Nel file build.gradle, nota l'SDK nelle dipendenze.

Per ulteriori informazioni su come la chiave API viene aggiunta al file manifest, consulta il plug-in secrets gradle.

In esecuzione

1. Collega un dispositivo Android al computer o utilizza un emulatore.

   • Dispositivo Android Consulta le instructions per attivare le opzioni per sviluppatori sul tuo dispositivo Android e configurare il tuo sistema in modo che possa rilevare il dispositivo.
   • Emulatore Utilizza il Gestione dispositivi virtuali (AVD) Android per configurare un dispositivo virtuale. Quando scegli un emulatore, assicurati di scegliere un'immagine che includa le API di Google.

2. In Android Studio, fai clic sull'opzione di menu Esegui (o sull'icona del pulsante di riproduzione), quindi scegli una destinazione per il deployment.

Una volta creata e lanciata, l'app presenta all'utente una pagina di destinazione di un elenco di demo.

Questo pattern di presentazione e la corrispondente struttura del codice sorgente devono essere familiari agli utenti delle demo di Google Maps SDK. Questo perché la demo di GoogleMap è progettata per essere simile all'app demo dell'API di Google Maps. La differenza principale è che la demo di SDK di navigazione consente all'utente di scegliere la classe di visualizzazione su cui desidera testare ed eseguire una demo: NavigationView o MapView, dove applicabile.

In genere Google incoraggia gli utenti che adottano a utilizzare NavigationView. Questa demo offre la flessibilità di provare questi comportamenti su entrambe le versioni nella nostra app demo e scegliere quello più adatto a te. Ad esempio, potrebbe comunque essere necessario utilizzare MapView in situazioni in cui utilizzi una libreria di terze parti che prevede di interagire con quel corso.

Importante: le classi MapView, MapFragment e SupportMapFragment richiedono l'installazione dell'applicazione Google Play Services sui dispositivi. Se avvii un nuovo emulatore o ripristini i dati di fabbrica di un dispositivo molto vecchio, l'immagine Android potrebbe essere preinstallata su Google Play Services molto obsoleta. In questi casi, devi attendere che esegua automaticamente il pull di una versione più recente o aggiornare manualmente Play Services tramite il Google Play Store.