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

Los modelos de tráfico usan algoritmos y factores específicos para predecir cómo las condiciones de tráfico afectan el tiempo de viaje total de una ruta determinada. La API de Routes ofrece diferentes tipos de modelos de tráfico para priorizar diferentes factores que se usan en el cálculo de la duración del 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 tu matriz de rutas. Cuando configuras el tipo de modelo de tráfico, el valor que se muestra en el campo duration varía según el modelo de tráfico que elijas.

Los métodos Compute Routes y Compute Route Matrix de la API de Routes 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. Establece tu origen y destino.

2. Si la hora de salida es futura, incluye la hora con el parámetro departure_time. Si no especificas una hora de salida, se establecerá en la hora actual.

3. 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 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. El uso del 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 que se muestra modele el tiempo en función de las condiciones de tráfico históricas en días de mucho tráfico. Este tipo proporciona una duración estimada que es más larga que el tiempo de viaje real en la mayoría de los días. Es posible que algunos días con condiciones de tráfico particularmente desfavorables superen esta estimación.

   • OPTIMISTIC para solicitar que el duration_in_traffic que se muestra modele el tiempo en función de las condiciones de tráfico históricas en días con buen tráfico. Este tipo proporciona una duración estimada que es más corta que el tiempo de viaje real la mayoría de los días. En ocasiones, los días con condiciones particularmente buenas pueden ser más rápidos que esta estimación.

   Por ejemplo:

   "trafficModel": "OPTIMISTIC"

4. 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 a una hora de salida específica:

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 muestra 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 más larga:

"duration": "2436s"