Cuando realizas una solicitud, es posible que debas tomar una decisión sobre si es mejor mostrar los resultados más precisos posibles o mostrar los resultados 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.
Configura el nivel de los datos de tráfico
La API de Routes proporciona RoutePreference (REST) y RoutingPreference (gRPC) que te permiten especificar preferencias de enrutamiento para calcular rutas. Estas preferencias difieren en el hecho de que factorizan las condiciones del tráfico en el cálculo de la ruta. Cada preferencia de enrutamiento produce resultados que difieren en un grado con respecto a la calidad de la ruta, la hora de llegada estimada y la latencia de 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.
- Cuando se acerca la hora pico, la densidad del tráfico aumenta, lo que hace que el tráfico disminuya, lo que produce condiciones de tráfico moderado a moderado.
- En el tráfico de bumper a bumper, la tasa de flujo se detiene, lo que produce condiciones de tráfico intensos.
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:
La hora de llegada se encuentra en la propiedad de respuesta
duration.Las propiedades de respuesta
durationystaticDurationcontienen el mismo valor.
Usa esta preferencia de enrutamiento cuando quieras que las respuestas se muestren más rápido y los detalles del enrutamiento aproximado sean suficientes.
Conocimiento del tráfico
Cuando estableces la preferencia de enrutamiento TRAFFIC_AWARE, las rutas se calculan en función de las condiciones de tráfico actuales. Como resultado, los detalles de la ruta y la ruta reflejan con mayor precisión las condiciones del mundo real. Debido a que este aumento en la calidad de los datos se produce a expensas de la latencia de respuesta, las optimizaciones de rendimiento se aplican para reducir gran parte de la latencia.
En la respuesta:
La hora de llegada 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 de 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, pero no te importa si las respuestas se muestran con un aumento moderado en la latencia.
Optimizado para el tráfico
Cuando configuras la preferencia de enrutamiento TRAFFIC_AWARE_OPTIMAL, las rutas se calculan teniendo en cuenta las condiciones actuales del 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 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 usas esta opción con Compute Route Matrix, la cantidad de elementos en una solicitud (cantidad de orígenes × 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:
La hora de llegada 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 de 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 desees obtener resultados de la más alta calidad, sin importar cuánto tiempo demoren las respuestas.
Efecto de la configuración de la hora de salida
De manera opcional, usa la propiedad departureTime a fin de establecer la hora deseada para una salida de viaje. Si no configuras la propiedad departureTime, se establece de manera predeterminada la hora en que realizas la solicitud.
Para
TRAFFIC_UNAWARE, no puedes configurardepartureTimeporque la elección de la ruta y la duración se basan en la red de rutas y las condiciones de tráfico promedio independientes del tiempo.Para
TRAFFIC_AWAREyTRAFFIC_AWARE_OPTIMAL, que tienen en cuenta las condiciones del tráfico en tiempo real, el tráfico en vivo se vuelve más importante cuanto más cerca esté eldepartureTime. Cuanto más configures la hora de salida en el futuro, más consideración se da a las condiciones del tráfico histórico.
Ejemplo de configuración de 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"
}
Configurar la calidad de la polilínea
La API de Routes te permite solicitar información sobre las condiciones de tráfico junto con una polilínea optimizada para el tráfico. Consulta Solicitar polilíneas para obtener más información.
La calidad de una polilínea puede describirse en los siguientes términos:
la cantidad de puntos que conforman la polilínea
Cuantos más puntos haya, más suave será la polilínea (especialmente en las curvas).
La precisión de punto flotante de los puntos
Los puntos se especifican como valores de latitud y longitud, que se representan en formato de punto flotante de precisión simple. Esto funciona bien para valores pequeños (que se pueden representar con precisión), pero la precisión disminuye a medida que los valores aumentan debido a errores de redondeo de punto flotante.
Los métodos computeRoutes (REST) y ComputeRoutes (gRPC) admiten la opción de solicitud polylineQuality para controlar la calidad de la polilínea.
Ejemplo de configuración de calidad de polilínea
polylineQuality especifica la calidad de la polilínea como HIGH_QUALITY o OVERVIEW (valor predeterminado). Con OVERVIEW, la polilínea se compone con una pequeña cantidad de puntos y tiene una latencia de solicitud menor que HIGH_QUALITY.
Por ejemplo, en el cuerpo de la solicitud:
{
"origin":{
"location":{
"latLng":{
"latitude": 37.419734,
"longitude": -122.0827784
}
}
},
"destination":{
"location":{
"latLng":{
"latitude": 37.417670,
"longitude": -122.079595
}
}
},
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE",
"polylineQuality": "HIGH_QUALITY",
"polylineEncoding": "ENCODED_POLYLINE",
"departureTime": "2023-10-15T15:01:23.045123456Z",
...
}