Activer le flux de données détaillés

Un flux de données de navigation détaillée fournit uniquement des informations de navigation aux appareils qui ne sont pas conçus pour le guidage de la navigation basé sur une carte. Il fournit les manœuvres à venir avec les éléments que vous fournissez:

  • Icônes (gauche, droite, demi-tour)
  • tournez les numéros sur les ronds-points
  • noms des routes
  • une estimation des distances et du temps de trajet jusqu'à l'étape de navigation suivante ou à la destination finale ;

Vous pouvez utiliser le flux de navigation détaillée pour créer des expériences dans lesquelles l'interface utilisateur complète du SDK Navigation n'est pas adaptée, par exemple pour les petits écrans. Par exemple, vous pouvez l'utiliser pour les usagers de deux-roues, où vous pouvez projeter des conseils de navigation pour les aider à atteindre leur destination plus rapidement et en toute confiance, tout en minimisant les distractions.

Éléments essentiels d'affichage de la navigation

Écran d'un appareil mobile qui affiche le prochain virage à droite dans 15 mètres dans la rue Church Street. En bas de l'écran, le temps restant pour atteindre la destination est de 13 minutes et la distance restante est de 2, 1 miles.

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

Pour le trajet global, vous pouvez afficher le temps et la distance restants jusqu'à l'étape actuelle ou jusqu'à la destination, tous disponibles dans GMSNavigationNavInfo. L'image de droite en montre un exemple.

Configurer un écouteur d'événements

Pour utiliser des données réservées à la navigation, 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 une fonctionnalité de navigation détaillée à votre application. Dans l'écouteur d'événements, utilisez les classes et les énumérations suivantes pour contrôler la navigation détaillée:

  • GMSNavigationNavInfo : classe définissant les informations sur l'état de la navigation.

  • GMSNavigationStepInfo : classe définissant les informations sur une seule étape de l'itinéraire de navigation.

  • GMSNavigationNavState : énumération définissant l'état actuel d'une navigation (par exemple, en route, réacheminement ou arrêt).

  • GMSNavigationDrivingSide : énumération définissant si cette étape s'effectue sur un itinéraire en voiture à droite ou à gauche.

  • GMSNavigationManeuver : énumération définissant l'action de navigation à effectuer, par exemple tourner à gauche ou tourner à droite.

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

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;
        ...
      }
    }
    ...
  }

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
          ...
        }
      }
    }
  }

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

  • Enroute : l'état GMSNavigationNavStateEnroute signifie que la navigation guidée est actuellement active et que l'utilisateur suit l'itinéraire fourni. Des informations sur la prochaine étape de la manœuvre actuelle sont disponibles.

  • Changement d'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 il n'y a pas encore de nouvel itinéraire.

  • Arrêtée : GMSNavigationNavStateStopped signifie que 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 des instructions d'étape restantes ne s'affichent.

Indication de voie

Le SDK Navigation représente les voies dans la fiche 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. Il comporte une liste d'objets GMSNavigationLaneDirection décrivant tous les virages qui peuvent être effectués à partir de cette voie.

Le sens recommandé qu'un conducteur doit emprunter sur une voie est indiqué à l'aide du champ recommended.

Exemple d'indication de voie

L'extrait de code suivant illustre la représentation des données des voies affichée 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 d'indication de voie

Le SDK Navigation prend en charge la génération d'images de voies pour chaque étape de navigation, comme indiqué par GMSNavigationStepInfo. Ces icônes correspondent aux conseils de CarPlay concernant le dimensionnement 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 de manœuvre

L'énumération GMSNavigationManeuver définit chaque manœuvre possible qui peut se produire pendant la navigation. Vous pouvez obtenir la manœuvre d'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 qui leur sont associées. Pour certaines manœuvres, vous pouvez configurer un mappage "un à un" avec une icône, par exemple GMSNavigationManeuverDestinationLeft et GMSNavigationManeuverDestinationRight. Toutefois, étant donné que certaines manœuvres partagent des caractéristiques avec d'autres, il peut être judicieux de mapper plusieurs manœuvres à une seule icône. Par exemple, GMSNavigationManeuverTurnLeft et GMSNavigationManeuverOnRampLeft peuvent tous deux correspondre à l'icône de virage de gauche.

Certaines manœuvres contiennent un libellé supplémentaire "Sens des aiguilles d'une montre" ou "Dans le sens inverse des aiguilles d'une montre", que le SDK détermine en fonction du côté conducteur d'un pays. Par exemple, dans les pays où la conduite s'effectue sur le côté gauche de la route, les conducteurs effectuent un rond-point ou un demi-tour dans le sens des aiguilles d'une montre, tandis que les pays qui roulent à droite de la route s'exécutent dans le sens inverse des aiguilles d'une montre. Le SDK Navigation détecte si une manœuvre se produit dans le trafic de gauche ou de 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 voir 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 sont conformes aux conseils de dimensionnement 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];