Ajustar preferências de roteamento

Os cálculos de rota (incluindo reencaminhamento) retornam a rota que leva o menor tempo para navegar como a melhor rota padrão. No entanto, é possível alterar a estratégia de roteamento para que as alternativas de trajeto mais curtas sejam retornadas.

O termo mais curta significa a rota mais curta entre as rotas ideais com base no nosso modelo de custo padrão. O trajeto mais curto pode não ser o absoluto mais curto, porque essa opção pode ser uma alternativa ruim. Por exemplo, se a rota absolutamente mais curta for 10 km e levar 50 minutos para navegar e outra tiver 15 km, mas apenas 20 minutos para navegar, a segunda opção será a ideal, porque gastar 30 minutos para reduzir 5 km não é uma boa compensação.

Depois de definir a estratégia de trajeto de uma viagem, ela não será alterada até que a viagem seja concluída. Para mudar a estratégia de trajeto de uma viagem, limpe os destinos e redefina-os novamente com a nova estratégia.

Como acessar detalhes do trajeto

Para determinar qual estratégia de trajeto é a ideal para um determinado waypoint, chame getRouteInfo() para receber detalhes do melhor trajeto padrão e do trajeto absoluto mais curto. Os detalhes incluem a duração e a distância até um waypoint de destino.

Esses detalhes vêm de RouteInfo e são retornados em um ListenableResultFuture.

Exemplo

O exemplo de código a seguir demonstra como ver detalhes do trajeto para cada uma das duas estratégias de roteamento.

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

Como definir a estratégia de roteamento

Para configurar a estratégia de roteamento, defina RoutingOptions.routingStrategy ao chamar setDestinations().

RoutingOptions.routingStrategy usa um dos seguintes valores de enumeração:

Valor de enumeraçãoDescrição
RoutingStrategy.DEFAULT_BEST Classifica as rotas pelo modelo de custo padrão do SDK de navegação. Essa é a estratégia de roteamento padrão.
RoutingStrategy.SHORTER Classifica os trajetos por distância. O trajeto com a classificação mais alta é o mais curto entre os retornados.

Exemplo

O exemplo de código a seguir demonstra como definir a preferência de trajeto mais curto.

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

Trajetos que incluem balsas

Por padrão, o NavSDK exclui rotas que incluem balsas. Se você preferir incluir opções de balsa como parte dos seus trajetos, ajuste essa preferência de trajeto para expor a viagem aos segmentos de balsa definindo avoidFerries como false.

Exemplo

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

Formato da frase de destaque do trajeto.

Na preferência de trajeto mais curto, as frases de destaque ao longo do trajeto mostram detalhes da distância. No entanto, você pode usar as frases de destaque de HEC.

Como configurar o formato da frase de destaque da rota

É possível alterar o formato da frase de destaque de rota chamando setRouteCalloutInfoFormat em NavigationView (ou em NavigationFragment). setRouteCalloutInfoFormat usa um dos seguintes valores de enumeração:

Valor de enumeraçãoDescrição
RouteCalloutInfoFormat.DEFAULT Mostra o tempo restante ao usar a estratégia de roteamento de melhor rota padrão. Mostra a distância restante ao usar a estratégia de trajeto mais curto.
RouteCalloutInfoFormat.TIME Mostra o tempo restante.
RouteCalloutInfoFormat.DISTANCE Mostra a distância restante.

Exemplo

O exemplo de código a seguir demonstra como configurar o formato de frase de destaque de rota.

mNavFragment.setRouteCalloutInfoFormat(RouteCalloutInfoFormat.TIME);