Las preferencias de tráfico que selecciones equilibran la precisión de los detalles de la ruta con el rendimiento de la solicitud. Cuando haces una solicitud, debes considerar si es mejor mostrar los resultados más precisos posibles o mostrarlos lo más rápido posible. La API de Routes proporciona opciones que te permiten controlar la calidad de los datos de la respuesta en comparación con la latencia de la respuesta.
Establece el nivel de datos de tráfico
La API de Routes proporciona RoutingPreference (REST) y RoutingPreference (gRPC) que te permiten especificar preferencias de enrutamiento para calcular rutas. Estas preferencias difieren en la medida en que tienen en cuenta las condiciones de tráfico en el cálculo de la ruta. Cada preferencia de planificación de ruta produce resultados que difieren en cierto grado 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 velocidad del flujo de tráfico. Por ejemplo:
- Cuando no hay congestión, las condiciones de tráfico se consideran normales y el tráfico fluye a la velocidad normal sin obstáculos.
- A medida que se acerca la hora pico, aumenta la densidad del tráfico, lo que hace que se ralentice, lo que genera condiciones de tráfico leves a moderadas.
- En el tráfico lento, la tasa de flujo se detiene, lo que genera condiciones de tráfico intenso.
Sin tráfico
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 incluye en la propiedad de respuesta
duration.Las propiedades de respuesta
durationystaticDurationcontienen el mismo valor.
Usa esta preferencia de planificación de ruta cuando quieras que las respuestas se muestren lo más rápido posible y los detalles aproximados de la planificación de ruta sean lo suficientemente buenos.
Con conocimiento del tráfico
Cuando configuras la preferencia de enrutamiento TRAFFIC_AWARE, las rutas se calculan teniendo en cuenta las condiciones de tráfico actuales. Como resultado, la ruta y sus detalles reflejan con mayor precisión las condiciones reales. Debido a que este aumento en la calidad de los datos se produce 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 encuentra 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 quieras obtener detalles de enrutamiento más precisos que los de TRAFFIC_UNAWARE y, sin embargo, no te importa si las respuestas se muestran con un aumento moderado de la latencia.
Optimizada en función del 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 planificación de ruta TRAFFIC_AWARE_OPTIMAL es equivalente al modo que usan maps.google.com y la app de Google Maps para dispositivos móviles.
Cuando se usa 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 Cómo calcular una matriz de rutas.
En la respuesta, figura lo siguiente:
La hora de llegada estimada que tiene en cuenta el tráfico en tiempo real se encuentra 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 la demora más larga). Usa esta preferencia de enrutamiento cuando desees obtener resultados de la más alta calidad, sin importar cuánto demoren las respuestas.
Efecto de establecer 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 será el momento en que realices la solicitud.
En el caso de
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 horario.En el caso de
TRAFFIC_AWAREyTRAFFIC_AWARE_OPTIMAL, que tienen en cuenta las condiciones del tráfico en tiempo real, este se vuelve más importante a medida quedepartureTimese acerca al momento presente. Cuanto más adelante establezcas la hora de salida, más se tendrán en cuenta las condiciones históricas del tráfico.
Ejemplo de configuración de la preferencia de enrutamiento
En el siguiente código JSON, se muestra cómo configurar 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" }
Configura el tráfico en polilíneas
La API de Routes te permite solicitar información sobre las condiciones de tráfico a lo largo de una polilínea que tenga en cuenta el tráfico. Consulta Cómo solicitar polilíneas para obtener más información.