Especifica el tipo de modelo de tráfico que se usará

Los modelos de tráfico utilizan algoritmos y factores específicos para predecir cómo las condiciones del tráfico afectan el tiempo total de viaje en una ruta determinada. La API de Routes ofrece diferentes tipos de modelos de tráfico para priorizar los distintos factores que se usan en el cálculo de la duración en el tráfico. Puedes especificar el tipo de modelo de tráfico que deseas que usen tus rutas cuando calcules la duración de tus rutas o de la matriz de rutas. Cuando configuras el tipo de modelo de tráfico, el valor que se devuelve en el campo duration varía según el modelo de tráfico que elijas.

Tanto la API de Routes Compute Routes como los métodos Compute Route Matrix admiten tipos de modelos de tráfico.

De forma predeterminada, ambos métodos usan el tipo de modelo de tráfico BEST_GUESS.

Cómo especificar un tipo de tráfico

1. Configura tu origen y destino.

2. Si tu hora de partida es en el futuro, incluye la hora con el parámetro departure_time. Si no especificas una hora de partida, se usará la hora actual de forma predeterminada.

3. Establece el parámetro routingPreference en TRAFFIC_AWARE_OPTIMAL. Establecer routingPreference en TRAFFIC_UNAWARE o TRAFFIC_AWARE es incompatible con el parámetro trafficModel.

4. Selecciona el modelo de tráfico que se usará con el parámetro trafficModel y uno de los siguientes tipos:

   • BEST_GUESS (predeterminado) para solicitar que el valor duration_in_traffic que se muestra sea la mejor estimación del tiempo de viaje según lo que se conoce sobre las condiciones del tráfico histórico y el tráfico en tiempo real. Cuanto más se acerque el valor de departure_time al momento presente, más importancia cobrará el tráfico en tiempo real. Usar el tipo predeterminado de BEST_GUESS proporciona las predicciones más útiles para la gran mayoría de los casos de uso.

   • PESSIMISTIC para solicitar que el duration_in_traffic devuelto modelice el tiempo en función de las condiciones de tráfico históricas en los días de tráfico intenso. Este tipo proporciona una duración estimada que es más probable que sea mayor que el tiempo de viaje real la mayoría de los días. Es posible que, en ocasiones, los días con condiciones particularmente desfavorables superen esta estimación.

   • OPTIMISTIC para solicitar que el duration_in_traffic devuelto modelice el tiempo en función de las condiciones de tráfico históricas en los días de buen tráfico. Este tipo proporciona una duración estimada que es más probable que sea más corta que el tiempo de viaje real la mayoría de los días. Es posible que, en días ocasionales con condiciones particularmente buenas, el tiempo sea menor que esta estimación.

   Por ejemplo:

   "trafficModel": "OPTIMISTIC"

5. Especifica el campo routes.duration en la máscara de campo.

   REST

   -H X-Goog-FieldMask: routes.duration

   RPC

   const (fieldMask = "routes.duration")

Cuando la API de Routes estima el tiempo en el tráfico, usa el tipo de modelo de tráfico que solicitaste.

Ejemplo: Solicitud de modelo de tráfico

Por ejemplo, esta solicitud especifica que la duración se debe estimar con el tipo de modelo de tráfico OPTIMISTIC en un horario de salida 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'

Esta solicitud devuelve la duración estimada con el tipo de modelo de tráfico OPTIMISTIC para el viaje:

"duration": "1238s"

Si cambias el tipo de modelo de tráfico a PESSIMISTIC, la duración que se muestra es mayor:

"duration": "2436s"