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áfego no cálculo da rota. Cada preferência de roteamento produz resultados que diferem em relação à qualidade da rota, à estimativa de ETA e à latência de resposta.

Sobre as condições de trânsito

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

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

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

• No trânsito parado, a taxa de fluxo é interrompida, produzindo condições de tráfego intenso.

Sem informações sobre o trânsito

Quando você define a preferência de roteamento TRAFFIC_UNAWARE, as rotas são calculadas sem considerar as condições de tráfego. 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 que as respostas sejam retornadas o mais rápido possível e os detalhes aproximados do roteamento sejam bons o suficiente.

Com base no trânsito

Quando você define a preferência de roteamento TRAFFIC_AWARE, as rotas são calculadas considerando as condições de trânsito. Como resultado, o trajeto e os detalhes dele refletem com mais precisão as condições do mundo real. Como esse aumento na qualidade dos dados é feito à custa 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.

Com informações de trânsito

Quando você define a preferência de roteamento TRAFFIC_AWARE_OPTIMAL, as rotas são calculadas levando em conta as condições de trânsito, mas nenhuma otimização de desempenho é aplicada. Nesse modo, o servidor realiza uma pesquisa mais completa da rede de estradas para encontrar a rota ideal.

Essa preferência de roteamento oferece a latência de resposta mais alta (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 se importar com o tempo de resposta.

Exemplo

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