Planejar um trajeto

Às vezes, você pode querer planejar o trajeto que seu app oferece aos usuários. Usar um token de rota da API Routes, da API Routes Preferred ou da API Route Optimization pode ajudar a especificar duas coisas para o trajeto planejado:

  • Uma polilinha para o trajeto

  • Seus objetivos de trajeto

Confira alguns exemplos de objetivos de trajeto que você pode ter:

  • Minimizar o tempo de entrega: uma empresa de entrega de comida pode querer minimizar o tempo necessário para entregar o pedido.

  • Minimizar o tempo de viagem ou o consumo de combustível: uma empresa de logística pode querer melhorar a eficiência dos motoristas e reduzir os custos de combustível.

  • Minimizar o tempo até o destino: uma operação de despacho de serviços pode querer minimizar o tempo necessário para que os operadores cheguem a uma solicitação de trabalho.

  • Reduzir custos e melhorar a segurança: uma empresa de compartilhamento de viagens pode querer encontrar um trajeto que custe menos para os passageiros e evite determinadas áreas por motivos de segurança.

Para mais informações sobre como planejar um trajeto usando um token de rota, consulte Solicitar um token de rota na API Routes e Polilinhas de transição e tokens de rota na API Route Optimization.

Por que usar um token de rota para objetivos de trajeto

Com um token de rota da API Routes, da API Routes Preferred ou da API Route Optimization, você tem mais controle sobre o trajeto fornecido:

  • Planeje um trajeto com antecedência para o SDK de navegação usar quando possível.

  • Escolha o melhor trajeto para o SDK de navegação usar. Se você solicitar tokens de rota ao gerar trajetos na API Routes, receberá um token de rota para cada trajeto gerado. Em seguida, escolha o token do trajeto que você quer usar ao transmiti-lo para o SDK de navegação.

  • Estime o preço com antecedência, incluindo estimativas de ETA e distância. Embora o custo e o tempo reais possam variar, essa estimativa reduz a diferença entre o custo esperado e o real do trajeto.

  • Especifique objetivos de trajeto mais avançados, como o trajeto ecológico ou o mais curto.

Como os tokens de rota funcionam

Você pode usar a API Routes, a API Routes Preferred ou a API Route Optimization para planejar um trajeto usando objetivos de rota. Você pode transmitir um token de rota retornado de qualquer uma dessas APIs para o SDK de navegação para orientar como ele roteia seu veículo.

Veja o que acontece quando você solicita e usa um token de rota:

  1. A API Routes, a API Routes Preferred ou a API Route Optimization retorna um token de rota criptografado que inclui a polilinha e os objetivos do trajeto.

  2. Você transmite o token de rota para o SDK de navegação.

  3. O SDK de navegação recupera o trajeto ou, se ele não estiver disponível devido a condições variáveis, recupera o trajeto mais adequado.

  4. Ao dirigir o trajeto, se o trânsito ou outras condições da via mudarem, ou se um veículo se desviar do trajeto planejado, os trajetos modificados tentarão continuamente corresponder ao melhor trajeto com base nos objetivos do trajeto no token.

Esse processo maximiza a proximidade do trajeto real ao trajeto planejado.

Por que um trajeto planejado pode não ser seguido exatamente

Pense no trajeto planejado e nos objetivos do trajeto como diretrizes a serem seguidas: eles não são prescritivos. Você pode notar uma diferença entre o trajeto planejado e o trajeto fornecido pela navegação guiada devido a diferenças nas condições da via, no local de partida ou em outros parâmetros que mudaram desde que você criou o trajeto planejado. Essa diferença pode resultar em uma incompatibilidade entre as metas planejadas e reais de distância e ETA, entre outras qualidades importantes da viagem.

Planejar um trajeto usando um token de rota

Você pode planejar um trajeto criando um token de rota e transmitindo-o para o SDK de navegação, conforme descrito nas etapas a seguir:

Etapa 1: criar um token de rota usando a API Routes, a API Routes Preferred ou a API Route Optimization

  1. Solicite um token de rota com um dos seguintes métodos:

  2. Configure a solicitação da API Routes ou da API Routes Preferred para atender aos requisitos de uso de um token de rota:

    • Defina travel_mode como DRIVE ou TWO_WHEELER
    • Defina routing_preference como TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL
    • NÃO use waypoints Via

Etapa 2: transmitir o token de rota para o SDK de navegação

  1. Armazene o token de rota: no SDK de navegação, configure uma string para armazenar o token de rota. Por exemplo:

    let routeToken = "route token returned by Routes API"

    Exemplo de um token de rota retornado:

    {
// Other fields
"routeToken": "CqMBCjoKCJQOor5DHcwiEhBon3XpHXFnVvDeWMwd9PpAGgz6wtnFDKIBrAHTARpCApUDSggAAAAACjcrP3gBEAQaTApKChgKDQoCCAERAAAAAACAZkAR3SQGgZUXdUASEggAEAMQBhATEBIYAkIEGgIIBSIYChZ2VEJiWlBPSkk1aU5wUVRzNTV5d0FRKAEiFQBcJuds-Efh-2QZhOMTtUCCxEVL_g",
}

  2. Transmita o token de rota para o SDK de navegação usando o método mapView.navigator setDestinations, especificando os mesmos waypoints de destino que você usou ao criar o token de rota:

    mapView.navigator?.continueToNextDestination([waypoint1, waypoint2], routeToken: routeToken, callback: {...})

    O método Navigator.continueToNextDestination retorna o status da solicitação. Se um trajeto for encontrado do local do usuário para o destino fornecido, ele retornará RouteStatus.OK.

Cenários com várias paradas

Você pode configurar um máximo de 25 waypoints.

O método setDestinations não oferece suporte a viagens com várias paradas. Use continueToNextDestination() para avançar o waypoint para a próxima etapa da viagem.

Exemplo

Os exemplos de código a seguir demonstram como recuperar um trajeto planejado.

Swift

let location = CLLocationCoordinate2D(latitude: 47.67, longitude: -122.20)
let waypoint1 = GMSNavigationWaypoint(location: location, title: "waypoint from location")!
let waypoint2 = GMSNavigationWaypoint(placeID: "samplePlaceID", title: "waypoint from Place ID")!

let routeToken = "route token returned by Routes API"
mapView.navigator?.setDestinations([waypoint1, waypoint2], routeToken: routeToken, callback: {...})

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationWaypoint *waypoint1 = [[GMSNavigationWaypoint alloc] initWithLocation:coordinate title:@"waypoint from location"];
GMSNavigationWaypoint *waypoint2 = [[GMSNavigationWaypoint alloc] initWithPlaceID:@"samplePlaceID"
                                                                            title:@"waypoint from Place ID"];
NSString *routeToken = @"route token returned by Routes API";

[mapView.navigator continueToNextDestination:@[waypoint1, waypoint2]
                         routeToken:routeToken
                           callback:^(GMSRouteStatus routeStatus){...}];

Como os tokens de rota e o SDK de navegação interagem

Veja como o trajeto gerado pelo SDK de navegação e o trajeto planejado no token de rota interagem:

  • Substitui todos os destinos definidos anteriormente.

  • Usa o local de partida do veículo.

  • Ajusta as condições da via e do trânsito. Consulte Por que um trajeto planejado pode não ser seguido exatamente.

  • Ignora as seguintes opções relacionadas ao roteamento como desnecessárias:

    • avoidsHighways
    • avoidsTolls
    • avoidsFerries
    • licensePlateRestriction

  • Segue:

    • Opções relacionadas ao waypoint, como a preferência do lado da via.

    • Objetivos de trajeto. Se o SDK de navegação precisar ajustar o trajeto retornado, ele usará os objetivos de trajeto especificados ao solicitar o token de rota. Por esse motivo, use as mesmas opções relacionadas ao waypoint que você especificou na API Routes.