Planejar um trajeto

Às vezes, pode ser necessário planejar o trajeto que o app oferece aos usuários. O uso de 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 a rota

  • Objetivos da sua rota

Confira alguns exemplos de objetivos de roteamento:

  • Minimizar o tempo de entrega: uma empresa que entrega comida pode querer minimizar o tempo que leva para entregar a comida.

  • 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 envio de serviço pode querer minimizar o tempo que leva para que os operadores cheguem a uma solicitação de trabalho.

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

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

Por que usar um token de rota para objetivos de rota

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

  • Planeje uma rota com antecedência para que o SDK de navegação a use quando possível.

  • Escolher a melhor rota para o SDK do Navigation usar. Se você solicitar tokens de rota ao gerar rotas na API Routes, vai receber um token de rota para cada rota gerada. Em seguida, escolha o token da rota que você quer usar ao transmiti-lo para o SDK de navegação.

  • Estime o preço com antecedência, incluindo estimativas de HEC e distância. O custo e o tempo reais podem variar, mas essa estimativa reduz a lacuna entre o custo esperado e o real do trajeto.

  • Especifique objetivos de rota mais avançados, como trajetos ecológicos ou a rota mais curta.

Como os tokens de rota funcionam

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

Confira 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 trajeto criptografado que inclui a poligonal do trajeto e os objetivos do trajeto.

  2. Você transmite o token de rota para o SDK do Navigation.

  3. O SDK do Navigation recupera o trajeto ou, se ele não está disponível devido a mudanças nas condições, ele recupera a melhor rota correspondente.

  4. Durante o trajeto, se o trânsito ou outras condições da via mudarem ou se um veículo desviar do trajeto planejado, as rotas modificadas vão tentar corresponder à melhor rota com base nos objetivos do trajeto no token.

Esse processo maximiza a proximidade da rota real com a planejada.

Por que um trajeto planejado pode não ser seguido à risca

Pense na rota planejada e nos objetivos da rota como diretrizes a serem seguidas: elas não são prescritivas. Talvez você note uma diferença entre a rota planejada e a rota fornecida 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 a rota planejada. Essa diferença pode resultar em incompatibilidade entre as metas planejadas e reais de distância e HEC, entre outras qualidades de viagem importantes.

Planejar uma rota usando um token de rota

Você pode planejar uma rota criando um token de rota e transmitindo-o para o SDK do Navigation, conforme descrito nas etapas a seguir:

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

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

    • API Routes: computeRoutes. Para mais informações sobre como solicitar um token de rota na API Routes, consulte Calcular uma rota e Solicitar um token de rota.

    • API Routes Preferred: computeCustomRoutes. Para mais informações sobre como solicitar um token de rota na API Routes Preferred, consulte Planejar uma rota.

    • API Route Optimization: optimizeTours ou batchOptimizeTours. Para mais informações sobre como solicitar um token de rota na API Route Optimization, consulte Polilinhas de transição e tokens de rota.

  2. Configure sua 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 DRIVING 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. Exemplo:

    String routeToken = "route token returned by Routes API";

    Exemplo de um token de trajeto retornado:

    {
    // Other fields
    "routeToken": "CqMBCjoKCJQOor5DHcwiEhBon3XpHXFnVvDeWMwd9PpAGgz6wtnFDKIBrAHTARpCApUDSggAAAAACjcrP3gBEAQaTApKChgKDQoCCAERAAAAAACAZkAR3SQGgZUXdUASEggAEAMQBhATEBIYAkIEGgIIBSIYChZ2VEJiWlBPSkk1aU5wUVRzNTV5d0FRKAEiFQBcJuds-Efh-2QZhOMTtUCCxEVL_g",
    }
    
  2. Transmita o token de rota para o SDK Navigation usando o método Navigator.setDestinations, especificando os mesmos pontos de passagem de destino usados ao criar o token de rota:

    setDestinations(List destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions);

    Exemplo:

    CustomRoutesOptions customRoutesOptions =
          CustomRoutesOptions.builder()
          .setRouteToken(routeToken)
          .setTravelMode(TravelMode.DRIVING)
          .build();

O método Navigator.setDestinations retorna o status da solicitação. Se ele encontra um trajeto do local do veículo até o destino especificado, ele retorna RouteStatus.OK.

Para mais informações sobre esse método, consulte Navigator.setDestinations.

Exemplo

O exemplo de código abaixo demonstra como especificar um trajeto planejado usando um token de trajeto.

    ArrayList <Waypoint> destinations = Lists.newArrayList();
    Waypoint waypoint1 =
       Waypoint.builder()
          .setLatLng(10, 20)
          .setTitle("title")
          .setVehicleStopover(true)
          .build();
    destinations.add(waypoint1);
    Waypoint waypoint2 =
       Waypoint.builder()
          .setPlaceId("ChIJYV-J-ziuEmsRIMyoFaMedU4")
          .setTitle("title")
          .setVehicleStopover(true)
           .build()
    destinations.add(waypoint2);

    String routeToken = "route token returned by Routes API";

    CustomRoutesOptions customRoutesOptions =
       CustomRoutesOptions.builder()
          .setRouteToken(routeToken)
          .setTravelMode(TravelMode.DRIVING)
          .build();

    // Existing flow to get a Navigator.
    NavigationApi.getNavigator(...);

    // Existing flow for requesting routes.
    ListenableResultFuture<RouteStatus> routeStatusFuture =
        navigator.setDestinations(destinations, customRoutesOptions);

    // Or with display options.
    DisplayOptions displayOptions = new DisplayOptions();

    ListenableResultFuture<RouteStatus> routeStatusFuture =
        navigator.setDestinations(destinations, customRoutesOptions, displayOptions);

Como os tokens de rota e o SDK do Navigation interagem

Confira como a rota gerada pelo SDK do Navigation e a rota planejada no token do trajeto interagem:

  • Substitui qualquer destino definido anteriormente.

  • Usar 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.

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

    • avoidsHighways
    • avoidsTolls
    • avoidsFerries
    • licensePlateRestriction
  • Seguidores:

    • Opções relacionadas a pontos de passagem, como a preferência de acostamento.

    • Objetivos da rota. Se o SDK de navegação precisar ajustar a rota retornada, ele vai usar os objetivos de rota especificados ao solicitar o token de rota. Por esse motivo, use as mesmas opções relacionadas a pontos de passagem que você especificou na API Routes.