Riferimento rapido per l'SDK Navigation per Android

Navigation SDK for Android aggiunge la navigazione passo passo di Google Maps alle app per Android, con personalizzazione della UI e configurazione del percorso. Include il livello della mappa di Maps SDK, pertanto le app che lo utilizzano non possono includere anche Maps SDK for Android.

SDK Navigation per Android: informazioni chiave

  • Prodotto: SDK Navigation per Android
  • Noto anche come: SDK Navigation
  • Categoria: Percorsi
  • Piattaforma: Android
  • Esecuzione su: client (codice dell'app o del browser)
  • Fase di lancio: GA
  • Ciclo di vita: Attivo
  • Panoramica: Panoramica dell'SDK Navigation per Android

SDK Navigation per Android: quando utilizzarlo

Utilizza l'SDK Navigation per Android quando:

  • Hai bisogno della navigazione passo passo di Google Maps all'interno della tua app per Android, in modo che gli utenti non passino a un'altra app.
  • Devi personalizzare la UI di navigazione in modo che corrisponda al tuo brand o creare un'esperienza di navigazione personalizzata.
  • Hai bisogno della navigazione in-app per la guida, a piedi, in bicicletta o con veicoli a due ruote.
  • Devi percorrere un percorso pianificato con l'API Routes passando un token di percorso all'SDK.

Non utilizzare Navigation SDK per Android quando:

SDK Navigation per Android: configurazione

Pacchetti SDK Navigation per Android ufficiali:

  • maven: com.google.android.libraries.navigation:navigation

SDK Navigation per Android: errori comuni

  • Problema: l'SDK Navigation include già l'SDK Maps. Le build che importano play-services-maps direttamente o tramite una dipendenza transitiva finiscono per avere copie duplicate di Maps SDK. Correzione: escludi com.google.android.gms:play-services-maps da tutte le dipendenze (esclusioni delle configurazioni Gradle o esclusioni Maven) e rimuovi qualsiasi dipendenza diretta dall'SDK Maps. Consulta /maps/documentation/navigation/android-sdk/android-studio-setup.
  • Problema: l'SDK Navigation 8.0 e versioni successive dichiara minAndroidGradlePluginVersion=9.0.1, pertanto le build con un AGP precedente non vanno a buon fine. Correzione: esegui l'upgrade ad AGP 9.0.1, Gradle 9.1.0 e Kotlin 2.3.0 prima di eseguire la build con la versione 8.0 o successive. Consulta /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration.
  • Problema: la chiamata diretta dei metodi del ciclo di vita di NavigationView durante l'utilizzo di NavigationFragment o la loro chiamata non in ordine con NavigationView genera errori. Correzione: utilizza NavigationFragment, che gestisce i callback del ciclo di vita. Se utilizzi NavigationView, inoltra i metodi del ciclo di vita in ordine rigoroso. Consulta /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices.
  • Problema: la navigazione non è disponibile finché l'utente non accetta i Termini di servizio di Google Navigatore. Correzione: consenti all'SDK di mostrare la richiesta la prima volta che viene richiamato il navigatore o mostra la finestra di dialogo in precedenza (ad esempio durante la registrazione) con TermsAndConditionsCheckOption/NavigationApi.showTermsAndConditionsDialog. Consulta /maps/documentation/navigation/android-sdk/route.

SDK Navigation per Android: funzionalità legacy e deprecate

  • Waypoint fromLatLng() e fromPlaceId(): ritirati dal 10 maggio 2021. Sostituzione: Waypoint.builder() (Waypoint.Builder). Sintomo: rimosso nella versione 3.0; le chiamate non vengono compilate con la versione 3.0 o successive. Consulta la guida alla migrazione.
  • SupportNavigationFragment: deprecato dall'1/10/2026. Sostituzione: NavigationFragment. Sintomo: deprecato nell'SDK Navigation v8.0.0. Consulta la guida alla migrazione.
  • setLocationMarkerEnabled su NavigationView e SupportNavigationFragment: disattivato dal 7 luglio 2023. Sostituzione: GoogleMap.setMyLocationEnabled. Sintomo: rimosso nella versione 5.0.0 (deprecato nella versione 4.1); le chiamate non vengono compilate con la versione 5.0 o successive.
  • DisplayOptions showTrafficLights e showStopSigns: ritirato dal 1° ottobre 2026. Sostituzione: non è necessaria alcuna sostituzione; i semafori e i segnali di stop sono sempre attivi durante la navigazione. Sintomo: le chiamate a questi metodi non vengono compilate con la versione 8.0.0.
  • Artefatto Maven com.google.android.maps:navsdk (repository privato, v4.x) e download del bundle AAR: ritirati dal 7 luglio 2023. Sostituzione: com.google.android.libraries.navigation:navigation dal repository Maven google(). Sintomo: la versione 5.0 e successive vengono fornite solo come com.google.android.libraries.navigation:navigation su Google Maven; il bundle AAR non viene più distribuito. Consulta la guida alla migrazione.

Cosa puoi fare con l'SDK Navigation per Android

Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.

Navigation SDK for Android: Maps

SDK Navigation per Android: annotazioni di Maps

SDK Navigation per Android: stile di mappa

SDK Navigation per Android: navigazione