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

A API Routes Preferred oferece três preferências de roteamento para calcular rotas. Elas diferem na medida em que consideram as condições de trânsito no cálculo da rota. Cada preferência de roteamento produz resultados que diferem em relação à qualidade da rota, ao tempo estimado de chegada 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 normal e sem impedimentos.

• À medida que a hora de pico se aproxima, a densidade do trânsito aumenta, o que faz com que o tráfego diminua, produzindo condições de trânsito leves a moderadas.

• No trânsito lento, o fluxo diminui até parar, produzindo condições de trânsito intenso.

Sem informações de tráfego

Quando você define a TRAFFIC_UNAWARE preferência de roteamento, as rotas são calculadas 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 retornadas mais rapidamente e detalhes de roteamento aproximados forem suficientes.

Com informações de tráfego

Quando você define a TRAFFIC_AWARE preferência de roteamento, as rotas são calculadas considerando as condições de trânsito. Como resultado, a rota e os detalhes dela refletem com mais precisão as condições reais. Como esse aumento na qualidade de dados ocorre às custas da latência de resposta, as otimizações de desempenho são aplicadas para reduzir grande parte da latência.

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

Melhores trajetos com informações de trânsito

Quando você define a TRAFFIC_AWARE_OPTIMAL preferência de roteamento, as rotas são calculadas considerando as condições de trânsito, mas nenhuma otimização de desempenho é aplicada. Nesse modo, o servidor realiza uma pesquisa mais exaustiva da rede viária para encontrar a rota 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 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"
}