La API de Routes Preferred proporciona tres preferencias de ruta para calcular rutas. Se diferencian en la medida en que tienen en cuenta las condiciones de tráfico en el cálculo de la ruta. Cada preferencia de ruta produce resultados que difieren en cierto grado en cuanto a la calidad de la ruta, la ETA estimada y la latencia de respuesta.
Acerca de las condiciones de tráfico
Las condiciones de tráfico caracterizan la tasa de 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 y produzca condiciones de tráfico de leves a moderadas.
En el tráfico de parachoques a parachoques, la tasa de flujo se detiene, lo que produce condiciones de tráfico pesado.
Sin información de tráfico
Cuando estableces la
TRAFFIC_UNAWARE
preferencia de ruta, las rutas se calculan sin tener en cuenta las condiciones de tráfico. Esta preferencia de ruta proporciona la latencia de respuesta más baja (las respuestas se muestran más rápido).
Usa esta preferencia de ruta cuando quieras que las respuestas se muestren más rápido y los detalles de la ruta aproximados sean lo suficientemente buenos.
Con información de tráfico
Cuando estableces la
TRAFFIC_AWARE
preferencia de ruta, las rutas se calculan teniendo en cuenta las condiciones de tráfico. Como resultado, la ruta y los detalles de la ruta reflejan con mayor precisión las condiciones del mundo real. Dado 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.
Usa esta preferencia de ruta cuando quieras detalles de ruta más precisos y no te importe si las respuestas se muestran con un aumento moderado en la latencia.
Óptima con información de tráfico
Cuando estableces la
TRAFFIC_AWARE_OPTIMAL
preferencia de ruta, las rutas se calculan teniendo en cuenta las condiciones de tráfico, pero
no se aplican optimizaciones de rendimiento. En este modo, el servidor realiza una búsqueda más exhaustiva de la red de carreteras para encontrar la ruta óptima.
Esta preferencia de ruta proporciona la latencia de respuesta más alta (es decir, las respuestas se muestran con la mayor demora). Usa esta preferencia de ruta cuando quieras resultados de la más alta calidad, sin importar cuánto tarden las respuestas.
Ejemplo
En el siguiente código JSON, se muestra cómo establecer la preferencia de ruta en un cuerpo de 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" }