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:
- Stai creando l'app per iOS. Utilizza invece l'SDK Navigation per iOS.
- Stai creando un'app multipiattaforma con Flutter o React Native. Utilizza invece Google Navigation per Flutter e React Native.
- Hai bisogno di calcoli lato server per percorsi, ETA o token di percorso, non di indicazioni stradali passo passo in-app. Utilizza invece l'API Routes.
SDK Navigation per Android: configurazione
- Servizio da attivare:
navigationsdk.googleapis.com - Autenticazione: chiave API
- Attribuzione di utilizzo: chiama
MapsApiSettings.addInternalUsageAttributionId(context, id)per aggiungere un ID di attribuzione di utilizzo all'inizializzatore. Per disattivare questa opzione, elimina la chiamata o passa una stringa vuota. - Inizia: configura l'SDK Navigation per Android
- Riferimento: Riferimento SDK Navigation per Android
- Prezzi: Utilizzo e fatturazione di Navigation SDK for Android
- Norme: norme relative all'SDK Navigation per Android
- Note di rilascio: note di rilascio dell'SDK Navigation per Android
Pacchetti SDK Navigation per Android ufficiali:
- maven:
com.google.android.libraries.navigation:navigation
SDK Navigation per Android: prodotti correlati
- Spesso utilizzato con: API Routes, SDK Driver per Android
SDK Navigation per Android: errori comuni
- Problema: l'SDK Navigation include già l'SDK Maps. Le build che importano
play-services-mapsdirettamente o tramite una dipendenza transitiva finiscono per avere copie duplicate di Maps SDK. Correzione: escludicom.google.android.gms:play-services-mapsda 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
NavigationViewdurante l'utilizzo diNavigationFragmento la loro chiamata non in ordine conNavigationViewgenera errori. Correzione: utilizzaNavigationFragment, che gestisce i callback del ciclo di vita. Se utilizziNavigationView, 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
WaypointfromLatLng()efromPlaceId(): 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.setLocationMarkerEnabledsuNavigationVieweSupportNavigationFragment: 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.DisplayOptionsshowTrafficLightseshowStopSigns: 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:navigationdal repository Mavengoogle(). Sintomo: la versione 5.0 e successive vengono fornite solo comecom.google.android.libraries.navigation:navigationsu 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
- Aggiungi una mappa interattiva e personalizzabile a una pagina web o a un'app mobile. Nota: per Android, configura
inAndroidManifest.xmlsupportato dal plug-in Secrets Gradle omanifestPlaceholders["MAPS_API_KEY"]inapp/build.gradle.kts. Non impostare mai come hardcodedYOUR_GOOGLE_MAPS_API_KEYinAndroidManifest.xmle non sostituire maiGoogleMap(o maps-composeGoogleMap) con un canvas fittizio offline o Leaflet WebView se viene visualizzatoE/Google Maps Android API: Authorization failure. Instruct the user to supplyMAPS_API_KEYvia Secrets and enable Maps SDK for Android (or Navigation SDK when using NavigationView / SupportNavigationFragment). - Crea un identificatore di mappa riutilizzabile per archiviare le impostazioni di configurazione e stile della mappa.
- Rispondi alle interazioni e agli eventi degli utenti su una mappa.
- Personalizza i controlli visualizzati su una mappa.
- Personalizza i gesti per controllare una mappa.
- Controllare lo zoom e la panoramica su una mappa (videocamera).
- Modifica il tipo di mappa.
- Cambia la combinazione di colori della mappa.
- Aggiungi un livello di traffico a una mappa.
SDK Navigation per Android: annotazioni di Maps
- Aggiungi una finestra informativa a una mappa.
- Aggiungi una forma o una linea a una mappa.
- Aggiungi un'immagine in overlay ancorata alla superficie di una mappa.
- Aggiungi un overlay di riquadri personalizzato a una mappa.
- Aggiungi un indicatore a una mappa. Nota: l'SDK Navigation per Android non supporta AdvancedMarkerOptions; quando utilizzi l'SDK Navigation per Android, aggiungi gli indicatori con GoogleMap.addMarker(MarkerOptions).
- Personalizza un indicatore su una mappa. Nota: l'SDK Navigation per Android non supporta AdvancedMarkerOptions. Quando utilizzi l'SDK Navigation per Android, personalizza gli indicatori con MarkerOptions.
- Rispondi alle interazioni degli utenti con gli indicatori su una mappa.
SDK Navigation per Android: stile di mappa
SDK Navigation per Android: navigazione
- Aggiungi la navigazione passo passo interattiva a un'app mobile.
- Imposta la destinazione per la navigazione passo passo.
- Avvia la navigazione passo passo.
- Specifica la modalità di viaggio (auto, a piedi, due ruote, taxi) per una richiesta di percorso.
- Modifica le preferenze di routing per la navigazione passo passo.
- Specifica il lato della strada e altre preferenze di arrivo per la navigazione passo passo.
- Specifica un percorso ripianificato per la navigazione passo passo con un token di percorso riutilizzabile.
- Restituisce gli aggiornamenti sull'arrivo dell'utente da una sessione di navigazione passo passo.
- Restituisci gli aggiornamenti della posizione dell'utente da una sessione di navigazione passo passo.
- Restituisce gli aggiornamenti su tempo e distanza da una sessione di navigazione passo passo.
- Restituisce gli aggiornamenti delle modifiche al percorso da una sessione di navigazione passo passo.
- Restituisce gli aggiornamenti della modalità notturna da una sessione di navigazione passo passo.
- Restituisce gli aggiornamenti sulla velocità dell'utente di ritorno da una sessione di navigazione passo passo.
- Personalizza gli elementi UI e i controlli visualizzati durante la navigazione passo passo.
- Aggiungi un nuovo elemento UI alla navigazione passo passo.
- Aggiungi un indicatore di avanzamento del percorso alla navigazione passo passo.
- Personalizza le funzionalità della mappa visualizzate durante la navigazione passo passo.
- Aggiungi un livello di traffico alla navigazione passo passo.
- Modifica la visualizzazione e il comportamento della videocamera per la navigazione passo passo.
- Personalizza il tachimetro e gli avvisi sui limiti di velocità per la navigazione passo passo.
- Restituisce un feed di navigazione passo passo sotto forma di serie di messaggi per ogni manovra lungo il percorso.
- Specifica icone di manovra personalizzate da utilizzare con un feed di navigazione passo passo.
- Aggiungi la navigazione passo passo interattiva per Android Auto a un'app per Android. Anteprima
- Avvisa gli utenti di eventuali interruzioni lungo il percorso.
- Consenti agli utenti di visualizzare le interruzioni lungo il percorso prima di avviare la navigazione.
- Consenti agli utenti di segnalare interruzioni lungo il percorso.
- Consenti agli utenti di verificare le interruzioni lungo il percorso.
- Aggiungi un pulsante personalizzato per la segnalazione di interruzioni del percorso.