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 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

1. Defina a origem e o destino.

2. 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.

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 objeto duration_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 o departure_time estiver de agora. Como usar o tipo padrão de BEST_GUESS fornece as previsões mais úteis para a grande maioria dos em diferentes casos de uso de negócios.

   • PESSIMISTIC para solicitar que o duration_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 do que o tempo real de viagem na maioria dos dias. Dias ocasionais com eventos muito ruins condições ainda podem exceder essa estimativa.

   • OPTIMISTIC para solicitar que o duration_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 oferece 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"

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 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"