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 afectan las condiciones de tráfico al tiempo total de viaje de 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 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 el origen y el destino.

  2. Si tu hora de salida es en el futuro, inclúyela 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 el valor 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 de tráfico históricas 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 que se muestra modele el tiempo en función de las condiciones de tráfico históricas en días de tráfico deficiente. 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. Es posible que los días ocasionales en los que las condiciones sean particularmente malas 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 de 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 en los que las condiciones son 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 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 en 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 del viaje con el tipo de modelo de tráfico OPTIMISTIC:

"duration": "1238s"

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

"duration": "2436s"