Prova la demo

Se integri 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, la tua app può offrire contenuti di recupero e creazione di report con un'unica visualizzazione dei dati sul percorso di un utente. Questa guida spiega come eseguire le app demo dell'SDK di navigazione, che sono disponibili su GitHub.

Operazioni preliminari

Per iniziare a utilizzare l'SDK di navigazione, assicurati di avere i 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 SDK di navigazione. Devi fornire projectID, 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 utilizzare Maven per l'SDK di navigazione.
    • Per i progetti che utilizzano la versione 4.99.0 e precedenti. Se non puoi utilizzare Maven, possono 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 avere familiarità con Google Mappe dal punto di vista dell'utente.

Scarica le app demo

Google offre due app per aiutarti a capire L'SDK di navigazione offre le API di Google Maps, a seconda del tuo livello di esperienza. Sviluppatori che conoscono le API di Google Maps possono concentrare la loro attenzione sulla demo di Google Navigatore. Per gli sviluppatori che non conoscono entrambi per i progetti troveranno utili entrambe le app.

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

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

  • Demo di GoogleMap: mostra i singoli comportamenti 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 dell'SDK dal Maven remoto repository Artifact Registry mediante il plug-in Artifact Registry in Gradle. Assicurati di seguire le istruzioni di configurazione del progetto per ottenere l'accesso all'SDK.

Demo di GoogleNavigator

L'ultima demo di GoogleNavigator è disponibile su GitHub.

Edificio

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

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

      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, prendi nota dell'SDK nelle dipendenze.

Guarda Secrets Gradle plug-in documentazione per ulteriori informazioni su come la chiave API viene aggiunta al file manifest.

In esecuzione

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

    • Dispositivo Android: consulta le istruzioni per attiva le opzioni sviluppatore sul tuo dispositivo Android e configura il tuo sistema per rilevare il dispositivo.
    • Emulatore; usa il dispositivo virtuale Android Gestore per e configurare un dispositivo virtuale. Quando scegli un emulatore, assicurati di scegli un'immagine che includa le API di Google.
  2. In Android Studio, fai clic sull'opzione di menu Esegui (o sul pulsante di riproduzione). icon); e poi scegliere una destinazione di deployment.

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

I nuovi utenti di NavSDK troveranno con molta probabilità che queste due opzioni siano le più utile.

Opzione 1: NavViewActivity mostra i comportamenti utilizzando NavigationView in concomitanza con Navigator

Opzione 2: la seconda, denominata NavFragmentActivity, mostra i comportamenti simili utilizzando SupportNavigationFragment accanto Navigator

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

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

Per iniziare, fai clic su Imposta destinazione e scegli un indirizzo. L'app simula un viaggio dalla tua posizione corrente a quell'indirizzo. Utilizzare il controllo che si sovrappongono per vedere cosa succede quando chiami un'API. Ad esempio, puoi Fai clic su Visualizza metodi per provare a forzare la modalità notturna dell'SDK per .

Opzione SwappingMapAndNavActivity

SwappingMapAndNavActivity mostra i seguenti pattern comuni:

Demo di Google Maps

L'ultima demo di GoogleNavigator è disponibile su GitHub.

Edificio

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

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

      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.

Vedi gradle dei segreti plug-in per ulteriori informazioni su come la chiave API viene aggiunta al file manifest.

In esecuzione

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

    • Dispositivo Android Consulta istruzioni per attivare le opzioni sviluppatore sul tuo dispositivo Android e configurare di sistema per rilevare il dispositivo.
    • Emulatore: utilizza il dispositivo virtuale Android Gestore per configurare un dispositivo virtuale. Quando scegli un emulatore, assicurati di scegli un'immagine che includa le API di Google.
  2. In Android Studio, fai clic sull'opzione di menu Esegui (o sul pulsante di riproduzione). icon); e poi scegliere una destinazione di deployment.

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

Questo pattern di presentazione e la corrispondente struttura del codice sorgente gli utenti con le demo di Google Maps SDK. Questo perché La demo di Google Maps è progettata per essere simile alla demo dell'API di Google Maps Google Cloud. Il principale la differenza è che la demo dell'SDK di navigazione consente all'utente di scegliere la classe di visualizzazione vuole testare ed eseguire una demo su: NavigationView o MapView, ove 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 in la nostra app demo e scegli quella che funziona per te. Ad esempio, potrebbe essere ancora è necessario utilizzare MapView nei casi in cui venga utilizzata una terza parte libreria che si aspetta di interagire con il corso.