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 stopDirection() 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.