Las preferencias de tráfico que seleccionas 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 respuesta frente a 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. Estos las preferencias difieren en la medida en que tienen en cuenta las condiciones del tráfico al 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 fluya a la velocidad normal y sin obstáculos.
- Aproximándose a la hora pico de energía, aumenta la densidad, lo que provoca que el tráfico disminuir la velocidad, lo que genera condiciones de tráfico de leve a moderada.
- En el tráfico de embotellamientos, la tasa de flujo se detiene por completo, lo que genera un condiciones de tráfico.
No se reconoce el tráfico
Cuando estableces la preferencia de enrutamiento TRAFFIC_UNAWARE
, las rutas se calculan
sin tener en cuenta
las condiciones actuales del tráfico. Esta preferencia de enrutamiento
Proporciona la menor latencia de respuesta (las respuestas se muestran más rápido).
TRAFFIC_UNAWARE
es la configuración predeterminada.
En la respuesta, figura lo siguiente:
El ETA se incluye en la propiedad de respuesta
duration
.Las propiedades de respuesta
duration
ystaticDuration
contienen el mismo valor.
Usa esta preferencia de enrutamiento cuando desees que las respuestas se devuelvan más rápido. detalles de rutas aproximadas son suficientes.
Compatible con el 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 de
la calidad de los datos se produce a expensas de la latencia de la respuesta, la optimización del rendimiento
se aplican para reducir gran parte de la latencia.
En la respuesta, figura lo siguiente:
La hora de llegada estimada que considera el tráfico en tiempo real se encuentra en La propiedad de respuesta de
duration
.La propiedad de respuesta
staticDuration
contiene la duración del viaje. a lo largo de la ruta sin tener en cuenta las condiciones de tráfico.
Utiliza esta preferencia de enrutamiento cuando desees obtener detalles de enrutamiento más precisos que
TRAFFIC_UNAWARE
, y no te importa que las respuestas se devuelvan con un
un aumento moderado en la latencia.
Compatible con información sobre el tráfico
Cuando estableces la preferencia de enrutamiento TRAFFIC_AWARE_OPTIMAL
, las rutas se
calculada teniendo en cuenta las condiciones actuales del tráfico, pero ningún rendimiento
optimizaciones. En este modo, el servidor realiza un análisis
búsqueda de la red de rutas para encontrar la ruta óptima.
La preferencia de enrutamiento TRAFFIC_AWARE_OPTIMAL
es equivalente al modo que usa
maps.google.com y
App para dispositivos móviles de Google Maps
Cuando se usa esta opción con Compute Route Matrix, la cantidad de elementos en una solicitud (cantidad de orígenes × número de destinos) no puede exceder 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 considera el tráfico en tiempo real se encuentra en La propiedad de respuesta de
duration
.La propiedad de respuesta
staticDuration
contiene la duración del viaje. a lo largo de 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 quieren resultados de la más alta calidad, sin importar el tiempo que 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 será el momento en que realices la solicitud.
Para
TRAFFIC_UNAWARE
, no puedes establecerdepartureTime
porque la elección de la ruta y la duración se basan en la red de rutas y el tiempo promedio, condiciones de tráfico.Para
TRAFFIC_AWARE
yTRAFFIC_AWARE_OPTIMAL
, que toman tráfico en vivo condiciones actuales, el tráfico en tiempo real se vuelve más importante más cerca está eldepartureTime
al ahora. Cuanto más lejos establezcas la hora de salida en el futuro, más se tendrá en cuenta el tráfico histórico condiciones.
Ejemplo de configuración de la preferencia de enrutamiento
El siguiente código JSON demuestra cómo establecer la preferencia de enrutamiento en un del cuerpo de la entidad del mensaje 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_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 a lo largo de una polilínea optimizada para el tráfico. Consulta Solicita polilíneas para obtener más información.