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
- Service à activer :
navigationsdk.googleapis.com - Authentification : clé API
- Attribution de l'utilisation : appelez
MapsApiSettings.addInternalUsageAttributionId(context, id)pour ajouter un ID d'attribution de l'utilisation à l'initialiseur. Pour désactiver cette option, supprimez l'appel ou transmettez une chaîne vide. - Premiers pas : Configurer le SDK Navigation pour Android
- Référence : Documentation de référence du SDK Navigation pour Android
- Tarifs : Utilisation et facturation du SDK Navigation pour Android
- Règles : Règles du SDK Navigation pour Android
- Notes de version : Notes de version du SDK Navigation pour Android
Packages officiels du SDK Navigation pour Android :
- maven:
com.google.android.libraries.navigation:navigation
SDK Navigation pour Android : produits associés
- Souvent utilisé avec : l'API Routes, le SDK Driver pour Android
SDK Navigation pour Android : erreurs courantes
- Problème : Le SDK Navigation inclut déjà le SDK Maps. Les builds qui extraient
play-services-mapsdirectement ou via une dépendance transitive se retrouvent avec des copies du SDK Maps en double. Solution : Excluezcom.google.android.gms:play-services-mapsde 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
NavigationViewlors de l'utilisation deNavigationFragment, ou leur appel dans le désordre avecNavigationView, entraîne des erreurs. Solution : utilisezNavigationFragment, qui gère les rappels de cycle de vie. Si vous utilisezNavigationView, 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
WaypointfromLatLng()etfromPlaceId(): 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.setLocationMarkerEnabledsurNavigationViewetSupportNavigationFragment: 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.DisplayOptionsshowTrafficLightsetshowStopSigns: 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:navigationdu dépôt Mavengoogle(). Symptôme : Les versions 5.0 et ultérieures ne sont fournies qu'au formatcom.google.android.libraries.navigation:navigationsur 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
- Ajoutez une carte interactive personnalisable à une page Web ou une application mobile. Remarque : Pour Android, configurez
dansAndroidManifest.xmlavec le plug-in Secrets Gradle oumanifestPlaceholders["MAPS_API_KEY"]dansapp/build.gradle.kts. Ne codez jamaisYOUR_GOOGLE_MAPS_API_KEYen dur dansAndroidManifest.xml, et ne remplacez jamaisGoogleMap(ou maps-composeGoogleMap) par un canevas fictif hors connexion ou une WebView Leaflet siE/Google Maps Android API: Authorization failureapparaît. Demandez à l'utilisateur de fournirMAPS_API_KEYvia Secrets et d'activer le SDK Maps pour Android (ou le SDK Navigation si vous utilisez NavigationView/SupportNavigationFragment). - Créez un identifiant de carte réutilisable pour stocker la configuration de la carte et les paramètres de style.
- Répondre aux interactions et aux événements utilisateur sur une carte
- Personnalisez les commandes qui s'affichent sur une carte.
- Personnalisez les gestes permettant de contrôler une carte.
- Contrôler le zoom et le panoramique sur une carte (caméra)
- Modifier le type de carte
- Modifiez le jeu de couleurs de la carte.
- Ajouter un calque de trafic à une carte
SDK Navigation pour Android : annotations de cartes
- Ajouter une fenêtre d'informations à une carte
- Ajouter une forme ou une ligne à une carte
- Ajoutez une image de superposition ancrée à la surface d'une carte.
- Ajouter une superposition de tuiles personnalisée à une carte
- Ajouter un repère sur une carte Remarque : Le SDK Navigation pour Android n'est pas compatible avec AdvancedMarkerOptions. Lorsque vous utilisez le SDK Navigation pour Android, ajoutez des repères avec GoogleMap.addMarker(MarkerOptions).
- Personnaliser un repère sur une carte Remarque : Le SDK Navigation pour Android n'est pas compatible avec AdvancedMarkerOptions. Lorsque vous utilisez le SDK Navigation pour Android, personnalisez les repères avec MarkerOptions.
- Répondez aux interactions des utilisateurs avec les repères sur une carte.
SDK Navigation pour Android : styles de cartes
SDK Navigation pour Android : Navigation
- Ajoutez une navigation détaillée interactive à une application mobile.
- Définissez la destination pour la navigation détaillée.
- Lancez la navigation détaillée.
- Spécifiez le mode de transport (voiture, marche, deux-roues, taxi) pour une demande d'itinéraire.
- Modifiez les préférences de calcul d'itinéraire pour la navigation détaillée.
- Spécifiez le côté de la route et d'autres préférences d'arrivée pour la navigation détaillée.
- Spécifiez un itinéraire replanifié pour la navigation détaillée avec un jeton d'itinéraire réutilisable.
- Renvoyez les informations d'arrivée de l'utilisateur à partir d'une session de navigation détaillée.
- Renvoie les mises à jour de la position de l'utilisateur à partir d'une session de navigation détaillée.
- Renvoyez les mises à jour de l'heure et de la distance à partir d'une session de navigation détaillée.
- Renvoyer les mises à jour de changement d'itinéraire à partir d'une session de navigation détaillée.
- Renvoyer les mises à jour du mode nuit à partir d'une session de navigation détaillée.
- Renvoie les mises à jour de la vitesse de l'utilisateur à partir d'une session de navigation détaillée.
- Personnalisez les éléments d'interface utilisateur et les commandes qui s'affichent pendant la navigation détaillée.
- Ajoutez un nouvel élément d'interface utilisateur à la navigation détaillée.
- Ajoutez un indicateur de progression du trajet à la navigation détaillée.
- Personnalisez les éléments cartographiques qui s'affichent pendant la navigation détaillée.
- Ajoutez un calque de trafic à la navigation détaillée.
- Modifiez la vue et le comportement de la caméra pour la navigation détaillée.
- Personnalisez le compteur de vitesse et les alertes de limitation de vitesse pour la navigation détaillée.
- Renvoyez un flux de navigation détaillée sous la forme d'une série de messages pour chaque manœuvre le long de l'itinéraire.
- Spécifiez des icônes de manœuvre personnalisées à utiliser avec un flux de navigation détaillée.
- Ajoutez une navigation détaillée interactive pour Android Auto à une application Android. Preview
- Alertez les utilisateurs des perturbations sur leur itinéraire.
- Permettez aux utilisateurs de voir les perturbations sur leur itinéraire avant de lancer la navigation.
- Autorisez les utilisateurs à signaler des perturbations sur leur itinéraire.
- Autorisez les utilisateurs à vérifier les perturbations sur leur itinéraire.
- Ajoutez un bouton de signalement d'incident sur un itinéraire personnalisé.