Especifica cómo y si quieres incluir datos de tráfico

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, quieres sopesar si es mejor devolver los resultados más precisos posibles o que 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 los datos de tráfico

La API de Routes proporciona RoutingPreference (REST) y RoutingPreference (gRPC) que te permiten especificar las preferencias de enrutamiento para calcular las 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 enrutamiento produce resultados que difieren en cuanto a la calidad de la ruta, la hora de llegada estimada estimada y la latencia de respuesta.

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 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 generará 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 y staticDuration contienen lo 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 estableces la preferencia de enrutamiento TRAFFIC_AWARE, las rutas se calculan y considerar las condiciones actuales del tráfico. Como resultado, la ruta y la ruta detalles que reflejen 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 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 Calcula 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, la configuración predeterminada será el momento en que realices la solicitud.

  • Para TRAFFIC_UNAWARE, no puedes establecer departureTime porque la elección la ruta y la duración se basan en la red de rutas y el tiempo promedio, condiciones de tráfico.

  • Para TRAFFIC_AWARE y TRAFFIC_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á el departureTime 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.