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
Establece el origen y el destino.
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.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 valorduration_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 dedeparture_time
al momento presente, más importancia cobrará el tráfico en tiempo real. Usar el tipo predeterminado deBEST_GUESS
proporciona las predicciones más útiles para la gran mayoría de los casos de uso.PESSIMISTIC
para solicitar que elduration_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 elduration_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"
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"