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 y las condiciones afectan el tiempo total de viaje para una ruta determinada. La API de Routes ofrece diferentes tipos de modelos de tráfico para priorizar los distintos factores que se usan en calcular la duración en el tráfico. Puedes especificar el tipo de modelo de tráfico como las rutas que debes usar para calcular la duración de tus rutas de salida. Cuando estableces el tipo de modelo de tráfico, el valor devuelto 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 salida es en el futuro, incluye la hora a través de la Parámetro departure_time. Si no especificas una hora de salida, la configuración predeterminada es ahora.

3. Selecciona el modelo de tráfico que deseas usar con el parámetro trafficModel. uno de los siguientes tipos:

   • BEST_GUESS (predeterminado) para solicitar que se muestre el duration_in_traffic. es la mejor estimación del tiempo de viaje dado lo que se conoce sobre ambos las condiciones históricas de tráfico y el tráfico en tiempo real. El tráfico en vivo aumenta más importante, más cerca está el departure_time al ahora. Usa el tipo predeterminado de BEST_GUESS brinda las predicciones más útiles para la gran mayoría de casos de uso.

   • PESSIMISTIC para solicitar que el duration_in_traffic que se muestra modele el tiempo en función de las condiciones históricas de tráfico en días con mucho tráfico. Este tipo proporciona una duración estimada que probablemente sea mayor que la duración real del viaje la mayoría de los días. Días ocasionales con malas condiciones podrían exceder esta estimación.

   • OPTIMISTIC para solicitar que el duration_in_traffic que se muestra modele el tiempo en función de las condiciones históricas de tráfico en días con buen tráfico. Este tipo proporciona una duración estimada que probablemente sea menor que la duración real del viaje la mayoría de los días. Días ocasionales con acceso buenas condiciones aún puede ser más rápido 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 calcula el tiempo en el tráfico, usa el tráfico y el tipo de modelo que solicitaste.

Ejemplo: Solicitud de modelo de tráfico

Por ejemplo, esta solicitud especifica que la duración se debe estimar usando el valor 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 modelo de tráfico OPTIMISTIC tipo para el viaje:

"duration": "1238s"

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

"duration": "2436s"