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 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 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, la configuración predeterminada es ahora.

  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 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. 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 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 de tráfico históricas 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. 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 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"