NavigationView

clase pública NavigationView extiende RelativeLayout

Un elemento View que muestra un mapa para la navegación

Los usuarios de esta clase deben reenviar todos los métodos de ciclo de vida de Activity o Fragment que contienen esta vista a los correspondientes de esta clase. En particular, debes reenviar los siguientes métodos:

Si se agrega el NavView después de que su Activity o Fragment superior ya pasó su ciclo de vida de creación, debes llamar a onCreate(Bundle), onStart() y onResume() de forma manual para inicializarlo de forma correcta. Del mismo modo, si se desconecta un NavView de su Activity o Fragment superior, debes llamar de forma manual a onPause(), onStop() y onDestroy() para evitar filtraciones.

Nota: Te recomendamos que no agregues niños a esta vista.

Todas las llamadas a NavView deben realizarse en el subproceso de IU.

Resumen de clases anidadas

Interfaz NavigationView.OnNightModeChangedListener Interfaz para un objeto de escucha que recibirá una notificación cuando la IU entre al "modo nocturno" o lo salga de él.
Interfaz NavigationView.OnRecenterButtonClickedListener Interfaz para un objeto de escucha que recibirá una notificación cuando se haga clic en el botón de volver a centrar. 

Resumen de la constante heredada

Resumen de campos heredados

Resumen de constructores públicos

NavigationView(contexto contextual)
NavigationView(contexto de contexto, atributos attrs)
NavigationView(contexto de contexto, atributos attrs, int defStyleAttr)

Resumen de métodos públicos

Cámara
getCamera()
Muestra un objeto de cámara que se puede usar para modificar el viewport del mapa.
NavigationMap
getMap()
Muestra un objeto que se puede usar para agregar contenido al mapa.
void
onConfigurationChanged(configuración de configuración)
void
onCreate(Bundle savedInstanceState)
void
onDestroy()
void
onPause()
void
onResume()
void
onSaveInstanceState(Bundle outState)
void
onStart()
void
onStop()
void
onTrimMemory(nivel interno)
void
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode relevanteInfoDisplayModeOverride)
Anula el modo de visualización predeterminado para las solicitudes de oferta de ETA durante la navegación.
void
setCalloutInfoFormatOverride(RouteCalloutInfoFormat relevanteInfoFormatOverride).
Establece el modo de formato de información de texto destacado para los textos destacados de la ruta.
void
setCompassEnabled(booleano habilitado)
Establece si la brújula es visible.
void
setCustomControl(control de vista, posición CustomControlPosition)
Establece una vista de control personalizada que aparecerá en la posición determinada en la IU de navegación.
void
setEtaCardEnabled(booleano habilitado)
Establece si la tarjeta de hora de llegada se mostrará durante la navegación.
void
setForceNightMode(modo nocturno entero)
Establece el ForceNightMode actual.
void
setHeaderEnabled(booleano habilitado)
Establece si el encabezado de navegación paso a paso es visible durante la navegación.
void
setOnNightModeChangedListener(objeto de escucha NavigationView.OnNightModeChangedListener)
Establece un objeto de escucha que recibirá una notificación inmediata sobre el estado actual del "modo nocturno" y cada vez que la IU entre en el "modo nocturno" o salga de él.
void
setOnRecenterButtonClickedListener(objeto de escucha NavigationView.OnRecenterButtonClickedListener)
Establece un objeto de escucha que recibirá una notificación cuando se haga clic en el botón de volver a centrar.
void
setRecenterButtonEnabled(booleano habilitado)
Establece si se debe mostrar el botón Volver a centrar.
void
setSpeedAlertOptions(SpeedAlertOptions speedAlertOptions)
Configura SpeedAlertOptions para personalizar los umbrales de activación de SpeedAlertSeverity.
void
setSpeedLimitIconEnabled(booleano habilitado)
Especifica si se muestra el ícono de límite de velocidad.
void
setSpeedometerIconEnabled(booleano habilitado)
Especifica si se muestra el ícono de velocímetro.
void
setSpeedometerUiOptions(SpeedometerUiOptions speedometerUiOptions)
Establece la configuración de la IU del velocímetro SpeedometerUiOptions en función de SpeedAlertSeverity.
void
setStylingOptions(stylingOptions StylingOptions)
Establece algunas opciones de estilo para la IU de navegación.
void
setTrafficIncidentCardsEnabled(booleano habilitado)
Establece si se deben mostrar las tarjetas de incidentes de tráfico cuando el usuario hace clic en un ícono de incidentes de tráfico.
void
setTrafficPromptsEnabled(booleano habilitado)
Establece si se deben mostrar las solicitudes de tráfico.

Resumen de métodos heredados

Constructores públicos

público NavigationView (contexto de contexto)

Parámetros
Contexto

public NavigationView (Contexto de contexto, Atributos de AttributeSet)

Parámetros
Contexto
attrs

public NavigationView (Context context, AttributeSet attrs, int defStyleAttr)

Parámetros
Contexto
attrs
defStyleAttr

Métodos públicos

public Cámara getCamera ()

Muestra un objeto de cámara que se puede usar para modificar el viewport del mapa. Solo se debe llamar a este método en el subproceso de IU.

Devuelve
  • el objeto Camera asociado con esta vista

public NavigationMap getMap ()

Muestra un objeto que se puede usar para agregar contenido al mapa. Solo se debe llamar a este método en el subproceso de IU.

public void onConfigurationChanged (Configuración)

Parámetros
config

public void onCreate (Bundle savedInstanceState)

Parámetros
savedInstanceState

public void onDestroy ()

public void onPause ()

public void onResume ()

public void onSaveInstanceState (Bundle outState)

Parámetros
outState

public void onStart ()

public void onStop ()

public void onTrimMemory (int level)

Parámetros
level

público void setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode markupInfoDisplayModeOverride)

Anula el modo de visualización predeterminado para las solicitudes de oferta de ETA durante la navegación. Si pasas un valor nulo, se restablecerá el modo de visualización predeterminado.

Parámetros
calloutInfoDisplayModeOverride el nuevo modo de visualización deseado.

public void setCalloutInfoFormatOverride (RouteCalloutInfoFormat relevanteInfoFormatOverride).

Establece el modo de formato de información de texto destacado para los textos destacados de la ruta. Si no se llama a este método, las leyendas seguirán el comportamiento que se define en RouteExtensionInfoFormat.DEFAULT.

Parámetros
calloutInfoFormatOverride el nuevo formato de texto destacado deseado.

public void setCompassEnabled (boolean enabled)

Establece si la brújula es visible. Solo se debe llamar a este método en el subproceso de IU.

Parámetros
habilitado

público void setCustomControl (ver control, posición CustomControlPosition)

Establece una vista de control personalizada que aparecerá en la posición determinada en la IU de navegación. Si ya existe algún control personalizado en la posición indicada, se reemplazará. Si llamas a este método con un valor de control nulo, se quitará el control personalizado en la posición determinada. Si el control ya se agregó en una posición diferente o ya tiene un elemento superior, se ignorará. Solo se debe llamar a este método en el subproceso de IU.

Parámetros
control una vista que se posicionará en la IU de navegación
position Determina dónde se colocará el control personalizado en la IU en relación con los controles integrados.

public void setEtaCardEnabled (boolean enabled)

Establece si la tarjeta de hora de llegada se mostrará durante la navegación. Solo se debe llamar a este método en el subproceso de IU.

Parámetros
habilitado

public void setForceNightMode (int NightMode)

Establece el ForceNightMode actual.

Parámetros
nightMode

public void setHeaderEnabled (boolean enabled)

Establece si el encabezado de navegación paso a paso es visible durante la navegación. Solo se debe llamar a este método en el subproceso de IU.

Parámetros
habilitado

público void setOnNightModeChangedListener (objeto de escucha NavigationView.OnNightModeChangedListener)

Establece un objeto de escucha que recibirá una notificación inmediata sobre el estado actual del "modo nocturno" y cada vez que la IU entre en el "modo nocturno" o salga de él. Solo se debe llamar a este método en el subproceso de IU.

Nota: Para evitar pérdidas de memoria, se debe llamar a setOnNightModeChangedListener(null) cuando ya no se requiera el objeto de escucha.

Parámetros
objeto de escucha un objeto de escucha que recibirá una notificación cuando la IU entre en el modo nocturno o salga de él

público void setOnRecenterButtonClickedListener (objeto de escucha de NavigationView.OnRecenterButtonClickedListener)

Establece un objeto de escucha que recibirá una notificación cuando se haga clic en el botón de volver a centrar. Solo se debe llamar a este método en el subproceso de IU.

Nota: Para evitar pérdidas de memoria, se debe llamar a setOnRecenterButtonClickedListener(null) cuando ya no se requiera el objeto de escucha.

Parámetros
objeto de escucha un objeto de escucha que recibirá una notificación cuando se haga clic en el botón para volver a centrar

public void setRecenterButtonEnabled (boolean enabled)

Establece si se debe mostrar el botón Volver a centrar. Solo se debe llamar a este método en el subproceso de IU.

Parámetros
habilitado

public void setSpeedAlertOptions (SpeedAlertOptions speedAlertOptions)

Configura SpeedAlertOptions para personalizar los umbrales de activación de SpeedAlertSeverity.

Puedes usar este método a fin de personalizar los umbrales de activación de las alertas de velocidad en porcentaje para las alertas MINOR y MAJOR. También puedes usar este método a fin de configurar el tiempo en segundos que se necesita para actualizar las alertas de velocidad de MINOR a MAJOR.

Si estableces un SpeedAlertOptions de null o no estableces ninguno, la alerta de velocidad predeterminada de NavSDK mostrará lo siguiente: la alerta de velocidad muestra texto rojo con fondo blanco o oscuro para el modo diurno/nocturno, respectivamente, cuando la velocidad sea inferior a 8 km/h o 10 km/h por encima del límite de velocidad, y muestra texto en blanco en un fondo rojo cuando el vehículo supera los 8 km/h o 10 km/h.

Parámetros
speedAlertOptions

public void setSpeedLimitIconEnabled (boolean enabled)

Especifica si se muestra el ícono de límite de velocidad. Solo debes llamar a este método en el subproceso de IU.

Cuando se habilita esta opción, aparece un ícono de límite de velocidad que indica el límite de velocidad de la ruta en la esquina inferior de inicio durante la guía. El ícono solo aparece en las ubicaciones donde hay disponibles datos confiables sobre el límite de velocidad. Cuando el ícono del velocímetro es visible, significa que están adjuntos.

Si el botón de volver a centrar está habilitado, el ícono de límite de velocidad se ocultará temporalmente cuando se muestre.

Nota: Los conductores deben seguir todas las señales de tránsito y usar el ícono de límite de velocidad solo como referencia. No se puede garantizar la precisión de los datos sobre el límite de velocidad. Puedes informar errores en nuestros datos sobre el límite de velocidad presentando un caso en el Portal de asistencia de Google Cloud.

Parámetros
habilitado
Consulta también

public void setSpeedometerIconEnabled (boolean enabled)

Especifica si se muestra el ícono de velocímetro. Solo debes llamar a este método en el subproceso de IU.

Cuando se habilita, aparece un ícono de velocímetro que indica la velocidad del vehículo en la esquina inferior de inicio durante la guía. Cuando el ícono de límite de velocidad es visible, se adjuntan y, luego, el velocímetro puede tener diferentes colores para el texto y el fondo, según la gravedad del límite de velocidad.

Habilitar el ícono de Speedomter también habilita el ícono de límite de velocidad por completo. Sin embargo, puedes usar setSpeedLimitIconEnabled(boolean) para inhabilitar o habilitar el ícono de límite de velocidad por separado.

Si está habilitado, el ícono de velocímetro se ocultará temporalmente cuando aparezca.

Parámetros
habilitado
Consulta también

public void setSpeedometerUiOptions (SpeedometerUiOptions speedometerUiOptions)

Establece la configuración de la IU del velocímetro SpeedometerUiOptions en función de SpeedAlertSeverity. Solo debes llamar a este método en el subproceso de IU.

Si configuras un SpeedometerUiOptions de null, borrarás el anterior si se configuró. Cuando no se configura un SpeedometerUiOptions, la IU del velocímetro recurre a las configuraciones predeterminadas de NavSDK para las alertas de velocidad de diferentes SpeedAlertSeverity:

  • Alerta de velocidad de MINOR en modo diurno: texto rojo con fondo blanco
  • Alerta de velocidad de MINOR en modo nocturno: texto rojo con fondo oscuro
  • Alerta de velocidad de MAJOR en modo diurno: texto blanco con fondo rojo
  • Alerta de velocidad de MAJOR en modo nocturno: texto blanco con fondo rojo

Parámetros
speedometerUiOptions

public void setStylingOptions (StylingOptions stylingOptions)

Establece algunas opciones de estilo para la IU de navegación. Solo se debe llamar a este método en el subproceso de IU.

Parámetros
stylingOptions

public void setTrafficIncidentCardsEnabled (boolean enabled)

Establece si se deben mostrar las tarjetas de incidentes de tráfico cuando el usuario hace clic en un ícono de incidentes de tráfico. Solo se debe llamar a este método en el subproceso de IU.

Ten en cuenta que, cuando se ejecuta la navegación guiada, se muestran los detalles del incidente de tráfico en las instrucciones. Para inhabilitar los detalles de incidentes de tráfico durante la navegación, se debe usar setTrafficPromptsEnabled(boolean).

Parámetros
habilitado
Consulta también

public void setTrafficPromptsEnabled (boolean enabled)

Establece si se deben mostrar las solicitudes de tráfico. Los mensajes de tráfico aparecen periódicamente para actualizar al usuario sobre las condiciones del tráfico durante la navegación. Solo se debe llamar a este método en el subproceso de IU.

Parámetros
habilitado