Definir o nível dos dados de tráfego

As preferências de tráfego selecionadas balanceiam a precisão dos detalhes da rota com a performance da solicitação de duas maneiras:

  • Com informações de trânsito: retorna os resultados mais precisos possíveis (latência maior).

  • Sem informações de trânsito: retorna os resultados o mais rápido possível (menor latência).

Ao fazer uma solicitação, avalie se é melhor retornar os resultados mais precisos possíveis ou os resultados mais rápidos possíveis. A API Routes oferece opções que permitem controlar a qualidade dos dados de resposta em relação à latência da resposta.

Como definir o nível de tráfego

A API Routes fornece RoutingPreference (REST) e RoutingPreference (gRPC) para especificar preferências de roteamento para calcular rotas.

O padrão são resultados sem tráfego. Você seleciona opções de tráfego com as preferências de roteamento TRAFFIC_UNAWARE, TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Cada preferência de roteamento produz resultados diferentes na qualidade da rota, no tempo estimado de chegada e na latência da resposta.

Condições de trânsito

As condições de trânsito caracterizam a taxa de fluxo de trânsito:

  • Trânsito normal: sem congestionamento, com o tráfego fluindo em uma velocidade normal.

  • Tráfego leve a moderado: aumento do congestionamento, com o tráfego fluindo a uma velocidade reduzida.

  • Trânsito intenso: congestionamento grave, com velocidade de tráfego muito reduzida.

Sem informações de trânsito

TRAFFIC_UNAWARE é a configuração padrão. Use essa preferência de roteamento quando quiser que as respostas sejam retornadas o mais rápido possível e os detalhes de roteamento aproximados sejam bons o suficiente.

As rotas TRAFFIC_UNAWARE são calculadas sem considerar as condições atuais de trânsito. Essa preferência de roteamento resulta na resposta de solicitação mais rápida (menor latência).

Se você escolher TRAFFIC_UNAWARE, a rota e a duração escolhidas serão baseadas na rede viária e nas condições médias de trânsito (independente da hora), não nas condições de trânsito atuais. Assim, os trajetos podem incluir vias que estão temporariamente interditadas. Os resultados das solicitações variam por causa de mudanças na malha rodoviária, de atualizações nas condições de trânsito e da natureza distribuída do serviço. Eles também variam entre trajetos quase equivalentes a qualquer momento ou frequência.

Estas são as respostas que você vai receber:

  • duration: contém a estimativa de chegada do trajeto.

  • staticDuration: a HEC da rota considerando apenas informações históricas de trânsito. Para TRAFFIC_UNAWARE, ele contém o mesmo valor de duration.

Com base no trânsito

Use essa preferência de roteamento quando quiser detalhes de roteamento mais precisos do que TRAFFIC_UNAWARE, mas não se importar se as respostas forem retornadas com um aumento moderado na latência.

Quando você define a preferência de roteamento TRAFFIC_AWARE, o serviço calcula a rota considerando as condições atuais de tráfego. Como resultado, a rota e os detalhes dela refletem com mais precisão as condições do mundo real. Como esse aumento na qualidade dos dados ocorre à custa da latência de resposta, as otimizações de desempenho são aplicadas para reduzir grande parte da latência.

Estas são as respostas que você vai receber:

  • duration: o HEC considerando as informações de trânsito em tempo real.

  • staticDuration O HEC do trajeto considerando apenas informações históricas de trânsito.

Com informações de trânsito

Use essa preferência de roteamento quando quiser resultados da mais alta qualidade, sem se importar com o tempo de resposta. Essa preferência de roteamento tem o maior atraso no retorno de respostas (latência mais alta).

Quando você define a preferência de roteamento TRAFFIC_AWARE_OPTIMAL, o serviço calcula a rota considerando as condições atuais de tráfego, mas não aplica otimizações de desempenho. Nesse modo, o servidor realiza uma pesquisa mais completa da rede de estradas para encontrar o trajeto ideal.

A preferência de roteamento TRAFFIC_AWARE_OPTIMAL é equivalente ao modo usado pelo maps.google.com e pelo app Google Maps para dispositivos móveis.

Quando você usa essa opção com a matriz de rotas do Compute, o número de elementos em uma solicitação (número de origens × número de destinos) não pode exceder

  1. Para saber mais sobre os limites da Compute Route Matrix, consulte Como calcular uma matriz de rotas.

Estas são as respostas que você vai receber:

  • duration: o ETA para o trajeto considerando as informações de trânsito em tempo real.

  • staticDuration: a HEC da rota considerando apenas informações históricas de trânsito.

Definir horário de partida (opcional)

Use essa propriedade apenas para solicitações com informações de tráfego em que o horário de partida precisa ser no futuro. Se você não definir a propriedade departureTime, ela vai ser definida como o horário em que você fez a solicitação.

Use a propriedade departureTime com as opções TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL quando quiser ajustar a forma como o serviço prevê o tráfego ao escolher uma rota.

  • TRAFFIC_UNAWARE: não recomendado, porque a escolha do trajeto e da duração é baseada na malha rodoviária e nas condições médias de trânsito independente do horário.

  • TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL: recomendado para partidas que vão acontecer em breve, porque essas preferências consideram as condições de tráfego em tempo real. O tráfego em tempo real fica mais importante e relevante quanto mais próximo o departureTime está de agora. Quanto mais distante você definir o horário de partida, mais consideração será dada às condições históricas de trânsito na seleção de rotas.

Exemplo: como selecionar o roteamento com informações de trânsito

O código JSON abaixo demonstra como definir a preferência de roteamento TRAFFIC_AWARE_OPTIMAL em um corpo de entidade de mensagem de solicitação.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}

Configurar o tráfego em polilinhas

A API Routes permite solicitar informações sobre as condições de trânsito ao longo de uma polilinha com informações de trânsito. Consulte Solicitar polilinhas para mais informações.