Inizia

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 di tipo Singolo sui dati relativi al percorso di un conducente.

Questa guida illustra un progetto Android Studio, come integrare l'SDK di navigazione ed eseguire l'app demo fornita con l'SDK.

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

Operazioni preliminari

Per iniziare a utilizzare l'SDK di navigazione per Android, 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 projectID, che puoi trovare nella dashboard principale della console Google Cloud, sotto il nome del progetto.

    • Il file ZIP che contiene:

      • Il file della libreria statica .aar nella directory libs/ contenente l'SDK di navigazione come pacchetto aar.
      • File di testo per le licenze e link a Termini e condizioni d'uso e contratti.
      • Un'app demo da importare come nuovo progetto in Android Studio. I file dell'app per creare l'app demo in Android Studio utilizzando Gradle e Maven.

  • 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 i concetti di programmazione orientata agli oggetti. Dovresti conoscere bene Google Maps anche dal punto di vista dell'utente.

Scarica l'SDK, l'app demo e la documentazione

Dopo aver scaricato e decompresso il file SDK, puoi esaminare ed eseguire l'app demo.

L'app demo fornisce una build che implementa una classe NavigationFragment e una variante che implementa una classe NavigationView. La variante NavigationFragment viene eseguita per impostazione predefinita e mostra un percorso di navigazione come mostrato nell'immagine seguente.

  1. Utilizzando il tuo gestore di file preferito, vai alla directory con i file dell'SDK.

  2. Copia la libreria dell'SDK di navigazione nella directory app/libs del progetto demo:

    Ad esempio, potresti eseguire cp libs/*.aar demo/app/libs nel tuo terminale Linux.

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

  4. Apri il campo AndroidManifest.xml dell'app e aggiorna il valore della proprietà API_KEY:

    <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.navigationapidemo" >

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/_AppTheme" >

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="YOUR_API_KEY"/>
    </application>
</manifest>

  5. 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, nota la progettazione del layout e il testo.

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

Esegui l'app

  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 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 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.

  3. Nell'app Demo di navigazione, scegli Imposta destinazione, quindi segui le richieste per selezionare una località e avviare la navigazione simulata.

Crea la variante della vista

L'app demo include una variante View.

  1. In Android Studio, apri l'app demo e fai clic sulla scheda Varianti build della finestra Crea.

  2. Nella finestra Varianti build, seleziona viewDebug e l'elenco dei file cambia.

  3. Esamina i dettagli di implementazione dell'SDK per la classe NavigationView.

    • In NavViewActivity.java, prendi nota del codice di implementazione.

    • In Activity_Nav_View.xml, nota la progettazione del layout e il testo.

  4. Creare ed eseguire l'app. Il nome dell'app cambia per indicare la versione creata. Altrimenti, solo l'oggetto di rendering è diverso.

Passaggio successivo

Integra l'SDK di navigazione per Android nella tua app.