Vue Navigation

classe publique NavigationView étend RelativeLayout

Vue qui affiche une carte pour la navigation.

Les utilisateurs de cette classe doivent transmettre toutes les méthodes de cycle de vie de l'élément Activity ou Fragment contenant cette vue aux méthodes correspondantes de cette classe. Vous devez notamment transférer les données des méthodes suivantes:

Si le NavView est ajouté après que son Activity ou Fragment parent a terminé son cycle de création, vous devez appeler onCreate(Bundle), onStart() et onResume() manuellement pour l'initialiser correctement. De même, si un NavView est dissocié de son Activity ou Fragment parent, vous devez appeler manuellement onPause(), onStop() et onDestroy() pour éviter les fuites.

Remarque: Nous vous recommandons de ne pas ajouter d'enfants à cette vue.

Tous les appels à NavView doivent être effectués sur le thread UI.

Récapitulatif des classes imbriquées

interface NavigationView.OnNightModeChangedListener Interface d'un écouteur qui sera averti lorsque l'interface utilisateur sera en mode Nuit ou en sortira.
interface NavigationView.OnRecenterButtonClickedListener Interface d'un écouteur qui sera averti lorsque l'utilisateur cliquera sur le bouton de recentrage. 

Récapitulatif des constantes héritées

Récapitulatif des champs hérités

Récapitulatif des constructeurs publics

NavigationView(contexte contextuel)
NavigationView(contexte de contexte, attributs AttributeSet)
NavigationView(contexte de contexte, attributs AttributeSet, int defStyleAttr)

Récapitulatif des méthodes publiques

Appareil photo
getCamera()
Renvoie un objet appareil photo qui peut être utilisé pour modifier la fenêtre d'affichage de la carte.
NavigationMap
getMap()
Renvoie un objet qui peut être utilisé pour ajouter du contenu à la carte.
void
onConfigurationChanged(configuration de la configuration)
void
onCreate(Bundle savedInstanceState)
void
onDestroy()
void
onPause()
void
onResume()
void
onSaveInstanceState(outState du bundle)
void
onStart()
void
onStop()
void
onTrimMemory(niveau entier)
void
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
Remplace le mode d'affichage par défaut pour les appels d'heure d'arrivée prévue pendant la navigation.
void
setCalloutInfoFormatOverride(RouteCalloutInfoFormat calloutInfoFormatOverride)
Définit le format des informations sur les accroches pour les itinéraires.
void
setCompassEnabled(valeur booléenne activée)
Détermine si la boussole est visible.
void
setCustomControl(commande d'affichage, position de CustomControlPosition)
Définit une vue des commandes personnalisée qui s'affichera à la position indiquée dans l'interface utilisateur de navigation.
void
setEtaCardEnabled(valeur booléenne activée)
Détermine si la carte de l'heure d'arrivée prévue est visible pendant la navigation.
void
setForceNightMode(int nightMode)
Définit la ForceNightMode actuelle.
void
setHeaderEnabled(booléen activé)
Détermine si l'en-tête de la navigation détaillée est visible pendant la navigation.
void
setOnNightModeChangedListener(écouteur NavigationView.OnNightModeChangedListener)
Définit un écouteur qui sera averti immédiatement de l'état actuel du "mode Nuit" et de chaque fois que l'interface utilisateur activera ou quittera le "mode Nuit".
void
setOnRecenterButtonClickedListener(écouteur NavigationView.OnRecenterButtonClickedListener)
Définit un écouteur qui sera averti lorsque l'utilisateur cliquera sur le bouton de recentrage.
void
setRecenterButtonEnabled(booléen activé)
Détermine si le bouton de recentrage doit être affiché.
void
setSpeedAlertOptions(SpeedAlertOptions SpeedAlertOptions)
Définit SpeedAlertOptions pour personnaliser les seuils de déclenchement pour les SpeedAlertSeverity.
void
setSpeedLimitIconEnabled(valeur booléenne activée)
Indique si l'icône de limitation de vitesse doit être affichée.
void
setSpeedometerIconEnabled(valeur booléenne activée)
Indique si l'icône de compteur de vitesse est affichée.
void
setSpeedometerUiOptions(SpeedometerUiOptions SpeedometerUiOptions
Définit la configuration de l'interface utilisateur du compteur de vitesse SpeedometerUiOptions en fonction de SpeedAlertSeverity.
void
setStylingOptions(StylingOptions stylingOptions)
Définit des options de style pour l'interface utilisateur de navigation.
void
setTrafficIncidentCardsEnabled(valeur booléenne activée)
Détermine si les fiches sur les incidents de circulation doivent être affichées lorsque l'utilisateur clique sur une icône d'incident de circulation.
void
setTrafficPromptsEnabled(booléen activé)
Détermine si les invites liées au trafic doivent être affichées.

Récapitulatif des méthodes héritées

Constructeurs publics

public NavigationView (Contexte)

Paramètres
context

public NavigationView (Contexte contextuel, attributs AttributeSet)

Paramètres
context
attrs

public NavigationView (Contexte, AttributeSet attrs, int defStyleAttr)

Paramètres
context
attrs
defStyleAttr

Méthodes publiques

public Caméra getCamera ()

Renvoie un objet appareil photo qui peut être utilisé pour modifier la fenêtre d'affichage de la carte. Cette méthode ne doit être appelée que sur le thread UI.

Renvoie
  • l'objet Camera associé à cette vue

public NavigationMap getMap ()

Renvoie un objet qui peut être utilisé pour ajouter du contenu à la carte. Cette méthode ne doit être appelée que sur le thread UI.

public vide onConfigurationChanged (configuration de configuration)

Paramètres
config

public vide onCreate (Bundle savedInstanceState)

Paramètres
savedInstanceState

public void onDestroy ()

public vide onPause ()

public vide onResume ()

public vide onSaveInstanceState (Bundle outState)

Paramètres
outState

public vide onStart ()

public vide onStop ()

public vide onTrimMemory (niveau d'int)

Paramètres
level

public vide setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)

Remplace le mode d'affichage par défaut pour les appels d'heure d'arrivée prévue pendant la navigation. La transmission d'une valeur nulle réinitialise le mode d'affichage par défaut.

Paramètres
calloutInfoDisplayModeOverride le nouveau mode d'affichage souhaité.

public void setCalloutInfoFormatOverride (RouteCalloutInfoFormat calloutInfoFormatOverride)

Définit le format des informations sur les accroches pour les itinéraires. Si cette méthode n'est pas appelée, les accroches suivront le comportement défini par RouteCalloutInfoFormat.DEFAULT.

Paramètres
calloutInfoFormatOverride le nouveau format d'accroche souhaité.

public vide setCompassEnabled (boolean enabled)

Détermine si la boussole est visible. Cette méthode ne doit être appelée que sur le thread UI.

Paramètres
activé

public void setCustomControl (commande d'affichage, position CustomControlPosition)

Définit une vue des commandes personnalisée qui s'affichera à la position indiquée dans l'interface utilisateur de navigation. S'il existe déjà une commande personnalisée à la position donnée, elle sera remplacée. Si vous appelez cette méthode avec une valeur de commande nulle, la commande personnalisée à la position indiquée sera supprimée. Si la commande a déjà été ajoutée à une autre position ou a déjà un parent, elle sera ignorée. Cette méthode ne doit être appelée que sur le thread UI.

Paramètres
contrôle Une vue qui sera positionnée dans l'interface utilisateur de navigation
position Détermine l'emplacement de la commande personnalisée dans l'interface utilisateur par rapport aux commandes intégrées.

public vide setEtaCardEnabled (boolean enabled)

Détermine si la carte de l'heure d'arrivée prévue est visible pendant la navigation. Cette méthode ne doit être appelée que sur le thread UI.

Paramètres
activé

public void setForceNightMode (int nightMode)

Définit la ForceNightMode actuelle.

Paramètres
nightMode

public vide setHeaderEnabled (boolean enabled)

Détermine si l'en-tête de la navigation détaillée est visible pendant la navigation. Cette méthode ne doit être appelée que sur le thread UI.

Paramètres
activé

public void setOnNightModeChangedListener (écouteur NavigationView.OnNightModeChangedListener)

Définit un écouteur qui sera averti immédiatement de l'état actuel du "mode Nuit" et de chaque fois que l'interface utilisateur activera ou quittera le "mode Nuit". Cette méthode ne doit être appelée que sur le thread UI.

Remarque: Pour éviter les fuites de mémoire, setOnNightModeChangedListener(null) doit être appelé lorsque l'écouteur n'est plus nécessaire.

Paramètres
écouteur Un écouteur qui sera averti lorsque l'UI passera en mode Nuit ou le quittera

public void setOnRecenterButtonClickedListener (écouteur NavigationView.OnRecenterButtonClickedListener)

Définit un écouteur qui sera averti lorsque l'utilisateur cliquera sur le bouton de recentrage. Cette méthode ne doit être appelée que sur le thread UI.

Remarque: Pour éviter les fuites de mémoire, setOnRecenterButtonClickedListener(null) doit être appelé lorsque l'écouteur n'est plus nécessaire.

Paramètres
écouteur Un écouteur qui sera averti lorsque l'utilisateur cliquera sur le bouton de recentrage

public void setRecenterButtonEnabled (boolean enabled)

Détermine si le bouton de recentrage doit être affiché. Cette méthode ne doit être appelée que sur le thread UI.

Paramètres
activé

public void setSpeedAlertOptions (SpeedAlertOptions SpeedAlertOptions)

Définit SpeedAlertOptions pour personnaliser les seuils de déclenchement pour les SpeedAlertSeverity.

Cette méthode permet de personnaliser les seuils de déclenchement des alertes de vitesse en pourcentage pour les alertes MINOR et MAJOR. Vous pouvez également utiliser cette méthode pour configurer le délai, en secondes, nécessaire pour faire passer les alertes de vitesse de MINOR à MAJOR.

Si vous définissez une SpeedAlertOptions sur null ou n'en définissez aucune, l'alerte de vitesse par défaut du NavSDK affiche un texte en rouge sur fond blanc/sombre en mode Jour/Nuit, respectivement lorsque la vitesse est inférieure à 5 mph ou 10 km/h au-dessus de la limite de vitesse, et s'affiche en blanc sur fond rouge si la vitesse est supérieure à 5 mph ou 10 km/h.

Paramètres
speedAlertOptions

public vide setSpeedLimitIconEnabled (boolean enabled)

Indique si l'icône de limitation de vitesse doit être affichée. N'appelez cette méthode que sur le thread UI.

Lorsque cette option est activée, une icône de limitation de vitesse indiquant la limitation de vitesse de la route s'affiche dans l'angle de départ du trajet en bas de l'écran. L'icône ne s'affiche que dans les endroits où des données fiables sur les limitations de vitesse sont disponibles. Lorsque l'icône du compteur de vitesse est visible, cela signifie qu'ils sont joints.

Si le bouton de recentrage est activé, l'icône de limite de vitesse est temporairement masquée lorsque le bouton de recentrage est affiché.

Remarque: Les conducteurs doivent respecter tous les panneaux de signalisation sur la route et n'utiliser l'icône de limitation de vitesse qu'à titre indicatif. L'exactitude des données sur les limitations de vitesse ne peut pas être garantie. Vous pouvez signaler des inexactitudes dans les données sur les limites de vitesse en envoyant une demande sur le portail d'assistance Google Cloud.

Paramètres
activé
Voir également

public void setSpeedometerIconEnabled (boolean enabled)

Indique si l'icône de compteur de vitesse est affichée. N'appelez cette méthode que sur le thread UI.

Lorsque cette option est activée, une icône de compteur de vitesse indiquant la vitesse du véhicule s'affiche dans l'angle de démarrage inférieur pendant le guidage. Lorsque l'icône de limite de vitesse est visible, ils sont joints. Le texte et l'arrière-plan du compteur de vitesse peuvent alors être de différentes couleurs selon la gravité de la vitesse.

L'activation de l'icône de limitation de vitesse active également l'icône de limitation de vitesse, mais vous pouvez utiliser setSpeedLimitIconEnabled(boolean) pour désactiver/activer cette icône séparément.

Si le bouton de recentrage est activé, l'icône du compteur de vitesse est temporairement masquée lorsque ce bouton s'affiche.

Paramètres
activé
Voir également

public void setSpeedometerUiOptions (SpeedometerUiOptions SpeedometerUiOptions)

Définit la configuration de l'interface utilisateur du compteur de vitesse SpeedometerUiOptions en fonction de SpeedAlertSeverity. N'appelez cette méthode que sur le thread UI.

En définissant un SpeedometerUiOptions null, vous effacez le précédent s'il est défini. Si aucun SpeedometerUiOptions n'est configuré, l'interface utilisateur du compteur de vitesse utilise les configurations par défaut du NavSDK pour les alertes de vitesse de différentes SpeedAlertSeverity:

  • Alerte de vitesse MINOR en mode Jour: texte rouge sur fond blanc
  • Alerte de vitesse MINOR en mode Nuit: texte rouge sur fond sombre
  • Alerte de vitesse MAJOR en mode Jour: texte blanc sur fond rouge
  • Alerte de vitesse MAJOR en mode Nuit: texte blanc sur fond rouge

Paramètres
speedometerUiOptions

public vide setStylingOptions (StylingOptions stylingOptions)

Définit des options de style pour l'interface utilisateur de navigation. Cette méthode ne doit être appelée que sur le thread UI.

Paramètres
stylingOptions

public void setTrafficIncidentCardsEnabled (boolean enabled)

Détermine si les fiches sur les incidents de circulation doivent être affichées lorsque l'utilisateur clique sur une icône d'incident de circulation. Cette méthode ne doit être appelée que sur le thread UI.

Notez que lorsque la navigation guidée est en cours d'exécution, les détails de l'incident de circulation s'affichent dans les invites. Pour désactiver les informations sur les incidents de circulation pendant la navigation, utilisez plutôt setTrafficPromptsEnabled(boolean).

Paramètres
activé
Voir également

public void setTrafficPromptsEnabled (boolean enabled)

Détermine si les invites liées au trafic doivent être affichées. Des invites de circulation s'affichent régulièrement pour informer l'utilisateur des conditions de circulation pendant la navigation. Cette méthode ne doit être appelée que sur le thread UI.

Paramètres
activé