Aide-mémoire du SDK Navigation pour iOS

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 :

SDK Navigation pour iOS : configuration

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 : 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 = true pendant 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 sans NSMotionUsageDescription dans Info.plist planteront lors de l'initialisation. L'ajout de la clé n'a actuellement aucun effet sur le comportement actuel. Solution : ajoutez NSMotionUsageDescription (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 .travelModeUnsupported lorsque la valeur travelMode de l'application n'est pas driving ou twoWheeler. Solution : définissez mapView.travelMode sur .driving ou .twoWheeler. Vérifiez resolvedParameters.travelMode pour 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.
  • GMSNavigator setDestinations: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 GMSServices appCheckTokenProvider : obsolète depuis le 24/09/2026. Remplacement : propriété de classe GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]). Symptôme : dans la version 11.1.0, la configuration d'App Check via GMSServices.sharedServices() a échoué. Consultez le guide de migration.
  • GMSNavigator continueToNextDestination : Obsolète depuis le 07/04/2026. Remplacement : GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights et showsStopSigns : 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 .terrain pendant la navigation active : abandonné depuis le 06/08/2026. Remplacement : type de carte .normal (kGMSTypeNormal), .satellite ou .hybrid.
  • Protocoles GMSNavigatorDelegate et GMSRoadSnappedLocationProviderDelegate : Obsolètes depuis le 13/05/2021. Remplacement : GMSNavigatorListener et GMSRoadSnappedLocationProviderListener (ajouter avec -addListener: ; définir timeUpdateThreshold et distanceUpdateThreshold sur GMSNavigator). 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