La API de Routes Preferred proporciona tres preferencias de planificación de rutas 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 planificación de ruta genera resultados que difieren en cierta medida en cuanto a la calidad de la ruta, la hora de llegada estimada y la latencia de respuesta.
Información sobre las condiciones del tráfico
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 disminuya la velocidad, 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 planificación de ruta TRAFFIC_UNAWARE, las rutas se calculan sin tener en cuenta las condiciones de tráfico. Esta preferencia de enrutamiento proporciona la latencia de respuesta más baja (las respuestas se muestran más rápido).
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 estableces la preferencia de enrutamiento TRAFFIC_AWARE, las rutas se calculan teniendo en cuenta las condiciones de tráfico. Como resultado, la ruta y sus detalles reflejan con mayor precisión las condiciones reales. Dado que este aumento en la calidad de los datos se produce a expensas de la latencia de la respuesta, se aplican optimizaciones de rendimiento para reducir gran parte de la latencia.
Usa esta preferencia de enrutamiento cuando quieras obtener detalles de enrutamiento más precisos y no te importe si las respuestas se muestran con un aumento moderado de la latencia.
Optimizada en función del tráfico
Cuando estableces la preferencia de planificación de ruta TRAFFIC_AWARE_OPTIMAL, se calculan las rutas 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 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 tiempo tarden las respuestas.
Ejemplo
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"
}