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 in Google Maps, l'app può offrire recuperi dinamici e report monofunzionali dei dati sulla corsa di un conducente.

Questa guida presenta un progetto Android Studio, mostra come integrare l'SDK di navigazione, quindi mostra come eseguire le applicazioni demo.

L'SDK di navigazione è una libreria statica che ti consente di controllare l'aspetto e l'audio per la navigazione nella tua app. Per maggiori dettagli sulla libreria, apri Riferimento SDK di navigazione (Javadoc) in una finestra separata.

Operazioni preliminari

Per iniziare a utilizzare l'SDK di navigazione, assicurati di avere i seguenti elementi.

  • Un rappresentante di Google Maps Platform che ha accesso 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 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 versioni precedenti. Se non puoi utilizzare Maven, puoi scaricare l'elemento compresso dal Google Drive condiviso. Il file della libreria statico è 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 agli utenti che hanno familiarità con lo sviluppo di Android e i concetti di programmazione orientata agli oggetti. Dovresti già conoscere Google Maps dal punto di vista dell'utente.

Scarica le app demo

A seconda del tuo livello di esperienza, Google offre due app per aiutarti a comprendere cosa offre l'SDK di navigazione oltre alle API di Google Maps. Gli sviluppatori che hanno familiarità con le API di Google Maps possono concentrare l'attenzione sulla demo di GoogleNavigatore. Gli sviluppatori che non hanno mai usato entrambi i progetti troveranno utili entrambe le app.

A partire dall'SDK Navigation for Android v4.1, le seguenti app demo sono disponibili per il download nel Google Drive condiviso.

  • Demo di GoogleNavigatore: mostra l'integrazione delle visualizzazioni e dei comportamenti 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.

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 di configurazione del progetto per ottenere l'accesso all'SDK.

Demo di GoogleNavigazione

L'ultima demo di GoogleNavigator è disponibile nella directory principale del Google Drive condiviso. Le versioni precedenti dell'app sono disponibili in "Archivio". Per le versioni precedenti alla 4.1, l'app viene integrata insieme all'AAR nello stesso file ZIP.

Costruiamo

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

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

      MAPS_API_KEY=YOUR_API_KEY

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

    • Nella classe Java, prendi nota del codice di implementazione.

    • Prendi nota del design e del testo del layout nel file XML di 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 relativa al plug-in Secrets Gradle.

Attivo

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

    • Dispositivo Android: consulta le instructions per attivare le opzioni sviluppatore sul dispositivo Android e configurare il sistema in modo che rilevi il dispositivo.
    • Emulatore: usa Gestione dispositivi virtuali (AVD) Android per configurare un dispositivo virtuale. Quando scegli un emulatore, accertati 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.

Per i nuovi utenti del NavSDK queste due opzioni saranno probabilmente le 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, verranno visualizzate le seguenti informazioni:

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

Per iniziare, fai clic su Imposta destinazione e scegli un indirizzo. L'app simula quindi un viaggio dalla tua posizione attuale 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'attivazione dell'SDK in modalità notturna e vedere come appare.

Opzione SwitchingMapAndNavActivity

SwappingMapAndNavActivity mostra i seguenti pattern comuni:

Demo di Google Maps

L'ultima demo di GoogleNavigator è disponibile nella directory principale del Google Drive condiviso. Le versioni precedenti dell'app sono disponibili in "Archivio".

Costruiamo

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

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

      MAPS_API_KEY=YOUR_API_KEY

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

    • Nella classe Java, prendi nota del codice di implementazione.

    • Prendi nota del design e del testo del layout nel file XML di layout.

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

Consulta l'articolo sul plug-in gradle di secret per avere ulteriori informazioni su come la chiave API viene aggiunta al manifest.

Attivo

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

    • Dispositivo Android Consulta le instructions per attivare le opzioni sviluppatore sul tuo dispositivo Android e configurare il tuo sistema per il rilevamento del dispositivo.
    • Emulatore Usa Gestione dispositivi virtuali Android (AVD) per configurare un dispositivo virtuale. Quando scegli un emulatore, accertati 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 demo.

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

Generalmente Google incoraggia gli utenti a utilizzare NavigationView. Questa demo offre la flessibilità di provare questi comportamenti in entrambe le versioni della nostra app demo e di scegliere quella più adatta a voi. Ad esempio, potrebbe essere comunque necessario utilizzare MapView nei casi in cui utilizzi una libreria di terze parti che prevede di interagire con il corso.