Le SDK Navigation pour iOS ajoute la navigation détaillée Google Maps aux applications iOS, avec personnalisation de l'interface utilisateur et configuration de l'itinéraire. Il étend le SDK Maps pour iOS, qui fournit le calque de carte et doit également être installé dans l'application.
SDK Navigation pour iOS : informations clés
- Produit : SDK Navigation pour iOS
- Également appelé : SDK Navigation
- Catégorie : Routes
- Plate-forme : iOS
- 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 iOS
- Disponibilité régionale : limitée. Les itinéraires en voiture et à pied sont disponibles dans la plupart des pays. Les informations sur le trafic, les perturbations en temps réel, les deux-roues, les vélos, les limitations de vitesse, les feux de signalisation et les panneaux stop varient selon les pays. (détails de la couverture)
SDK Navigation pour iOS : quand l'utiliser
Utilisez le SDK Navigation pour iOS dans les cas suivants :
- Vous avez besoin de la navigation détaillée Google Maps dans votre propre application iOS native pour que les utilisateurs ne changent pas d'application.
- Vous devez personnaliser l'UI de navigation, les styles de carte, la caméra ou la mise en page pour qu'ils correspondent à votre marque pendant le guidage.
- Vous avez besoin de préférences de routage, de plusieurs points de cheminement ou d'un jeton de route de l'API Routes ou de l'API Route Optimization.
- Vous avez besoin d'événements de trajet (position, arrivée, changements d'itinéraire, heure d'arrivée prévue) ou d'un flux de données de navigation détaillée pour une UI de guidage personnalisée ou CarPlay.
N'utilisez pas le SDK Navigation pour iOS dans les cas suivants :
- Vous développez une application Android. Utilisez plutôt le SDK Navigation pour Android.
- Vous créez une application Flutter ou React Native. Utilisez plutôt Google Navigation pour Flutter et React Native.
- Vous n'avez besoin que d'itinéraires, d'heures d'arrivée prévues ou de distances sur un serveur, sans guidage dans l'application. Utilisez plutôt l'API Routes.
SDK Navigation pour iOS : configuration
- Service à activer :
navigationsdk.googleapis.com - Authentification : clé API
- Activez également : SDK Maps pour iOS
- Attribution de l'utilisation : appelez
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]) 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 iOS
- Documentation de référence : Documentation de référence du SDK Navigation pour iOS
- Tarifs : Utilisation et facturation du SDK Navigation pour iOS
- Règles : Règles du SDK Navigation pour iOS
- Notes de version : Notes de version du SDK Navigation pour iOS
Packages officiels du SDK Navigation pour iOS :
- swift_package:
https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)
Packages à ne pas utiliser avec le SDK Navigation pour iOS :
- cocoapods :
GoogleNavigation. La distribution CocoaPods est obsolète depuis la version 11.0.0 et est passée en mode maintenance le 18 août 2025. Utilisez plutôt Swift Package Manager.
SDK Navigation pour iOS : produits associés
- Souvent utilisé avec : SDK Maps pour iOS, API Routes, API Route Optimization, SDK Places pour iOS
SDK Navigation pour iOS : erreurs courantes
- Problème : l'écran s'assombrit ou s'éteint pendant la navigation, car le SDK ne désactive pas le minuteur d'inactivité iOS. Correction : définissez
UIApplication.shared.isIdleTimerDisabled = truependant la navigation. Voir /maps/documentation/navigation/ios-sdk/route. - Problème : Une prochaine version majeure du SDK utilisera l'altimètre (
CMAltimeter), et les applications sansNSMotionUsageDescriptiondansInfo.plistplanteront lors de l'initialisation. L'ajout de la clé n'a actuellement aucun effet sur le comportement actuel. Solution : ajoutezNSMotionUsageDescription(Privacy - Motion Usage Description) àInfo.plist. Voir /maps/documentation/navigation/ios-sdk/route. - Problème : Le SDK Places pour iOS n'est pas fourni avec le SDK Navigation (à partir du SDK Places 5.0). Les classes Places sont donc manquantes. Solution : Installez le SDK Places pour iOS séparément, en utilisant la même version que le SDK Navigation. Consultez /maps/documentation/navigation/ios-sdk/xcode-setup.
- Problème : La définition de destinations avec un jeton de route échoue avec l'erreur
.travelModeUnsupportedlorsque la valeurtravelModede l'application n'est pasdrivingoutwoWheeler. Solution : définissezmapView.travelModesur.drivingou.twoWheeler. VérifiezresolvedParameters.travelModepour voir le mode utilisé par l'itinéraire. Voir /maps/documentation/navigation/ios-sdk/route-customizations.
SDK Navigation pour iOS : fonctionnalités anciennes et obsolètes
- Distribution CocoaPods : obsolète depuis le 06/08/2026. Remplacement : Swift Package Manager. Symptôme : mode maintenance depuis le 18/08/2025. Aucune nouvelle version de CocoaPods après le deuxième trimestre 2026. Consultez le guide de migration.
GMSNavigatorsetDestinations:callback:,setDestinations:routingOptions:callback:,setDestinations:routeToken:callback:(GMSRouteStatusCallback) : Obsolète depuis le 02/11/2026. Remplacement :setDestinations:completionHandler:,setDestinations:routingOptions:completionHandler:,setDestinationsWithToken:completionHandler:(GMSNavigationRouteCompletionHandler).- Propriété d'instance
GMSServicesappCheckTokenProvider: obsolète depuis le 24/09/2026. Remplacement : propriété de classeGMSServices.appCheckTokenProvider(+[GMSServices setAppCheckTokenProvider:]). Symptôme : dans la version 11.1.0, la configuration d'App Check viaGMSServices.sharedServices()a échoué. Consultez le guide de migration. GMSNavigatorcontinueToNextDestination: Obsolète depuis le 07/04/2026. Remplacement :GMSNavigatorcontinueToNextDestinationWithCompletion:.GMSUISettingsshowsTrafficLightsetshowsStopSigns: Obsolète depuis le 06/08/2026. Remplacement : aucun remplacement n'est nécessaire. Les feux de signalisation et les panneaux Stop sont affichés par défaut pendant la navigation.- Type de carte
.terrainpendant la navigation active : abandonné depuis le 06/08/2026. Remplacement : type de carte.normal(kGMSTypeNormal),.satelliteou.hybrid. - Protocoles
GMSNavigatorDelegateetGMSRoadSnappedLocationProviderDelegate: Obsolètes depuis le 13/05/2021. Remplacement :GMSNavigatorListeneretGMSRoadSnappedLocationProviderListener(ajouter avec-addListener:; définirtimeUpdateThresholdetdistanceUpdateThresholdsurGMSNavigator). Consultez le guide de migration.
Ce que vous pouvez faire avec le SDK Navigation pour iOS
Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.
SDK Navigation pour iOS : style de carte
SDK Navigation pour iOS : 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 CarPlay à une application iOS. Aperçu
- 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é.