Configurer les perturbations en temps réel

Les perturbations en temps réel sont un ensemble de fonctionnalités qui alertent les utilisateurs des perturbations sur leur trajet et leur permettent de signaler et de vérifier les perturbations qu'ils rencontrent. Les exemples de perturbations incluent les accidents de la route, les embouteillages, la présence de la police et de radars, les travaux, les voies fermées et certaines conditions météorologiques. Cette page explique les fonctionnalités de perturbation en temps réel et leurs options de configuration, y compris les considérations à prendre en compte pour les applications qui utilisent des UI de navigation personnalisées.

Fonctionnalités de perturbation en temps réel

• Annonces interactives sur les perturbations sur les itinéraires
• Alertes de perturbation automatiques avec vote pendant la navigation active
• Signalement des perturbations pendant la navigation active

Ces fonctionnalités sont configurables et activées par défaut. Les sections suivantes fournissent plus d'informations sur les fonctionnalités et les options de configuration disponibles.

Accroches interactives sur les perturbations sur les itinéraires

Lorsqu'une application affiche un itinéraire, que ce soit dans un aperçu de l'itinéraire ou pendant la navigation active, les perturbations en cours s'affichent sous forme de repères le long de l'itinéraire. Les accroches incluent une icône qui indique le type de perturbation.

Vous pouvez contrôler l'affichage des accroches de perturbations sur les itinéraires à l'aide de shouldDisplayPrompts, qui contrôle également l'affichage des alertes automatiques lorsqu'un utilisateur approche d'une perturbation.

mapView.navigator.shouldDisplayPrompts = true

Afficher les détails d'une perturbation lorsqu'un utilisateur appuie sur un accroche

Les utilisateurs peuvent appuyer sur un encadré pour afficher une fiche d'informations contenant plus d'informations sur la perturbation, y compris le type de perturbation, l'heure à laquelle elle a été signalée pour la dernière fois et, dans certains cas, une option permettant de voter pour savoir si la perturbation est toujours présente. Deux types de fiches info peuvent s'afficher, selon que l'utilisateur est en navigation active ou non. Les options de configuration varient pour chaque type.

Fiches d'informations sur les itinéraires avant de commencer la navigation active

Lorsqu'un utilisateur appuie sur un encadré sur un aperçu d'itinéraire avant de démarrer la navigation active, une fiche d'informations s'affiche avec plus d'informations sur l'interruption.

Vous pouvez contrôler la possibilité pour les utilisateurs d'appuyer sur les accroches de perturbation dans les aperçus de trajets pour afficher plus d'informations à l'aide de showsIncidentCards.

mapView.settings.showsIncidentCards = true

Fiches d'informations pendant la navigation active

Lorsqu'un avertissement de perturbation s'affiche sur un itinéraire pendant la navigation active, les utilisateurs peuvent appuyer dessus pour afficher une fiche d'informations contenant plus d'informations sur la perturbation, y compris le type de perturbation et l'heure de sa dernière signalisation, ainsi que des boutons permettant de voter pour savoir si la perturbation est toujours présente. Les votes envoyés par les utilisateurs sont traités par Google et peuvent s'afficher sur la carte pour d'autres utilisateurs de Google Maps et d'utilisateurs du SDK Navigation. Ils peuvent également être utilisés pour déterminer si la perturbation doit continuer à s'afficher.

Vous pouvez contrôler l'affichage et la possibilité de cliquer sur les accroches de perturbation pendant la navigation active à l'aide de shouldDisplayPrompts, qui contrôle également l'affichage des accroches le long des itinéraires et l'affichage des alertes automatiques lorsqu'un utilisateur approche d'une perturbation.

mapView.navigator.shouldDisplayPrompts = true

Alertes de perturbation automatiques avec vote pendant la navigation active

Lors de la navigation active, lorsqu'un utilisateur approche d'une perturbation sur un itinéraire, une invite s'affiche avec des informations sur la perturbation et des boutons permettant de voter pour savoir si la perturbation est toujours présente. Les votes envoyés par les utilisateurs sont traités par Google et peuvent être affichés sur la carte pour les autres utilisateurs du SDK Google Maps et Navigation. Ils peuvent également être utilisés pour déterminer si l'interruption doit continuer à s'afficher.

Vous pouvez configurer l'affichage des invites d'alerte pendant la navigation active à l'aide de shouldDisplayPrompts, qui contrôle également l'affichage des accroches le long des itinéraires.

mapView.navigator.shouldDisplayPrompts = true

Signalement des perturbations pendant la navigation active

En mode navigation active, un bouton s'affiche dans l'interface utilisateur de navigation. Il permet aux utilisateurs de signaler de nouvelles perturbations sur leur itinéraire. Lorsqu'un utilisateur appuie sur le bouton, un menu s'affiche avec les types de perturbations disponibles à signaler. Les signalements envoyés par les utilisateurs sont traités par Google et peuvent être affichés sur la carte pour les autres utilisateurs de Google Maps et du SDK Navigation.

Vous pouvez configurer la visibilité du bouton de création de rapports pendant la navigation active à l'aide de navigationReportIncidentButtonEnabled.

// Enables the incident reporting FAB to show in situations where incident
// reporting is possible.
mapView.settings.navigationReportIncidentButtonEnabled = true

Utiliser des UI de navigation personnalisées

Si votre implémentation du SDK Navigation inclut des éléments d'interface utilisateur personnalisés, vous devez tenir compte des éléments de perturbation en temps réel pour éviter les conflits.

Positionnement du bouton "Rapports"

// Create a new layout guide
let topRightLayoutGuide = UILayoutGuide()
self.view.addLayoutGuide(topRightLayoutGuide)

// Activate constraints using fixed constants here as an example
// assuming the current reporting button is of fixed height
topRightLayoutGuide.topAnchor.constraint(equalTo: _mapView.navigationHeaderLayoutGuide.bottomAnchor, constant: 50).isActive = true
topRightLayoutGuide.trailingAnchor.constraint(equalTo: self.view.safeAreaLayoutGuide.trailingAnchor, constant: -14).isActive = true

// Assign the layout guide
_mapView.bottomTrailingButtonsLayoutGuide = topRightLayoutGuide

// Create an alternate layout guide to use when the header and the footer are not full width
let topRightAlternateLayoutGuide = UILayoutGuide()
self.view.addLayoutGuide(topRightAlternateLayoutGuide)

// Activate constraints using fixed constants here as an example
// assuming the current RTD button is of fixed height
topRightAlternateLayoutGuide.topAnchor.constraint(equalTo: _mapView.navigationHeaderLayoutGuide.bottomAnchor, constant: 20).isActive = true
topRightAlternateLayoutGuide.trailingAnchor.constraint(equalTo: self.view.safeAreaLayoutGuide.trailingAnchor, constant: -10).isActive = true

// Assign the layout guide
_mapView.bottomTrailingButtonsAlternateLayoutGuide = topRightAlternateLayoutGuide

// Create a new layout guide
UILayoutGuide *topRightLayoutGuide = [[UILayoutGuide alloc] init];
[self.view addLayoutGuide:topRightLayoutGuide];

// Activate constraints using fixed constants here as an example
// assuming the current RTD button is of fixed height
[[topRightLayoutGuide.topAnchor
    constraintEqualToAnchor:_mapView.navigationHeaderLayoutGuide.bottomAnchor
                   constant:50]
    setActive:YES];

[[topRightLayoutGuide.trailingAnchor
    constraintEqualToAnchor:self.view.safeAreaLayoutGuide.trailingAnchor
                   constant:-14]
    setActive:YES];

// Assign the layout guide
_mapView.bottomTrailingButtonsLayoutGuide = topRightLayoutGuide;

// Create an alternate layout guide to use when the header and the footer are not full width
UILayoutGuide *topRightAlternateLayoutGuide = [[UILayoutGuide alloc] init];
[self.view addLayoutGuide:topRightAlternateLayoutGuide];

// Activate constraints using fixed constants here as an example
// assuming the current RTD button is of fixed height
[[topRightAlternateLayoutGuide.topAnchor
    constraintEqualToAnchor:_mapView.navigationHeaderLayoutGuide.bottomAnchor
                   constant:50]
    setActive:YES];

[[topRightAlternateLayoutGuide.trailingAnchor
    constraintEqualToAnchor:self.view.safeAreaLayoutGuide.trailingAnchor
                   constant:-14]
    setActive:YES];

// Assign the layout guide
_mapView.bottomTrailingButtonsAlternateLayoutGuide = topRightAlternateLayoutGuide;

API Prompt Visibility (expérimentale)

// Additional methods added to GMSNavigatorListener
...
func navigatorWillPresentPrompt(_ navigator: GMSNavigator) {
  // Hide any sort of custom UI element.
}

func navigatorDidDismissPrompt(_ navigator: GMSNavigator) {
  // Show any sort of custom UI element.
}
...

// Additional methods added to GMSNavigatorListener
...
- (void)navigatorWillPresentPrompt:(GMSNavigator *)navigator {
  // Hide any sort of custom UI element.
}

- (void)navigatorDidDismissPrompt:(GMSNavigator *)navigator {
  // Show any sort of custom UI element.
}
...