Cette page a été traduite par l'API Cloud Translation.

Informations sur le flux de données de navigation détaillée

Un flux de données de navigation détaillée fournit des informations de navigation uniquement aux appareils qui ne sont pas conçus pour les instructions de navigation basées sur des cartes. Il fournit les prochaines manœuvres avec les éléments que vous fournissez :

Icônes (gauche, droite, demi-tour)
numéros de sortie des ronds-points
noms de routes ;
les distances et le temps estimés jusqu'à la prochaine étape de navigation ou la destination finale ;

Vous pouvez utiliser le flux d'instructions détaillées pour créer des expériences où l'UI complète du SDK Navigation n'est pas appropriée, par exemple pour les petits écrans. Par exemple, vous pouvez l'utiliser pour les conducteurs de deux-roues, en projetant un guidage uniquement pour la navigation afin de les aider à atteindre leur destination plus rapidement et plus sereinement, avec un minimum de distractions.

Éléments essentiels de navigation

Écran mobile affichant un prochain virage à droite dans 15 mètres sur Church Street. En bas de l'écran, il reste 13 minutes et 3, 4 kilomètres pour arriver à destination.

Les champs principaux de chaque étape de navigation sont le nom complet de la route, la manœuvre et la distance totale de l'étape, qui sont disponibles dans GMSNavigationStepInfo.

Pour l'ensemble du trajet, vous pouvez afficher le temps et la distance restants jusqu'à l'étape actuelle ou jusqu'à la destination. Toutes ces informations sont disponibles dans GMSNavigationNavInfo. L'image de droite montre un exemple de ces éléments de navigation essentiels.

Configurer un écouteur d'événements

Pour utiliser les données de navigation uniquement, vous devez implémenter un écouteur d'événements pour l'événement didChangeNavInfo. Dans l'écouteur d'événements, accédez aux informations sur le trajet et les étapes pour fournir une navigation détaillée à vos utilisateurs.

Pour implémenter des gestionnaires d'événements, le contrôleur de vue de la carte doit implémenter le protocole GMSNavigatorListener. Pour en savoir plus sur la gestion des événements dans le SDK Navigation pour iOS, consultez Écouter les événements de navigation.

Gérer l'événement `didChangeNavInfo`

Créez un écouteur pour l'événement didChangeNavInfo afin d'ajouter la navigation guidée à votre application. Dans l'écouteur d'événements, utilisez les classes et les énumérations suivantes pour contrôler la navigation guidée :

GMSNavigationNavInfo : classe définissant des informations sur l'état de la navigation.
GMSNavigationStepInfo : classe définissant des informations sur une seule étape d'un itinéraire de navigation.
GMSNavigationNavState : énumération définissant l'état actuel d'une navigation, par exemple en route, en cours de recalcul ou arrêtée.
GMSNavigationDrivingSide — Énumération indiquant si cette étape se trouve sur une route où l'on roule à droite ou à gauche.
GMSNavigationManeuver : énumération définissant l'action de navigation à effectuer, comme tourner à gauche ou à droite.

Vous trouverez ci-dessous des exemples d'écouteurs d'événements pour l'événement didChangeNavInfo :

Swift

  // ViewController.swift
  class SomeViewController: UIViewController {
    ...
    mapView.navigator?.add(self);
    ...
  }

  extension SomeViewController: GMSNavigatorListener {
    func navigator(_ navigator: GMSNavigator,
                   didUpdateNavInfo navInfo: GMSNavigationNavInfo) {

      // Get the current step information
      if navInfo.navState == .enroute {
        if let currentStep = navInfo.currentStep {
          ...
          roadNameLabel.text = currentStep.simpleRoadName
          ...
        }
      }
    }
  }

Objective-C

  // ViewController.h
  @interface SomeViewController () <GMSNavigatorListener>

  @end

  // ViewController.m
  @implementation SomeViewController
  // Some initialization code.
  ... {
    ...
    [_mapView.navigator addListener:self];
    ...
  }

  #pragma mark GMSNavigatorListener
  - (void)navigator:(GMSNavigator *)navigator didUpdateNavInfo:(GMSNavigationNavInfo *)navInfo {
    // Get the current step information
    if (navInfo.navState == GMSNavigationNavStateEnroute) {
      GMSNavigationStepInfo *currentStep = navInfo.currentStep;
      if (currentStep) {
        ...
        roadNameLabel.text = currentStep.simpleRoadName;
        ...
      }
    }
    ...
  }

États de navigation

Utilisez la propriété navState de GMSNavigationNavInfo pour obtenir l'état actuel de la navigation, qui peut être l'un des suivants :

En route : l'état GMSNavigationNavStateEnroute signifie que la navigation guidée est active et que l'utilisateur suit l'itinéraire fourni. Des informations sur l'étape de manœuvre à venir sont disponibles.
Nouveau calcul de l'itinéraire : GMSNavigationNavStateRerouting signifie que la navigation est en cours, mais que le navigateur recherche un nouvel itinéraire. L'étape de manœuvre à venir n'est pas disponible, car aucun nouvel itinéraire n'a encore été trouvé.
Arrêtée GMSNavigationNavStateStopped : la navigation est terminée. Par exemple, la navigation s'arrête lorsque l'utilisateur quitte la navigation dans l'application. Dans l'application exemple, un état GMSNavigationNavStateStopped efface l'affichage des informations de navigation pour éviter que les instructions d'étape persistantes ne s'affichent.

Assistant de voies de circulation

Le SDK Navigation représente les voies sur la fiche d'instruction de navigation sous la forme d'objets de données GMSNavigationLane et GMSNavigationLaneDirection. Un objet GMSNavigationLane représente une voie spécifique pendant la navigation et contient une liste d'objets GMSNavigationLaneDirection qui décrivent tous les changements de direction possibles à partir de cette voie.

Le champ recommended indique le sens de circulation recommandé pour une voie.

Exemple d'assistant de voies de circulation

L'extrait suivant illustre la représentation des données des voies affichées dans la capture d'écran précédente.

// Lane 1
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 2
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 3
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false}]

// Lane 4
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false},
{/*GMSNavigationLaneShape=*/ GMSNavigationLaneShapeNormalRight, /*recommended=*/ false}]

Images de l'assistant de voies de circulation

Le SDK Navigation permet de générer des images de voies pour chaque étape de navigation, comme indiqué par GMSNavigationStepInfo. Ces icônes respectent les consignes de CarPlay concernant la taille des images.

Swift

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)

Objective-C

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];

Créer des icônes pour les manœuvres

Icône d'une manœuvre

L'énumération GMSNavigationManeuver définit chaque manœuvre possible lors de la navigation. Vous pouvez obtenir la manœuvre pour une étape donnée à partir de la propriété maneuver de GMSNavigationStepInfo.

Vous devez créer des icônes de manœuvre et les associer aux manœuvres correspondantes. Pour certaines manœuvres, vous pouvez configurer un mappage un-à-un vers une icône, comme GMSNavigationManeuverDestinationLeft et GMSNavigationManeuverDestinationRight. Toutefois, comme certaines manœuvres partagent des caractéristiques avec d'autres, vous pouvez mapper plusieurs manœuvres sur une seule icône. Par exemple, GMSNavigationManeuverTurnLeft et GMSNavigationManeuverOnRampLeft peuvent tous deux être associés à l'icône de virage à gauche.

Certaines manœuvres contiennent un libellé supplémentaire "Sens des aiguilles d'une montre" ou "Sens inverse des aiguilles d'une montre", que le SDK détermine en fonction du côté de conduite d'un pays. Par exemple, dans les pays où l'on roule à gauche, les conducteurs prennent un rond-point ou font demi-tour dans le sens des aiguilles d'une montre, tandis que dans les pays où l'on roule à droite, ils le font dans le sens inverse. Le SDK Navigation détecte si une manœuvre se produit dans un trafic à gauche ou à droite, et génère la manœuvre appropriée. Par conséquent, l'icône de manœuvre peut être différente pour une manœuvre dans le sens des aiguilles d'une montre et dans le sens inverse.

Développer pour afficher des exemples d'icônes pour différentes manœuvres

Icône d'exemple	Manœuvres de navigation détaillée
	`DEPART` `UNKNOWN`
	`STRAIGHT` `ON_RAMP_UNSPECIFIED` `OFF_RAMP_UNSPECIFIED` `NAME_CHANGE`
	`TURN_RIGHT` `ON_RAMP_RIGHT`
	`TURN_LEFT` `ON_RAMP_LEFT`
	`TURN_SLIGHT_RIGHT` `ON_RAMP_SLIGHT_RIGHT` `OFF_RAMP_SLIGHT_RIGHT`
	`TURN_SLIGHT_LEFT` `ON_RAMP_SLIGHT_LEFT` `OFF_RAMP_SLIGHT_LEFT`
	`TURN_SHARP_RIGHT` `ON_RAMP_SHARP_RIGHT` `OFF_RAMP_SHARP_RIGHT`
	`TURN_SHARP_LEFT` `ON_RAMP_SHARP_LEFT` `OFF_RAMP_SHARP_LEFT`
	`TURN_U_TURN_COUNTERCLOCKWISE` `ON_RAMP_U_TURN_COUNTERCLOCKWISE` `OFF_RAMP_U_TURN_COUNTERCLOCKWISE`
	`TURN_U_TURN_CLOCKWISE` `ON_RAMP_U_TURN_CLOCKWISE` `OFF_RAMP_U_TURN_CLOCKWISE`
	`ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE`
	`ROUNDABOUT_SHARP_RIGHT_CLOCKWISE`
	`ROUNDABOUT_RIGHT_COUNTERCLOCKWISE`
	`ROUNDABOUT_RIGHT_CLOCKWISE`
	`ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE`
	`ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE`
	`ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE`
	`ROUNDABOUT_STRAIGHT_CLOCKWISE`
	`ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE`
	`ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE`
	`ROUNDABOUT_LEFT_COUNTERCLOCKWISE`
	`ROUNDABOUT_LEFT_CLOCKWISE`
	`ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE`
	`ROUNDABOUT_SHARP_LEFT_CLOCKWISE`
	`ROUNDABOUT_U_TURN_COUNTERCLOCKWISE`
	`ROUNDABOUT_U_TURN_CLOCKWISE`
	`ROUNDABOUT_COUNTERCLOCKWISE`
	`ROUNDABOUT_CLOCKWISE`
	`ROUNDABOUT_EXIT_COUNTERCLOCKWISE`
	`ROUNDABOUT_EXIT_CLOCKWISE`
	`MERGE_RIGHT` `OFF_RAMP_RIGHT`
	`MERGE_LEFT` `OFF_RAMP_LEFT`
	`FORK_RIGHT` `TURN_KEEP_RIGHT` `ON_RAMP_KEEP_RIGHT` `OFF_RAMP_KEEP_RIGHT`
	`FORK_LEFT` `TURN_KEEP_LEFT` `ON_RAMP_KEEP_LEFT` `OFF_RAMP_KEEP_LEFT`
	`MERGE_UNSPECIFIED`
	`DESTINATION`
	`DESTINATION_RIGHT`
	`DESTINATION_LEFT`
	`FERRY_BOAT`
	`FERRY_TRAIN`

Utiliser des icônes générées

Le SDK Navigation permet de générer des icônes de manœuvre pour un GMSNavigationStepInfo donné. Ces icônes respectent les consignes concernant la taille des images CarPlay.

Swift

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)

Objective-C

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];

Informations sur le flux de données de navigation détaillée Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Éléments essentiels de navigation

Configurer un écouteur d'événements

Gérer l'événement didChangeNavInfo

Swift

Objective-C

États de navigation

Assistant de voies de circulation

Exemple d'assistant de voies de circulation

Images de l'assistant de voies de circulation

Swift

Objective-C

Créer des icônes pour les manœuvres

Développer pour afficher des exemples d'icônes pour différentes manœuvres

Utiliser des icônes générées

Swift

Objective-C

Informations sur le flux de données de navigation détaillée

Gérer l'événement `didChangeNavInfo`