Configurar a compensação entre qualidade e latência

A API Routes Preferred oferece três preferências de trajeto para calcular rotas. Elas diferem na medida em que consideram as condições de trânsito no cálculo do trajeto. Cada preferência de trajeto produz resultados que diferem em algum grau em relação à qualidade do trajeto, à ETA estimada e à latência da resposta.

Sobre as condições de trânsito

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

• Quando não há congestionamento, as condições de trânsito são consideradas normais, e o tráfego flui na velocidade regular sem impedimentos.

• À medida que o horário de pico se aproxima, a densidade do tráfego aumenta, o que faz com que o trânsito fique mais lento, produzindo condições de tráfego leve a moderado.

• Em um trânsito congestionado, a taxa de fluxo para, causando condições de tráfego intenso.

Sem informações de trânsito

Quando você define a preferência de roteamento TRAFFIC_UNAWARE, os trajetos são calculados sem considerar as condições de trânsito. Essa preferência de roteamento oferece a menor latência de resposta (as respostas são retornadas mais rapidamente).

Use essa preferência de roteamento quando quiser respostas rápidas e detalhes aproximados forem suficientes.

Com informações de trânsito

Quando você define a preferência de trajeto TRAFFIC_AWARE, os trajetos são calculados considerando as condições de trânsito. Assim, o trajeto e os detalhes dele 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.

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

Melhor trajeto com informações de trânsito

Quando você define a preferência de roteamento TRAFFIC_AWARE_OPTIMAL, as rotas são calculadas considerando as condições de trânsito, mas nenhuma otimização de performance é aplicada. Nesse modo, o servidor realiza uma pesquisa mais completa da rede viária para encontrar o trajeto ideal.

Essa preferência de roteamento oferece a maior latência de resposta (ou seja, as respostas são retornadas com o maior atraso). Use essa preferência de roteamento quando quiser resultados da mais alta qualidade, sem considerar o tempo de resposta.

Exemplo

O código JSON a seguir demonstra como definir a preferência de roteamento 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"
}