Ajustar las preferencias de enrutamiento

Los cálculos de ruta (incluida la modificación de ruta) muestran la ruta que tarda menos tiempo en navegar como la mejor ruta predeterminada. Sin embargo, puedes cambiar la estrategia de enrutamiento para que se muestre la alternativa de ruta más corta.

El término más corta se refiere a la ruta que es la más corta entre las rutas óptimas según nuestro modelo de costos predeterminado. Es posible que la ruta más corta no sea la absoluta, ya que esa opción podría ser una alternativa poco conveniente. Por ejemplo, si la ruta más corta absoluta es de 10 km y tarda 50 minutos en navegar, y otra ruta es de 15 km, pero solo tarda 20 minutos en navegar, la segunda opción es óptima, ya que pasar 30 minutos para reducir cinco kilómetros no es una buena compensación.

Una vez que establezcas la estrategia de planificación de ruta para un viaje, esta no cambiará hasta que se complete. Para cambiar la estrategia de enrutamiento de un viaje existente, debes borrar los destinos y volver a restablecerlos con la nueva estrategia de enrutamiento.

Cómo obtener detalles de la ruta

Para determinar qué estrategia de ruta es la opción óptima para un punto de referencia determinado, llama a getRouteInfo() para obtener detalles de la ruta para la mejor ruta predeterminada y la ruta más corta absoluta. Los detalles incluyen la duración y la distancia a un punto de referencia de destino.

Estos detalles provienen de RouteInfo y se muestran en un ListenableResultFuture.

Ejemplo

En el siguiente ejemplo de código, se muestra cómo obtener los detalles de la ruta para cada una de las dos estrategias de enrutamiento.

ListenableResultFuture<RouteInfo> routeInfoFuture =
        navigator.getRouteInfo(waypoint, routingOptions);

Cómo configurar la estrategia de enrutamiento

Para configurar la estrategia de enrutamiento, configura RoutingOptions.routingStrategy cuando llames a setDestinations().

RoutingOptions.routingStrategy toma uno de los siguientes valores de enumeración:

Valor de enumeraciónDescripción
RoutingStrategy.DEFAULT_BEST Clasifica las rutas según el modelo de costo predeterminado del SDK de Navigation. Esta es la estrategia de enrutamiento predeterminada.
RoutingStrategy.SHORTER Clasifica las rutas por distancia. La ruta con la clasificación más alta es la más corta de las que se muestran.

Ejemplo

En el siguiente ejemplo de código, se muestra cómo establecer la preferencia de ruta más corta.

RoutingOptions routingOptions = new RoutingOptions();
routingOptions.routingStrategy(RoutingStrategy.SHORTER);
navigator.setDestinations(destinations, routingOptions, displayOptions);

Rutas que incluyen ferris

De forma predeterminada, NavSDK excluye las rutas que incluyen transbordadores. Si prefieres incluir opciones de ferry como parte de tus rutas, puedes ajustar esta preferencia de planificación de ruta para exponer el viaje a los tramos de ferry configurando avoidFerries como false.

Ejemplo

RoutingOptions routingOptions = new RoutingOptions().avoidFerries(true);
// Add additional routing preferences
navigator.setDestination(destination, routingOptions);

El formato del texto destacado de la ruta

En la preferencia de ruta más corta, los textos destacados a lo largo de la ruta muestran detalles de la distancia. Sin embargo, puedes usar los textos destacados de la hora de llegada estimada.

Cómo configurar el formato de texto destacado de la ruta

Para cambiar el formato de la llamada de ruta, llama a setRouteCalloutInfoFormat en NavigationView (o en NavigationFragment). setRouteCalloutInfoFormat toma uno de los siguientes valores de enumeración:

Valor de enumeraciónDescripción
RouteCalloutInfoFormat.DEFAULT Muestra el tiempo restante cuando se usa la estrategia de enrutamiento de ruta óptima predeterminada. Muestra la distancia restante cuando se usa la estrategia de enrutamiento de ruta más corta.
RouteCalloutInfoFormat.TIME Muestra el tiempo restante.
RouteCalloutInfoFormat.DISTANCE Muestra la distancia restante.

Ejemplo

En el siguiente ejemplo de código, se muestra cómo configurar el formato de texto destacado de la ruta.

mNavFragment.setRouteCalloutInfoFormat(RouteCalloutInfoFormat.TIME);