Prova la demo

Se integri l'SDK Navigation per Android, la tua app può andare oltre il collegamento a una visualizzazione della 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.

Operazioni preliminari

Per iniziare a utilizzare l'SDK Navigation, assicurati di disporre degli elementi riportati di seguito.

  • Una chiave API di cui è stato eseguito il provisioning per l'utilizzo con l'SDK Navigation. Per ulteriori informazioni sulla creazione e sulla limitazione delle chiavi, consulta la sezione Utilizzo delle chiavi API.
  • L'elemento dell'SDK. Assicurati che il progetto sia configurato per utilizzare Maven per l'SDK di navigazione.
  • Una o più app di demo.
  • Android Studio, l'ambiente di sviluppo consigliato per creare un'app con l'SDK Navigation.

Questa documentazione è progettata per chi ha dimestichezza con lo sviluppo Android e con i concetti di programmazione orientata agli oggetti. Dovresti anche conoscere Google Maps dal punto di vista dell'utente.

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 Google Navigation. Gli sviluppatori che non hanno mai utilizzato entrambi i progetti troveranno utili entrambe le app.

A partire dalla versione 4.1 dell'SDK Navigation per Android, le seguenti app di dimostrazione sono disponibili per il download su GitHub.

  • 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 Google Maps: mostra i singoli comportamenti dell'interfaccia GoogleMap per personalizzare l'aspetto e la presentazione delle mappe.

La demo di GoogleNavigation

L'ultima demo di GoogleNavigator è disponibile su GitHub.

Edificio

  1. In Android Studio, importa l'app di 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 Crea ed esamina i dettagli di implementazione dell'SDK.

    • Nella classe Java, annotare il codice di implementazione.

    • Nel file XML del layout, prendi nota del design e del testo del layout.

    • Nel file build.gradle, prendi nota dell'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 istruzioni per attivare le Opzioni sviluppatore sul dispositivo Android e configurare il sistema in modo che rilevi il dispositivo.
    • Emulatore: utilizza Gestione AVD (Android Virtual Device) 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.

I nuovi utenti di NavSDK probabilmente troveranno queste due opzioni 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, visualizzerai quanto segue:

  • l'interfaccia utente di navigazione
  • Un pulsante "Imposta destinazione" nel menu dell'app
  • un overlay con cui puoi interagire per richiamare dinamicamente i metodi sull'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'SDK in modalità notturna e vedere che aspetto ha.

Opzione SwappingMapAndNavActivity

SwappingMapAndNavActivity mostra i seguenti pattern comuni:

Demo di Google Maps

L'ultima demo di GoogleNavigation è disponibile su GitHub.

Edificio

  1. In Android Studio, importa l'app di 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 Crea ed esamina i dettagli di implementazione dell'SDK.

    • Nella classe Java, annotare il codice di implementazione.

    • Nel file XML del layout, prendi nota del design e del testo del layout.

    • Nel file build.gradle, prendi nota dell'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 istruzioni per attivare le Opzioni sviluppatore sul dispositivo Android e configurare il sistema in modo che rilevi il dispositivo.
    • Emulatore Utilizza Gestione dispositivi virtuali (AVD) Android per configurare un dispositivo virtuale. Quando scegli un emulatore, assicurati di scegliere un'immagine che includa le API 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 corrispondente struttura del codice sorgente devono essere familiari agli utenti delle demo di Google Maps SDK. Questo accade perché la demo di GoogleMap è progettata per essere simile all'app demo dell'API Maps. La differenza principale è che la demo dell'SDK Navigation consente all'utente di scegliere la classe di visualizzazione su cui eseguire il test di una demo: NavigationView o MapView, se 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 essere ancora necessario utilizzare un MapView nelle situazioni in cui utilizzi una libreria di terze parti che deve interagire con la classe.