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 total de viaje para una ruta determinada. La API de Routes ofrece diferentes tipos de modelos de tráfico para priorizar diferentes factores que se usan para calcular 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 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. Configura tu origen y destino.

  2. Si tu hora de salida es en el futuro, inclúyela mediante el parámetro departure_time. Si no especificas una hora de salida, se usará el valor predeterminado de “hoy”.

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

    • BEST_GUESS (predeterminado) para solicitar que el objeto duration_in_traffic que se muestra sea la mejor estimación de la duración del viaje según lo que se conoce sobre las condiciones históricas del tráfico y el tráfico en tiempo real. Cuanto más se acerque el valor de departure_time al momento presente, más importante será el tráfico en vivo. 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 la hora en función de las condiciones de tráfico históricas en días con mucho tráfico. Este tipo proporciona una duración estimada que, probablemente, sea mayor que el tiempo de viaje real en la mayoría de los días. Los días ocasionales con condiciones particularmente malas pueden exceder esta estimación.

    • OPTIMISTIC para solicitar que el duration_in_traffic que se muestra modele la hora 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 el tiempo de viaje real en la mayoría de los días. Los días ocasionales 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 calcula el tiempo en el tráfico, usa el tipo de modelo de tráfico que hayas solicitado.

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"