Ajustar preferências de roteamento

Os cálculos de rota (incluindo o redirecionamento) retornam o trajeto que leva menos tempo para navegar como a melhor rota padrão. No entanto, é possível mudar a estratégia de roteamento para que a alternativa mais curta seja retornada.

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

Depois de definir a estratégia de roteamento para uma viagem, ela não vai mudar até que a viagem seja concluída. Para mudar a estratégia de roteamento de uma viagem, limpe os destinos e redefina-os com a nova estratégia.

Como receber detalhes da rota

Para determinar qual estratégia de rota é a melhor opção para um determinado waypoint, chame getRouteInfoForDestination() para receber detalhes da melhor rota padrão e da rota mais curta. Os detalhes incluem a duração e a distância até um waypoint de destino.

Esses detalhes vêm de GMSNavigationRouteInfo no callback.

Exemplo

O exemplo de código a seguir demonstra como receber detalhes da rota para cada uma das duas estratégias de roteamento.

let routingOptions = GMSNavigationRoutingOptions()
navigator?.getRouteInfoForDestination(destination,
                                      routingOptions: routingOptions) { routeInfo in
  ...
}

GMSNavigationRoutingOptions *routingOptions =
    [[GMSNavigationRoutingOptions alloc] init];
[navigator getRouteInfoForDestination:destination
                   withRoutingOptions:routingOptions
                             callback:^(GMSNavigationRouteInfo *routeInfo){...}];

Como definir a estratégia de roteamento

É possível configurar a estratégia de roteamento usando GMSNavigationRoutingOptions e definindo routingStrategy ao chamar setDestinations().

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

Exemplo

O exemplo de código a seguir demonstra como definir a estratégia de roteamento de rota mais curta.

let routingOptions = GMSNavigationRoutingOptions(routingStrategy: .shorter)
navigator?.setDestinations(destinations,
                           routingOptions: routingOptions) { routeStatus in
  ...
}

GMSNavigationRoutingOptions *routingOptions = [[GMSNavigationRoutingOptions alloc] initWithRoutingStrategy:GMSNavigationRoutingStrategyShorter];
[navigator setDestinations:destinations
            routingOptions:routingOptions
                  callback:^(GMSRouteStatus routeStatus){...}];

Rotas que incluem balsas

Por padrão, o SDK do Navigation para iOS exclui rotas que incluem balsas. Se você preferir incluir opções de balsa como parte das rotas, ajuste essa preferência de roteamento para expor a viagem aos segmentos de balsa definindo avoidsFerries como false.

Exemplo

self.mapView.navigator?.avoidsFerries = false

self.mapView.navigator.avoidsFerries = NO

O formato da frase de destaque da rota

Na estratégia de roteamento de rota mais curta, as frases de destaque ao longo da rota mostram detalhes da distância. No entanto, é possível usar as frases de destaque de ETA.

Como configurar o formato da frase de destaque da rota

É possível mudar o formato da frase de destaque da rota definindo routeCalloutFormat em GMSMapView. routeCalloutFormat usa um dos seguintes valores de enumeração:

Exemplo

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

self.mapView.routeCalloutFormat = .time

_mapView.routeCalloutFormat = GMSNavigationRouteCalloutFormatTime;