Guide de référence rapide du SDK Navigation pour Android

Le SDK Navigation pour Android ajoute la navigation détaillée Google Maps aux applications Android, avec personnalisation de l'interface utilisateur et configuration des itinéraires. Il inclut le calque de carte du SDK Maps. Par conséquent, les applications qui l'utilisent ne peuvent pas inclure le SDK Maps pour Android.

SDK Navigation pour Android : informations clés

  • Produit : SDK Navigation pour Android
  • Également appelé : SDK Navigation
  • Catégorie : Routes
  • Plate-forme : Android
  • Exécution sur : client (code de l'application ou du navigateur)
  • Étape de lancement : GA
  • Cycle de vie : Actif
  • Présentation : Présentation du SDK Navigation pour Android

SDK Navigation pour Android : quand l'utiliser

Utilisez le SDK Navigation pour Android dans les cas suivants :

  • Vous avez besoin de la navigation détaillée de Google Maps dans votre propre application Android pour que les utilisateurs ne passent pas à une autre application.
  • Vous devez personnaliser l'UI de navigation pour qu'elle corresponde à votre marque ou créer une expérience de navigation personnalisée.
  • Vous avez besoin d'une navigation intégrée pour les trajets en voiture, à pied, à vélo ou en deux-roues.
  • Vous devez suivre un itinéraire que vous avez planifié avec l'API Routes en transmettant un jeton d'itinéraire au SDK.

N'utilisez pas le SDK Navigation pour Android dans les cas suivants :

  • Vous créez l'application pour iOS. Utilisez plutôt le SDK Navigation pour iOS.
  • Vous créez une application multiplate-forme avec Flutter ou React Native. Utilisez plutôt Google Navigation pour Flutter et React Native.
  • Vous avez besoin d'un calcul d'itinéraire, d'heure d'arrivée prévue ou de jeton d'itinéraire côté serveur, et non d'une navigation détaillée dans l'application. Utilisez plutôt l'API Routes.

SDK Navigation pour Android : configuration

Packages officiels du SDK Navigation pour Android :

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

SDK Navigation pour Android : erreurs courantes

  • Problème : Le SDK Navigation inclut déjà le SDK Maps. Les builds qui extraient play-services-maps directement ou via une dépendance transitive se retrouvent avec des copies du SDK Maps en double. Solution : Excluez com.google.android.gms:play-services-maps de toutes les dépendances (exclusions de configurations Gradle ou exclusions Maven) et supprimez toute dépendance directe au SDK Maps. Consultez /maps/documentation/navigation/android-sdk/android-studio-setup.
  • Problème : Le SDK Navigation 8.0 et les versions ultérieures déclarent minAndroidGradlePluginVersion=9.0.1. Par conséquent, les builds avec une version antérieure d'AGP échouent. Solution : Passez à AGP 9.0.1, Gradle 9.1.0 et Kotlin 2.3.0 avant de compiler avec la version 8.0 ou ultérieure. Consultez /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration.
  • Problème : L'appel direct des méthodes de cycle de vie NavigationView lors de l'utilisation de NavigationFragment, ou leur appel dans le désordre avec NavigationView, entraîne des erreurs. Solution : utilisez NavigationFragment, qui gère les rappels de cycle de vie. Si vous utilisez NavigationView, transférez les méthodes de cycle de vie dans un ordre strict. Consultez /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices.
  • Problème : La navigation n'est pas disponible tant que l'utilisateur n'a pas accepté les conditions d'utilisation de Google Navigation. Correction : laissez le SDK afficher l'invite la première fois que le navigateur est appelé, ou affichez la boîte de dialogue plus tôt (par exemple, lors de l'inscription) avec TermsAndConditionsCheckOption / NavigationApi.showTermsAndConditionsDialog. Consultez /maps/documentation/navigation/android-sdk/route.

SDK Navigation pour Android : fonctionnalités anciennes et obsolètes

  • Waypoint fromLatLng() et fromPlaceId() : Obsolète depuis le 10/05/2021. Remplacement : Waypoint.builder() (Waypoint.Builder). Symptôme : supprimé dans la version 3.0 ; les appels ne sont pas compilés avec la version 3.0 ou ultérieure. Consultez le guide de migration.
  • SupportNavigationFragment : Obsolète depuis le 01/10/2026. Remplacement : NavigationFragment. Symptôme : Obsolète dans le SDK Navigation v8.0.0. Consultez le guide de migration.
  • setLocationMarkerEnabled sur NavigationView et SupportNavigationFragment : mis hors service depuis le 07/07/2023. Remplacement : GoogleMap.setMyLocationEnabled. Symptôme : supprimé dans la version 5.0.0 (obsolète dans la version 4.1) ; les appels ne sont pas compilés avec la version 5.0 ou ultérieure.
  • DisplayOptions showTrafficLights et showStopSigns : Abandonné depuis le 01/10/2026. Remplacement : aucun remplacement n'est nécessaire. Les feux de circulation et les panneaux "Stop" sont toujours activés pendant la navigation. Symptôme : Les appels à ces méthodes ne se compilent pas avec la version 8.0.0.
  • Artefact Maven com.google.android.maps:navsdk (dépôt privé, v4.x) et téléchargement du bundle AAR : Abandonné depuis le 07/07/2023. Remplacement : com.google.android.libraries.navigation:navigation du dépôt Maven google(). Symptôme : Les versions 5.0 et ultérieures ne sont fournies qu'au format com.google.android.libraries.navigation:navigation sur Google Maven. Le bundle AAR n'est plus distribué. Consultez le guide de migration.

Ce que vous pouvez faire avec le SDK Navigation pour Android

Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.

SDK Navigation pour Android : Maps

SDK Navigation pour Android : annotations de cartes

SDK Navigation pour Android : styles de cartes

SDK Navigation pour Android : Navigation