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

Os modelos de tráfego usam algoritmos e fatores específicos para prever como as condições de tráfego afetam o tempo total de percurso de uma determinada rota. 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. Você pode especificar o tipo de modelo de trânsito que gostaria de usar nas rotas ao calcular a duração delas ou da matriz de rotas. 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 os tipos de modelo de tráfego.

Por padrão, os dois 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 a hora de partida for 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á o horário atual.

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 percurso, considerando o que se sabe sobre as condições históricas e em tempo real. As informações de trânsito em tempo real são mais importantes quando mais próximo do horário atual for o departure_time. O uso do tipo padrão de BEST_GUESS fornece as previsões mais úteis para a vasta maioria de casos de uso.

   • PESSIMISTIC para solicitar que o duration_in_traffic retornado modele o tempo com base nas condições históricas de trânsito 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 condições particularmente ruins ainda podem exceder essa estimativa.

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

   Exemplo:

   "trafficModel": "OPTIMISTIC"

4. 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 de tráfego que você solicitou.

Exemplo: solicitação de modelo de tráfego

Por exemplo, esta solicitação especifica que a duração seja 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ê mudar o tipo de modelo de tráfego para PESSIMISTIC, a duração retornada será maior:

"duration": "2436s"