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
Configura tu origen y destino.
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.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 elduration_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á eldeparture_time
al ahora. Usa el tipo predeterminado deBEST_GUESS
brinda las predicciones más útiles para la gran mayoría de casos de uso.PESSIMISTIC
para solicitar que elduration_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 elduration_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"
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"