Definir o nível dos dados de tráfego

Desenvolvedores do Espaço Econômico Europeu (EEE)

As preferências de trânsito selecionadas equilibram a precisão dos detalhes do trajeto com o desempenho da solicitação de uma destas duas maneiras:

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

  • 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 retornar resultados o mais rápido possível. 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 oferece RoutingPreference (REST) e RoutingPreference (gRPC), que permitem especificar preferências de roteamento para calcular rotas.

O padrão é resultados sem considerar o trânsito. 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 trajeto produz resultados diferentes em termos de qualidade do trajeto, ETA estimado e latência de resposta.

Condições de trânsito

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

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

  • Trânsito leve a moderado: congestionamento crescente, com tráfego fluindo em 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 respostas rápidas e detalhes aproximados de roteamento forem suficientes.

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

Se você escolher TRAFFIC_UNAWARE, as opções de trajeto e duração se baseiam 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 encontrar:

  • 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, esse campo contém o mesmo valor que duration.

Com informações de trânsito

Use essa preferência de roteamento quando quiser detalhes 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 o trajeto considerando as condições de trânsito atuais. Como resultado, a rota e os detalhes dela refletem com mais precisão as condições reais. Como esse aumento na qualidade dos dados ocorre às custas da latência de resposta, otimizações de desempenho são aplicadas para reduzir grande parte da latência.

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

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

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

Melhor trajeto 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 (maior latência).

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

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

Ao usar 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 mais informações sobre os limites do recurso Compute Route Matrix, consulte Calcular uma matriz de rotas.

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

  • duration: o HEC do trajeto considerando 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 reconhecimento de trânsito em que o horário de partida precisa estar no futuro. Se você não definir a propriedade departureTime, o padrão será o horário em que você fizer 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 um trajeto.

  • TRAFFIC_UNAWARE: não recomendado porque a escolha de trajeto e duração se baseia na rede viária e nas condições médias de trânsito (independente da hora).

  • 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ânsito em tempo real. O trânsito em tempo real se torna mais importante e relevante quanto mais próximo de agora for o departureTime. Quanto mais você define o horário de partida no futuro, mais as condições históricas de trânsito são consideradas na seleção de rotas.

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

O código JSON a seguir demonstra como definir a preferência de roteamento TRAFFIC_AWARE_OPTIMAL no corpo de uma 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

Com a API Routes, é possível solicitar informações sobre as condições de trânsito ao longo de uma polilinha com reconhecimento de tráfego. Consulte Solicitar polilinhas para mais informações.