Sélectionnez une plate-forme : Android iOS

Configurer les perturbations en temps réel

Les perturbations en temps réel sont un ensemble de fonctionnalités qui alertent les utilisateurs sur les perturbations sur leur itinéraire et leur permettent de signaler et de vérifier les perturbations qu'ils rencontrent. Voici quelques exemples de perturbations : accidents de voiture, embouteillages, présence de la police et de radars, travaux, 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 pour les applications qui utilisent des UI de navigation personnalisées.

Remarque : La disponibilité des fonctionnalités d'informations sur les perturbations en temps réel et des types de perturbations spécifiques varie selon la région. Pour en savoir plus, consultez Couverture géographique du SDK Navigation. De plus, les perturbations en temps réel ne sont pas disponibles sur Android Auto.

Fonctionnalités de perturbation en temps réel

Le SDK Navigation inclut les fonctionnalités d'interruption en temps réel suivantes dans l'expérience de navigation de base :

• Des encadrés interactifs sur les perturbations le long des itinéraires.
• Alertes automatiques sur les perturbations avec possibilité de voter pendant la navigation active.
• Signaler une perturbation 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.

Informations interactives sur les perturbations le long des 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 d'encadrés le long de l'itinéraire. Lorsque vous activez le calque de trafic, les perturbations hors itinéraire s'affichent également sur la carte. Les encadrés incluent une icône qui indique le type de perturbation.

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

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

Remarques :

• setTrafficPromptsEnabled ne contrôle que l'affichage des encadrés pour les perturbations signalées par les utilisateurs. Certains types de perturbations, comme les routes fermées par les autorités de la circulation, peuvent toujours être visibles même lorsque setTrafficPromptsEnabled est défini sur false.
• Les accroches de routes fermées s'affichent sur l'itinéraire actuel et les itinéraires bis.

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

En appuyant sur un message d'interruption, vous ouvrez une fiche d'informations contenant plus de détails. Cela s'applique aux alertes sur l'itinéraire et hors itinéraire, bien que les alertes hors itinéraire n'apparaissent que si la couche de trafic est activée. La fiche indique le type de perturbation, la date de la dernière signalisation et parfois une option permettant de voter pour indiquer si la perturbation est toujours présente. Le type de fiche info et ses options de configuration varient selon que l'utilisateur est en mode navigation active ou non.

Fiches d'informations sur les aperçus d'itinéraire, avant de démarrer la navigation active

Avant de démarrer la navigation active, les utilisateurs peuvent appuyer sur un encart sur le trajet ou hors trajet sur la carte ou dans l'aperçu de l'itinéraire pour ouvrir une fiche d'informations. Les alertes hors itinéraire nécessitent l'activation de la couche de trafic. La fiche d'informations fournit plus de détails sur la perturbation.

Vous pouvez contrôler la possibilité pour les utilisateurs d'appuyer sur les encadrés d'interruption sur les aperçus d'itinéraire pour afficher plus d'informations à l'aide de setTrafficIncidentCardsEnabled.

// Using the SupportNavigationFragment
mNavFragment.setTrafficIncidentCardsEnabled(true);

// Using the NavigationView
navigationView.setTrafficIncidentCardsEnabled(true);

Fiches d'informations pendant la navigation active

Pendant la navigation active, les utilisateurs peuvent appuyer sur un encart d'information sur un problème sur l'itinéraire ou en dehors de l'itinéraire pour ouvrir une fiche d'informations. La fiche indique le type de perturbation et la dernière heure signalée. Elle inclut des boutons permettant aux utilisateurs d'indiquer si la perturbation est toujours présente.

Les utilisateurs peuvent voter pour les perturbations sur l'itinéraire et en dehors de l'itinéraire dans un rayon de 5 km, à l'exception des routes fermées. Google traite ces votes pour déterminer s'il doit continuer à afficher l'indisponibilité. Les votes peuvent également apparaître sur la carte pour les autres utilisateurs du SDK Maps et Navigation.

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

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

Remarque : setTrafficPromptsEnabled ne contrôle que l'affichage des accroches pour les perturbations signalées par les utilisateurs. Certains types de perturbations, comme les routes fermées par les autorités de la circulation, peuvent toujours être visibles même lorsque setTrafficPromptsEnabled est défini sur false.

Alertes de perturbations 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 indiquer 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 Maps et Navigation. Ils peuvent également servir à déterminer s'il faut continuer à afficher la perturbation.

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

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

Remarque : Lorsqu'un utilisateur s'approche d'une perturbation sur un itinéraire pendant la navigation active, la perturbation est annoncée par une alerte audio. Les alertes audio ne sont pas concernées par la configuration de l'affichage des invites. Toutefois, vous pouvez configurer toutes les invites vocales pendant la navigation active à l'aide de AudioGuidance.

Signaler une perturbation pendant la navigation active

En mode navigation active, un bouton s'affiche dans l'UI de navigation. Il permet aux utilisateurs de signaler de nouveaux problèmes 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 des SDK Google Maps et Navigation.

Si vous signalez une route fermée, un itinéraire alternatif peut être proposé pour contourner la section bloquée. L'utilisateur est alors invité à confirmer ou à refuser le nouvel itinéraire. Cette fonctionnalité est soumise à disponibilité.

Remarque : Lorsqu'un utilisateur démarre la navigation active pour la première fois, le bouton de signalement s'affiche à l'état développé avec le libellé "Signaler". Le bouton se réduit ensuite pour n'afficher que l'icône.

Afficher ou masquer le bouton "Rapports standards"

Vous pouvez configurer la visibilité du bouton de reporting standard pendant la navigation active à l'aide de setReportIncidentButtonEnabled .

// Enables the incident reporting button to show in situations where incident
// reporting is possible.

// Using the SupportNavigationFragment
mNavFragment.setReportIncidentButtonEnabled(true);

// Using the NavigationView
navigationView.setReportIncidentButtonEnabled(true);

Ajouter un bouton de signalement personnalisé

Au lieu du bouton standard de signalement des perturbations, vous pouvez ajouter un bouton personnalisé à l'UI de navigation. Lorsque l'utilisateur clique sur le bouton personnalisé, vous pouvez déclencher l'affichage du menu de signalement en appelant la méthode showReportIncidentsPanel. Avant d'ajouter un bouton de signalement personnalisé, vérifiez que l'application est en navigation active et que l'utilisateur se trouve dans un pays où le signalement est activé en appelant isIncidentReportingAvailable. Si l'une de ces conditions n'est pas remplie, le menu de création de rapports n'apparaîtra pas.

Remarque : Si vous implémentez un bouton de signalement personnalisé, assurez-vous de définir setReportIncidentButtonEnabled sur false pour masquer le bouton de signalement standard.

  Button customReportIncidentButton = findViewById(R.id.custom_reporting_button);
  
  // Check if reporting is available before displaying your button
  customReportIncidentButton.setVisibility(
      navigationView.isReportingAvailable ? View.VISIBLE : View.GONE);
  
  // Trigger the reporting flow if the button is clicked
  customReportIncidentButton.setOnClickListener(v ->
      navigationView.showReportIncidentsPanel());
  

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.

Remarque : Pour en savoir plus sur l'utilisation des éléments d'UI personnalisés, consultez Modifier l'UI de navigation.

Positionnement du bouton de signalement

Par défaut, le bouton de signalement des perturbations est positionné en bas/à l'angle de la carte (à droite pour les langues qui se lisent de gauche à droite et à gauche pour celles qui se lisent de droite à gauche). Si vous devez déplacer le bouton de signalement pour faire de la place aux éléments d'interface utilisateur personnalisés, ajoutez un contrôle personnalisé BOTTOM_END_BELOW ou FOOTER, qui déplacera le bouton vers le haut de l'écran. Placer vos propres UI personnalisées dans les commandes personnalisées permet également de s'assurer que toutes les invites affichées par le SDK Navigation sont correctement superposées à vos éléments d'UI personnalisés lorsqu'elles sont affichées. Si vous ne pouvez pas utiliser de commandes personnalisées, utilisez l'API Prompt Visibility pour gérer les éventuels conflits d'UI.

Remarque : La commande personnalisée FOOTER n'affecte que la position du bouton de signalement en orientation portrait.

API Prompt Visibility (expérimentale)

L'API Prompt Visibility vous aide à éviter les conflits entre les éléments d'interface utilisateur générés par le SDK Navigation et vos propres éléments d'interface utilisateur personnalisés. Pour ce faire, elle ajoute un écouteur pour recevoir un rappel avant l'apparition d'un élément d'interface utilisateur du SDK Navigation et dès que l'élément est supprimé. Vous pouvez recevoir des rappels pour les éléments de perturbation en temps réel, y compris les fiches d'informations, les invites et le menu de signalement des perturbations, ainsi que pour d'autres notifications générées par le SDK Navigation.

// Sample listener
val listener: PromptVisibilityChangedListener = { isVisible ->
	if (isVisible) {
		customFab.visibility = false
		customFooter.visibility = false
		moveSomeOtherThingsAround()
	} else {
		customFab.visibility = true
		customFooter.visibility = true
		moveSomeThingsBackToWhereTheyWereBefore()
	}
}

// Inside onCreate()
navigationView.addPromptVisibilityChangedListener(listener)

// Inside onDestroy()
navigationView.removePromptVisibilityChangedListener(listener)