A API Routes Preferred fornece três preferências de roteamento para calcular rotas. Eles 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 um grau em relação à qualidade do trajeto, ao HEC estimado e à latência de resposta.
Sobre as condições de trânsito
As condições de trânsito caracterizam a taxa do 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.
Ao se aproximar do horário de pico, a densidade do tráfego aumenta, o que causa lentidão e condições de trânsito moderadas.
No tráfego de bumper para bumper, a taxa de fluxo é desacelerada até parar, produzindo condições de trânsito intenso.
Não reconhece o tráfego
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, sendo que as respostas são as mais rápidas.
Use essa preferência de roteamento quando quiser que as respostas sejam retornadas mais rapidamente e que os detalhes de roteamento aproximados sejam bons o suficiente.
Conhecimento 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. Como resultado, os detalhes do trajeto refletem com mais precisão as condições reais. Como esse aumento na qualidade de dados vem à custa 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 de roteamento mais precisos e, mesmo assim, não se importar se as respostas forem retornadas com um aumento moderado na latência.
Ideal para informações de trânsito
Quando você define a preferência de trajeto TRAFFIC_AWARE_OPTIMAL, os trajetos são calculados considerando as condições de trânsito, mas nenhuma otimização de desempenho é aplicada. Nesse modo, o servidor realiza uma pesquisa mais completa da malha rodoviária para encontrar o trajeto ideal.
Essa preferência de roteamento oferece a maior latência de resposta, ou seja, as respostas retornam com o maior atraso. Use essa preferência de roteamento quando quiser resultados da mais alta qualidade, independentemente do tempo necessário para as respostas.
Exemplo
O código JSON a seguir demonstra como definir a preferência de roteamento no corpo da entidade de uma 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"
}