Las preferencias de tráfico que seleccionas equilibran la precisión de los detalles de la ruta con el rendimiento de la solicitud. Cuando realices una solicitud, debes sopesar si es mejor mostrar los resultados más precisos posible o hacerlo lo más rápido posible. La API de Routes proporciona opciones que te permiten controlar la calidad de los datos de respuesta en comparación con la latencia de la respuesta.
Establece el nivel de los datos de tráfico
La API de Routes proporciona RoutingPreference (REST) y RoutingPreference (gRPC), que te permite especificar las preferencias de enrutamiento para calcular las rutas. Estas preferencias difieren en la medida en que incluyen las condiciones del tráfico en el cálculo de la ruta. Cada preferencia de enrutamiento produce resultados que difieren en cierta medida en cuanto a la calidad de la ruta, la hora de llegada estimada y la latencia de la respuesta.
Las condiciones de tráfico caracterizan la frecuencia del flujo de tráfico. Por ejemplo:
- Cuando no hay congestión, las condiciones del tráfico se consideran normales y el tráfico fluye a la velocidad normal sin obstáculos.
- Cuando se acerca la hora pico de tráfico, aumenta la densidad del tráfico, lo que ralentiza el tráfico y genera condiciones de tráfico leves a moderadas.
- En el tráfico entre embotellamientos, la tasa de flujo se detiene, lo que genera condiciones de tráfico intensas.
Tráfico desconocido
Cuando estableces la preferencia de enrutamiento TRAFFIC_UNAWARE, las rutas se calculan sin tener en cuenta las condiciones de tráfico actuales. Esta preferencia de enrutamiento proporciona la latencia de respuesta más baja (las respuestas se muestran más rápido).
TRAFFIC_UNAWARE es la configuración predeterminada.
En la respuesta, figura lo siguiente:
La hora de llegada estimada se encuentra en la propiedad de respuesta
duration.Las propiedades de respuesta
durationystaticDurationcontienen el mismo valor.
Usa esta preferencia de enrutamiento cuando desees que las respuestas muestren la respuesta más rápida y los detalles de enrutamiento aproximados sean lo suficientemente buenos.
Reconocimiento de tráfico
Cuando estableces la preferencia de enrutamiento TRAFFIC_AWARE, las rutas se calculan teniendo en cuenta las condiciones actuales del tráfico. Como resultado, los detalles de la ruta y de la ruta reflejan con mayor precisión las condiciones del mundo real. Debido a que este aumento en la calidad de los datos a expensas de la latencia de respuesta, se aplican optimizaciones de rendimiento para reducir gran parte de la latencia.
En la respuesta, figura lo siguiente:
La hora de llegada estimada que tiene en cuenta el tráfico en tiempo real se incluye en la propiedad de respuesta
duration.La propiedad de respuesta
staticDurationcontiene la duración del viaje por la ruta sin tener en cuenta las condiciones de tráfico.
Usa esta preferencia de enrutamiento cuando desees obtener detalles de enrutamiento más precisos que TRAFFIC_UNAWARE. Sin embargo, no te importa que las respuestas se muestren con un aumento moderado de la latencia.
Óptimo en reconocimiento de tráfico
Cuando estableces la preferencia de enrutamiento TRAFFIC_AWARE_OPTIMAL, las rutas se calculan teniendo en cuenta las condiciones de tráfico actuales, pero no se aplican optimizaciones de rendimiento. En este modo, el servidor realiza una búsqueda más exhaustiva de la red de rutas para encontrar la ruta óptima.
La preferencia de enrutamiento TRAFFIC_AWARE_OPTIMAL es equivalente al modo que usan maps.google.com y la app para dispositivos móviles de Google Maps.
Cuando se utiliza esta opción con Compute Route Matrix, la cantidad de elementos en una solicitud (cantidad de orígenes × cantidad de destinos) no puede superar los 100. Para obtener más información sobre los límites de Compute Route Matrix, consulta Calcula una matriz de ruta.
En la respuesta, figura lo siguiente:
La hora de llegada estimada que tiene en cuenta el tráfico en tiempo real se incluye en la propiedad de respuesta
duration.La propiedad de respuesta
staticDurationcontiene la duración del viaje por la ruta sin tener en cuenta las condiciones de tráfico.
Esta preferencia de enrutamiento proporciona la latencia de respuesta más alta (es decir, las respuestas se muestran con el retraso más largo). Usa esta preferencia de enrutamiento cuando quieras obtener resultados de la más alta calidad, sin importar cuánto tarden las respuestas.
Efecto de configurar la hora de salida
De forma opcional, puedes usar la propiedad departureTime para establecer la hora de salida de un viaje. Si no configuras la propiedad departureTime, el valor predeterminado es la hora en que realizas la solicitud.
Para
TRAFFIC_UNAWARE, no puedes establecerdepartureTimeporque la elección de la ruta y la duración se basan en la red de rutas y las condiciones de tráfico promedio independientemente del tiempo.Para
TRAFFIC_AWAREyTRAFFIC_AWARE_OPTIMAL, que tienen en cuenta las condiciones de tráfico en tiempo real, el tráfico en vivo se vuelve más importante cuanto más se acerque eldepartureTimeal momento actual. Cuanto más establezcas la hora de salida en el futuro, más se tendrán en cuenta las condiciones de tráfico históricas.
Ejemplo de preferencia de enrutamiento del parámetro de configuración
En el siguiente código JSON, se muestra cómo establecer la preferencia de enrutamiento en el cuerpo de una entidad de mensaje de solicitud.
{
"origin":{
"location":{
"latLng":{
"latitude":37.419734,
"longitude":-122.0827784
}
}
},
"destination":{
"location":{
"latLng":{
"latitude":37.417670,
"longitude":-122.079595
}
}
},
"travelMode":"DRIVE",
"routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}
Cómo configurar el tráfico en las polilíneas
La API de Routes te permite solicitar información sobre las condiciones de tráfico en una polilínea optimizada para el tráfico. Consulta Cómo solicitar polilíneas para obtener más información.