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 de um trajeto. A API Routes oferece diferentes tipos de modelos de trânsito para priorizar diferentes fatores usados no cálculo da duração no trânsito. É possível especificar o tipo de modelo de trânsito que você quer que seus trajetos usem ao calcular a duração deles ou da matriz de trajetos. Ao definir o tipo de modelo de trânsito, o valor retornado no campo duration varia dependendo do modelo de trânsito escolhido.

Os métodos Compute Routes e Compute Route Matrix da API Routes são compatíveis com tipos de modelos de trânsito.

Por padrão, os dois métodos usam o tipo de modelo de trânsito BEST_GUESS.

Para especificar um tipo de trânsito

1. Defina a origem e o destino.

2. Se o horário 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, ele será definido como agora.

3. Defina o parâmetro routingPreference como TRAFFIC_AWARE_OPTIMAL. Definir routingPreference como TRAFFIC_UNAWARE ou TRAFFIC_AWARE é incompatível com o parâmetro trafficModel.

4. Selecione o modelo de trânsito 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 de 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 tempo com base nas condições de trânsito históricas em dias de trânsito ruim. Esse tipo oferece uma duração estimada que provavelmente será maior do 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 de trânsito históricas em dias de trânsito bom. Esse tipo oferece uma duração estimada que provavelmente será menor do 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"

5. 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ânsito solicitado.

Exemplo: solicitação de modelo de trânsito

Por exemplo, essa solicitação especifica que a duração seja estimada usando o tipo de modelo de trânsito 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ânsito OPTIMISTIC para a viagem:

"duration": "1238s"

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

"duration": "2436s"