Navegador

interfaz pública Navigator

Es un singleton que proporciona métodos para controlar la navegación.

Se garantiza que todos los métodos son seguros para los subprocesos, excepto setAudioOrientation y setHeadsUpNotificationEnabled, que deben llamarse en el subproceso de IU.

Resumen de clases anidadas

Interfaz	Navigator.ArrivalListener		Define firmas para los métodos a los que se llama cuando el controlador llega a un punto de referencia.
@interfaz	Navigator.AudioGuidance		AudioDirection es un conjunto de marcas que se usan para especificar qué tipos de alertas y guías de audio se usan durante la navegación.
Interfaz	Navigator.RemainingTimeOrDistanceChangedListener		Define firmas para los métodos que se llaman cuando cambia el tiempo restante o la distancia al siguiente destino.
Interfaz	Navigator.RouteChangedListener		Define firmas para los métodos que se llaman cuando cambia la ruta.
enum	Navigator.RouteStatus		RouteStatus es un código de estado que representa el resultado de un cálculo de ruta, al que se accede a través de la interfaz Future que muestra setDestination(Waypoint).

Resumen de métodos públicos

abstracto void	cleanup() Limpia el estado interno de Navigator.
abstracto void	clearDestinations() Borra todos los destinos establecidos previamente y quita del mapa las rutas calculadas.
abstracto void	clearLicensePlateRestrictionInfo() Borra la información de la matrícula del conductor actual.
abstracto void	clearRemainingTimeOrDistanceChangedListener() Borra el objeto de escucha para los cambios en el tiempo o la distancia restantes.
resumen Punto de referencia	continueToNextDestination() Quita el destino actual.
resumen ListenableResultFuture<RouteInfo>	fetchRouteInfo(punto de referencia Waypoint, RoutingOptions planificación de opciones) Muestra información de las rutas según cada valor de RoutingOptions.RoutingStrategy.
resumen RouteSegment	getCurrentRouteSegment() Muestra el tramo actual del viaje.
resumen TimeAndDistance	getCurrentTimeAndDistance() Muestra el tiempo y la distancia estimados desde la posición actual hasta el destino actual.
resumen List<RouteSegment>	getRouteSegments() Muestra una lista de los tramos de ruta.
abstracto Simulador	getSimulator() Muestra un objeto simulador para usar durante las pruebas.
Resumen List<TimeAndDistance>	getTimeAndDistanceList() Muestra una lista de horarios y distancias correspondientes a cada destino en la ruta actual, lo que representa el tiempo estimado y la distancia desde la posición actual hasta cada destino.
Resumen List<LatLng>	getTraveledRoute() Muestra la ruta recorrida hasta el momento durante esta sesión de orientación (desde la última llamada a startGuidance()).
abstracto boolean	isGuidanceRunning() Muestra true si la guía se está ejecutando actualmente.
abstracto void	setArrivalListener(objeto de escucha Navigator.ArrivalListener) Registra un objeto de escucha para los eventos de llegada.
abstracto void	setAudioGuidance(orientación interna) Establece los tipos de indicaciones de audio (incluida la vibración) que se habilitan.
resumen ListenableResultFuture<Navigator.RouteStatus>	setDestination(destino Punto de referencia, RoutingOptions planificación de ruta, DisplayOptions displayOptions) Establece un solo destino para la navegación y anula cualquier destino configurado con anterioridad.
resumen ListenableResultFuture<Navigator.RouteStatus>	setDestination(destino Waypoint, opciones RoutingOptions) Establece un solo destino para la navegación y anula cualquier destino configurado con anterioridad.
resumen ListenableResultFuture<Navigator.RouteStatus>	setDestination(destino del punto de referencia) Establece un solo destino para la navegación y anula cualquier destino configurado con anterioridad.
resumen ListenableResultFuture<Navigator.RouteStatus>	setDestinations(Destinos de Lista<Waypoint>, opciones de RoutingOptions) Configura varios destinos para la navegación y anula cualquier destino configurado con anterioridad.
resumen ListenableResultFuture<Navigator.RouteStatus>	setDestinations(Destinos de lista<Waypoint>, RoutingOptions planificación de rutas, DisplayOptions displayOptions) Configura varios destinos para la navegación y anula cualquier destino configurado con anterioridad.
resumen ListenableResultFuture<Navigator.RouteStatus>	setDestinations(List<Waypoint> destinos) Configura varios destinos para la navegación y anula cualquier destino configurado con anterioridad.
abstracto void	setHeadsUpNotificationEnabled(booleano habilitado) Establece si se deben mostrar las notificaciones de atención.
abstracto void	setLicensePlateRestrictionInfo(intrawLicensePlateLastDigit, String LicensePlateCountryCode) Establece la información de la matrícula del conductor actual.
abstracto void	setRemainingTimeOrDistanceChangedListener(int timeChangeThresholdSeconds, intDistanceChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener) Registra un objeto de escucha para cuando el tiempo o la distancia restante al destino cambia en más de un umbral especificado.
abstracto void	setRouteChangedListener(objeto de escucha Navigator.RouteChangedListener) Registra un objeto de escucha para los eventos de cambio de ruta.
abstracto void	setSpeedingListener(SpeedingListener speedingListener) Registra un SpeedingListener para el porcentaje por encima del límite de velocidad al que conduce el conductor actualmente.
abstracto void	startGuidance(reanudación del intent) Es igual que startGuidance(), pero se especifica un intent que se puede usar para reanudar la app desde la notificación de la barra de estado del navegador.
abstracto void	startGuidance() Si se estableció un destino y se creó una ruta para él, se inicia una guía de navegación paso a paso para la ruta.
abstracto void	stopGuidance() Detiene la guía de navegación paso a paso.

Métodos públicos

resumen público void limpieza ()

Limpia el estado interno de Navigator.

Nota: Si llamas a este método, se cancelarán las solicitudes pendientes a setDestinations(List).

public abstract void clearDestinations ()

Borra todos los destinos establecidos previamente y quita del mapa las rutas calculadas. Si la navegación está en ejecución, esta la detendrá automáticamente.

público abstracto void clearLicensePlateRestrictionInfo ()

Borra la información de la matrícula del conductor actual. Esto solo se aplicará a las llamadas setDestination que se realicen después de que se haya configurado este valor.

público abstracto void clearRemainingTimeOrDistanceChangedListener ()

Borra el objeto de escucha para los cambios en el tiempo o la distancia restantes.

público abstracto Punto de referencia continueToNextDestination ()

Quita el destino actual. Después de esta llamada, la guía se orientará al siguiente destino, y no habrá información disponible sobre el destino anterior.

Devuelve

• la guía de puntos de referencia se dirige ahora o nulo si no quedan más puntos de referencia

público abstracto ListenableResultFuture<RouteInfo> fetchRouteInfo (Waypoint punto de referencia, RoutingOptions planificación de ruta)

Muestra información de las rutas según cada valor de RoutingOptions.RoutingStrategy. RoutingOptions.RoutingStrategy se ignora, ya que este método muestra la información de ruta de todas las estrategias de enrutamiento.

Nota: Esto se vuelve a calcular en cada llamada y es posible que no coincida con las rutas que utiliza la navegación actualmente, ya que es posible que el tráfico y otros factores se hayan actualizado mientras tanto.

Parámetros

punto de referencia	el punto de referencia de destino para la ruta
routingOptions	las opciones usadas para recuperar la información de la ruta

Devuelve

• el futuro que se muestra

resumen público RouteSegment getCurrentRouteSegment ()

Muestra el tramo actual del viaje. El segmento de la ruta tendrá su posición inicial como la posición conocida más reciente (ajuste en la ruta) del dispositivo.

Devuelve

• un objeto de segmento de ruta, o bien null si no hay una ruta actual

resumen público TimeAndDistance getCurrentTimeAndDistance ()

Muestra el tiempo y la distancia estimados desde la posición actual hasta el destino actual.

Devuelve

• un objeto de tiempo y distancia, o bien null si no hay una ruta actual

public abstract List<RouteSegment> getRouteSegments ()

Muestra una lista de los tramos de ruta. El destino de cada segmento que se muestre corresponderá a un destino establecido por setDestination.

público abstracto Simulador getSimulator ()

Muestra un objeto simulador para usar durante las pruebas.

public abstract List<TimeAndDistance> getTimeAndDistanceList ()

Muestra una lista de horarios y distancias correspondientes a cada destino en la ruta actual, lo que representa el tiempo estimado y la distancia desde la posición actual hasta cada destino.

resumen público List<LatLng> getTraveledRoute ()

Muestra la ruta recorrida hasta el momento durante esta sesión de orientación (desde la última llamada a startGuidance()). La ruta registrada consta de las ubicaciones ajustadas por la ruta como las mostraría RoadSnappedLocationProvider y simplificadas para quitar puntos redundantes, por ejemplo, convertir puntos colineales consecutivos en un solo segmento de línea.

público abstracto booleano isGuidanceRunning ()

Muestra true si la guía se está ejecutando actualmente. Ten en cuenta que la guía solo se ejecutará una vez que se calcule una ruta a un destino y se llame a startGuidance().

público abstracto void setArrivalListener (objeto de escucha de Navigator.ArrivalListener)

Registra un objeto de escucha para los eventos de llegada. Anula cualquier objeto de escucha que se haya registrado con anterioridad.

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

Parámetros

objeto de escucha	que el objeto de escucha registre. Se puede configurar en null para borrar un objeto de escucha registrado previamente.

público abstracto void setAudioGuidance (int guía)

Establece los tipos de indicaciones de audio (incluida la vibración) que se habilitan. De forma predeterminada, están habilitadas las opciones de vibración, voz y voz por Bluetooth (si están disponibles).

Se debe llamar a este método en el subproceso de IU.

Parámetros

Ayuda	una combinación de marcas Navigator.AudioGuidance que especifican qué tipos de indicaciones de audio se deben habilitar

publicListenableResultFutureNavigator.RouteStatus setDestinationRoutingOptionsDisplayOptions

Establece un solo destino para la navegación y anula cualquier destino configurado con anterioridad. El valor futuro que se muestra se establecerá en OK si se encuentra una ruta desde la ubicación del usuario hasta el destino determinado.

Parámetros

destino	el nuevo destino que se configurará
routingOptions	las opciones que se usarán para generar la ruta
displayOptions	las opciones que se usarán para mostrar la ruta

Devuelve

• el futuro que se muestra

Arroja

NullPointerException	si el destino dado es nulo

public abstract ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint destino, RoutingOptions opciones)

Establece un solo destino para la navegación y anula cualquier destino configurado con anterioridad. El valor futuro que se muestra se establecerá en OK si se encuentra una ruta desde la ubicación del usuario hasta el destino determinado. Se usará el valor predeterminado DisplayOptions para mostrar la ruta.

Parámetros

destino	el nuevo destino que se configurará
Opciones	las opciones que se usarán para generar la ruta

Devuelve

• el futuro que se muestra

Arroja

NullPointerException	si el destino dado es nulo

público público ListenableResultFuture<Navigator.RouteStatus> setDestination (destino Punto de referencia)

Establece un solo destino para la navegación y anula cualquier destino configurado con anterioridad. El valor futuro que se muestra se establecerá en OK si se encuentra una ruta desde la ubicación del usuario hasta el destino determinado. Se usará el valor predeterminado RoutingOptions para encontrar la ruta y el DisplayOptions predeterminado para mostrarla.

Parámetros

destino	el nuevo destino que se configurará

Devuelve

• el futuro que se muestra

Arroja

NullPointerException	si el destino dado es nulo

público abstracto ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Waypoint> destinos, RoutingOptions)

Configura varios destinos para la navegación y anula cualquier destino configurado con anterioridad. El valor futuro que se muestra se establecerá en OK si se encuentra una ruta desde la ubicación del usuario hasta el destino determinado. Se usará el valor predeterminado DisplayOptions para mostrar la ruta.

Parámetros

destinos	la nueva lista de destinos que se configurará
Opciones	las opciones que se usarán para generar la ruta

Devuelve

• el futuro que se muestra

publicListenableResultFutureNavigator.RouteStatus setDestinationsRoutingOptionsDisplayOptions

Configura varios destinos para la navegación y anula cualquier destino configurado con anterioridad. El valor futuro que se muestra se establecerá en OK si se encuentra una ruta desde la ubicación del usuario hasta el destino determinado.

Parámetros

destinos	la nueva lista de destinos que se configurará
routingOptions	las opciones que se usarán para generar la ruta
displayOptions	las opciones que se usarán para mostrar la ruta

Devuelve

• el futuro que se muestra

public resumen ListenableResultFuture<Navigator.RouteStatus> setDestinations (Lista<Waypoint> destinos)

Configura varios destinos para la navegación y anula cualquier destino configurado con anterioridad. El valor futuro que se muestra se establecerá en OK si se encuentra una ruta desde la ubicación del usuario hasta el destino determinado. Se usará el valor predeterminado RoutingOptions para encontrar la ruta y el DisplayOptions predeterminado para mostrarla.

Parámetros

destinos	la nueva lista de destinos que se configurará

Devuelve

• el futuro que se muestra

público abstracto void setHeadsUpNotificationEnabled (boolean enabled)

Establece si se deben mostrar las notificaciones de atención. De forma predeterminada, la notificación está habilitada. Los eventos de aviso son eventos de orientación, como giros, etc., que se muestran cuando no hay un mapa visible.

Se debe llamar a este método en el subproceso de IU.

Parámetros

habilitado	una marca para indicar si se deben habilitar las notificaciones de atención

public setLicensePlateRestrictionInfo

Establece la información de la matrícula del conductor actual. Esto nos permite abordar ciertos tipos de restricciones viales según el número de matrícula. Esto solo se aplicará a las llamadas setDestination que se realicen después de que se haya configurado este valor. Lo ideal sería que lo llamaras inmediatamente después de obtener el navegador.

Parámetros

rawLicensePlateLastDigit	El último dígito de la matrícula (debe ser entre 0 y 9).
licensePlateCountryCode	Actualmente, admitimos Indonesia (ID) y Brasil (BZ), que podrían recibirse en el futuro, y puedes proporcionar esta información de forma proactiva.

public resumen void setRemainingTimeOrDistanceChangedListener (int timeChangeThresholdSeconds, int distanceChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener)

Registra un objeto de escucha para cuando el tiempo o la distancia restante al destino cambia en más de un umbral especificado. Anula cualquier objeto de escucha que se haya registrado con anterioridad.

Se podría llamar al objeto de escucha como resultado, por ejemplo, del movimiento del usuario, un cambio en las condiciones de tráfico, un cambio en la ruta, un cambio en el destino o cuando se conocen por primera vez el tiempo y la distancia restantes.

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

Parámetros

timeChangeThresholdSeconds	Si el cambio absoluto en el tiempo restante en segundos es mayor o igual que este valor, se llama al objeto de escucha. Este umbral no debe ser negativo.
distanceChangeThresholdMeters	Si el cambio absoluto en la distancia restante en metros es mayor o igual que este valor, se llama al objeto de escucha. Este umbral no debe ser negativo.
objeto de escucha	que el objeto de escucha registre. No debe ser null.

public resumen void setRouteChangedListener (objeto de escucha Navigator.RouteChangedListener)

Registra un objeto de escucha para los eventos de cambio de ruta. Anula cualquier objeto de escucha que se haya registrado con anterioridad.

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

Parámetros

objeto de escucha	que el objeto de escucha registre. Se puede configurar en null para borrar un objeto de escucha registrado previamente.

public abstract void setSpeedingListener (SpeedingListener speedingListener)

Registra un SpeedingListener para el porcentaje por encima del límite de velocidad al que conduce el conductor actualmente.

Si estableces un SpeedingListener con null o no estableces ninguno, no recibirás ningún dato del feed que aumente la velocidad.

Parámetros

speedingListener

public abstract void startGuidance (Intent de reanudación)

Es igual que startGuidance(), pero se especifica un intent que se puede usar para reanudar la app desde la notificación de la barra de estado del navegador. Sin este intent, no es posible reanudar la aplicación desde la barra de estado.

Parámetros

resumeIntent	la intención de reanudar la aplicación. En la mayoría de los casos, el valor que muestra android.app.Activity#getIntent() será adecuado.

público abstracto void startGuidance ()

Si se estableció un destino y se creó una ruta para él, se inicia una guía de navegación paso a paso para la ruta. Si aún no se ha calculado una ruta, la guía paso a paso se iniciará una vez que lo haya hecho.

Debes llamar explícitamente a stopGuidance() para detener el servicio de navegación. El servicio de navegación no se detendrá automáticamente en el momento de la llegada. Si deseas detener el servicio de navegación en el momento de la llegada, debes llamar a stopOrientation() en el NavArrivalListener.

Nota: Este método no cambia la posición de Camera.

público abstracto void stopGuidance ()

Detiene la guía de navegación paso a paso.