Composant de navigation dans une application. Ce fragment est le moyen le plus simple d'utiliser la navigation dans une application. Il s'agit d'un wrapper autour d'une vue d'une carte de navigation pour gérer automatiquement les besoins nécessaires au cycle de vie. En tant que fragment, ce composant peut être ajouté au fichier de mise en page d'une activité simplement à l'aide du code XML ci-dessous.
<fragment class="com.google.android.libraries.navigation.SupportNavigationFragment" android:layout_width="match_parent" android:layout_height="match_parent"/>
Récapitulatif des constructeurs publics
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)
|
Afficher |
onCreateView(gonflement LayoutInflater gonflateur, conteneur ViewGroup, bundle savedInstanceState)
|
void | |
void | |
void |
onPause()
|
void |
onResume()
|
void |
onSaveInstanceState(outState du bundle)
|
void |
onStart()
|
void |
onStop()
|
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 forceNightMode)
|
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 lorsque l'interface utilisateur passera en mode Nuit ou le quittera.
|
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 SpeedAlertUiOptions)
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 SupportNavigationFragment ()
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.
Renvoie
- l'objet
Camera
associé à ce fragment.
public NavigationMap getMap ()
Renvoie un objet qui peut être utilisé pour ajouter du contenu à la carte.
public vide onConfigurationChanged (configuration de configuration)
Paramètres
config |
---|
public Afficher onCreateView (gonflement de LayoutInflater gonfler, conteneur ViewGroup, Bundle savedInstanceState)
Paramètres
gonflage | |
---|---|
Conteneur | |
savedInstanceState |
public void onDestroyView ()
public vide onLowMemory ()
public vide onPause ()
public vide onResume ()
public vide onSaveInstanceState (Bundle outState)
Paramètres
outState |
---|
public vide onStart ()
public vide onStop ()
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 forceNightMode)
Paramètres
forceNightMode |
---|
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 lorsque l'interface utilisateur passera en mode Nuit ou le quittera. 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é |
---|
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 activer/désactiver l'icône de limitation de vitesse 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é |
---|
public void setSpeedometerUiOptions (SpeedometerUiOptions SpeedAlertUiOptions)
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
:
Paramètres
speedAlertUiOptions |
---|
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.
Paramètres
activé |
---|
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é |
---|