Especifique o tipo de modelo de tráfego a ser usado

Os modelos de trânsito usam algoritmos e fatores específicos para prever como as condições de trânsito afetam o tempo total de viagem para um determinado trajeto. A API Routes oferece diferentes tipos de modelo de tráfego para priorizar diferentes fatores usados no cálculo da duração no tráfego. É possível especificar o tipo de modelo de tráfego que você quer que seus trajetos usem ao calcular a duração deles ou da matriz de trajetos. Quando você define o tipo de modelo de tráfego, o valor retornado no campo duration varia de acordo com o modelo escolhido.

Os métodos Compute Routes e Compute Route Matrix da API Routes são compatíveis com tipos de modelo de tráfego.

Por padrão, ambos os métodos usam o tipo de modelo de tráfego BEST_GUESS.

Para especificar um tipo de tráfego

  1. Defina a origem e o destino.

  2. Se o horário de partida estiver no futuro, inclua o horário usando o parâmetro departure_time. Se você não especificar um horário de partida, o padrão será agora.

  3. 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 duration_in_traffic retornado seja a melhor estimativa do tempo de viagem, considerando as informações de condições de trânsito históricas e em tempo real. Quanto mais próximo de agora for o departure_time, mais importante será o trânsito em tempo real. O uso do tipo padrão BEST_GUESS oferece as previsões mais úteis para a grande maioria dos casos de uso.

    • PESSIMISTIC para solicitar que o duration_in_traffic retornado modele o horário com base no histórico de condições de trânsito em dias de mau trânsito. Esse tipo fornece uma duração estimada que provavelmente é maior que o tempo real de viagem na maioria dos dias. Dias ocasionais com condições particularmente ruins ainda podem exceder essa estimativa.

    • OPTIMISTIC para solicitar que o duration_in_traffic retornado modele o horário com base nas condições históricas de trânsito em dias de boa situação. Esse tipo fornece uma duração estimada que provavelmente é menor que o tempo real de viagem na maioria dos dias. Dias ocasionais com condições particularmente boas podem ser mais rápidos do que essa estimativa.

    Por exemplo: 

    "trafficModel": "OPTIMISTIC"

  4. Especifique o campo routes.duration na máscara de campo.

    REST

    -H X-Goog-FieldMask: routes.duration

    RPC (em inglês)

    const (fieldMask = "routes.duration")

Quando a API Routes estima o tempo no trânsito, ela usa o tipo de modelo de tráfego 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 tipo de modelo de tráfego OPTIMISTIC para a viagem:

"duration": "1238s"

Se você alterar o tipo de modelo de tráfego para PESSIMISTIC, a duração retornada será maior:

"duration": "2436s"