Os modelos de tráfego usam algoritmos e fatores específicos para prever como o tráfego
as condições afetam o tempo total de viagem de um determinado trajeto. A API Routes
oferece diferentes tipos de modelos de tráfego para priorizar diferentes fatores usados em
para calcular a duração no tráfego. É possível especificar o tipo de modelo de tráfego
como seus trajetos para usar ao calcular a duração de seus trajetos ou de seus trajetos
matricial. Quando você define o tipo de modelo de tráfego, o valor retornado na
O campo duration
varia de acordo com o modelo de tráfego escolhido.
Tanto a API Routes Compute Routes
quanto
Os métodos Compute Route Matrix
são compatíveis com tipos de modelo de tráfego.
Por padrão, os dois métodos usam o tipo de modelo de tráfego BEST_GUESS
.
Especificar um tipo de tráfego
Defina a origem e o destino.
Caso seu horário de partida esteja no futuro, inclua-o usando o parâmetro
departure_time
. Se você não especificar um horário de partida, ele o padrão é agora.Selecione o modelo de tráfego a ser usado com o parâmetro
trafficModel
e um dos seguintes tipos:BEST_GUESS
(padrão) para solicitar que o objetoduration_in_traffic
retornado é a melhor estimativa do tempo de viagem com base no que se sabe sobre ambos nas condições de trânsito históricas e em tempo real. O trânsito em tempo real aumenta importante quanto mais próximo odeparture_time
estiver de agora. O uso do tipo padrão deBEST_GUESS
fornece as previsões mais úteis para a vasta maioria de casos de uso.PESSIMISTIC
para solicitar que oduration_in_traffic
retornado modele o de acordo com as condições de trânsito históricas em dias de trânsito ruim. Esse tipo fornece uma duração estimada que provavelmente é maior que o tempo de viagem real na maioria dos dias. Dias ocasionais com eventos muito ruins condições ainda podem exceder essa estimativa.OPTIMISTIC
para solicitar que oduration_in_traffic
retornado modele o de acordo com o histórico de condições de trânsito nos dias de bom trânsito. Esse tipo fornece uma duração estimada que provavelmente é menor que o tempo real de viagem na maioria dos dias. Em dias ocasionais, com boas condições ainda podem ser mais rápidas do que esta estimativa.
Exemplo:
"trafficModel": "OPTIMISTIC"
Especifique o campo
routes.duration
na máscara de campo.REST
-H X-Goog-FieldMask: routes.duration
RPC
const (fieldMask = "routes.duration")
Quando a API Routes estima o tempo no trânsito, ela usa o tipo de modelo que você solicitou.
Exemplo: solicitação de modelo de tráfego
Por exemplo, esta solicitação especifica que a duração será estimada usando o
Tipo de modelo de tráfego OPTIMISTIC
em um horário de partida específico:
curl -X POST -H 'content-type: application/json' -d ' { "origin": { "address": "Kyoto, Japan" }, "destination": { "placeId": "ChIJrYtcv-urAWAR3XzWvXv8n_s" }, "travelMode": "DRIVE", "routingPreference": "TRAFFIC_AWARE_OPTIMAL", "trafficModel": "OPTIMISTIC" }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Essa solicitação retorna a duração estimada usando o modelo de tráfego OPTIMISTIC
.
para a viagem:
"duration": "1238s"
Se você mudar o tipo de modelo de tráfego para PESSIMISTIC
, a duração retornada será
mais longos:
"duration": "2436s"