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 les indications de navigation basées sur une carte. Il fournit les manœuvres à venir avec les éléments que vous fournissez:
- Icônes (à gauche, à droite, demi-tour)
- CANNOT TRANSLATE
- noms des routes
- l'estimation des distances et du temps pour passer à la prochaine étape de navigation ou à la destination finale ;
Vous pouvez utiliser le flux de la navigation détaillée pour créer des expériences pour lesquelles l'interface utilisateur complète du SDK Navigation n'est pas appropriée (par exemple, pour les écrans de petite taille). Par exemple, vous pouvez l'utiliser pour les usagers de véhicules à deux roues, qui vous permettent de projeter uniquement des indications de navigation pour les aider à atteindre leur destination plus rapidement et en toute confiance avec un minimum de distractions.
Éléments essentiels d'affichage de la navigation
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 par rapport à l'étape actuelle ou à la destination, qui sont tous disponibles dans GMSNavigationNavInfo. L'image de droite illustre 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 les trajets et les étapes afin de 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 la section É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 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 d'un itinéraire de navigation.
GMSNavigationNavState : énumération définissant l'état actuel d'une navigation (par exemple, en route, en réacheminement ou arrêtée).
GMSNavigationDrivingSide : énumération définissant si cette étape s'effectue sur un itinéraire "drive-on-right" ou "drive-on-left".
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 ... } } } }
États de navigation
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 l'étape de manœuvre à venir en cours sont disponibles.Nouvel 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 étatGMSNavigationNavStateStopped
efface l'affichage des informations de navigation pour empêcher l'affichage des instructions d'étape.
Créer des icônes pour faciliter les manœuvres
L'énumération GMSNavigationManeuver définit chaque manœuvre possible qui peut se produire pendant la navigation. Vous pouvez également 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, comme GMSNavigationManeuverDestinationLeft
et GMSNavigationManeuverDestinationRight
.
Toutefois, étant donné que certaines manœuvres partagent des caractéristiques avec d'autres significations, vous pouvez mapper plusieurs manœuvres à une seule icône. Par exemple, GMSNavigationManeuverTurnLeft
et GMSNavigationManeuverOnRampLeft
peuvent tous deux être mappés à l'icône de virage à 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é automobile d'un pays. Par exemple, dans les pays où la conduite s'effectue à gauche de la route, les conducteurs font un rond-point ou un demi-tour dans le sens des aiguilles d'une montre, tandis que ceux qui se trouvent à droite de la route vont 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 selon qu'elle s'effectue dans le sens des aiguilles d'une montre ou dans le sens inverse.
Développer pour voir des exemples d'icônes pour différentes manœuvres
Icône Exemple | Commandes détaillées |
---|---|
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
|