Cómo calcular rutas

La herramienta compute_routes devuelve una ruta entre un origen y un destino para un medio de transporte determinado. La respuesta incluye la distancia y la duración de la ruta. De forma predeterminada, las rutas se calculan sin tráfico en tiempo real. Pro agrega rutas que tienen en cuenta el tráfico en tiempo real y rutas con más paradas intermedias.

En esta página, se describen las opciones de solicitud, incluidas las opciones de Pro, lo que contiene la respuesta y cómo se facturan las solicitudes. Para ver el esquema completo de la herramienta, consulta la referencia de compute_routes.

Opciones de solicitud

Opción Descripción
origin, destination Obligatorio. Cada uno es un punto de referencia: un address (una dirección legible por humanos o un Plus Code), un place_id o un lat_lng. Puedes mezclar formatos, por ejemplo, una dirección para el origen y un ID de lugar para el destino.
travel_mode El medio de transporte: DRIVE (predeterminado), WALK, BICYCLE o TRANSIT. Las rutas para WALK están en versión beta y, a veces, es posible que no incluyan aceras o rutas peatonales claras. Debes mostrar esta advertencia al usuario para todas las rutas a pie que muestres en tu app.
routing_preference Cómo se usan los datos de tráfico para calcular la ruta: ROUTING_PREFERENCE_TRAFFIC_UNAWARE (predeterminado) o ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, que es una opción Pro. ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL no es compatible con WALK ni BICYCLE. Consulta Rutas con información de tráfico en tiempo real.
intermediate_waypoints Son paradas ordenadas entre el origen y el destino. La ruta pasa por ellos en el orden indicado. Una solicitud puede incluir hasta 10 puntos de referencia intermedios, o de 11 a 25 como una opción Pro. Una solicitud con más de 25 devuelve un error INVALID_ARGUMENT. Las rutas de transporte público no admiten puntos de referencia intermedios.
departure_time o arrival_time Cuándo salir del origen o llegar al destino, como una marca de tiempo RFC 3339. Establece un valor como máximo. La configuración predeterminada es la hora actual de salida. Para TRANSIT, la hora puede ser de hasta 7 días en el pasado o 100 días en el futuro. Para otros medios de transporte, la hora no puede ser en el pasado y puede ser de hasta 365 días en el futuro.
compute_alternative_routes Cuando se establece en true, la respuesta incluye rutas alternativas además de la ruta recomendada, cuando hay alternativas disponibles. La configuración predeterminada es false.
include_polyline Cuando se establece en true, cada ruta de la respuesta incluye encodedPolyline. La configuración predeterminada es false.
location_bias Una latitud y una longitud que sesgan la forma en que se resuelven los puntos de referencia de texto, por ejemplo, para eliminar la ambigüedad de una dirección.

Opciones de Pro

Dos opciones seleccionan el SKU Pro. Una solicitud que use uno o ambos se facturará con el SKU Pro:

Opción Pro Cuándo se utiliza
Se estableció ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL como la dirección de tu routing_preference El usuario pregunta sobre el tráfico, la congestión o la duración del viaje que tiene en cuenta el tráfico actual. Consulta Rutas con información de tráfico en tiempo real.
De 11 a 25 intermediate_waypoints La ruta necesita más de 10 paradas entre el origen y el destino.

Todas las demás opciones se facturan con el SKU de Essentials, incluidos el modo de viaje, el tiempo, las rutas alternativas, las polilíneas y la preferencia de ubicación.

Rutas con información del tráfico

De forma predeterminada, las rutas se calculan sin condiciones de tráfico en tiempo real (ROUTING_PREFERENCE_TRAFFIC_UNAWARE). Este parámetro de configuración tiene la latencia más baja. Es adecuado para solicitudes en las que el tráfico no importa o no se aplica, como rutas a pie o planificación aproximada.

Establece routing_preference en ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL para calcular la ruta y su duración con las condiciones de tráfico actuales, cuando haya datos de tráfico disponibles. Úsala cuando el usuario pregunte cuánto tiempo tarda un viaje en este momento. Para las rutas de TRANSIT, este parámetro de configuración usa datos de transporte público en tiempo real, como retrasos y cancelaciones, cuando están disponibles. No se admite para las rutas WALK ni BICYCLE. Esas solicitudes devuelven un error INVALID_ARGUMENT. Esta es una opción Pro, por lo que la solicitud se factura con el SKU Pro. La opción también agrega latencia.

Durante la DG restringida, si tu proyecto no está en la lista de entidades permitidas de Pro, esta opción se trata como ROUTING_PREFERENCE_TRAFFIC_UNAWARE. Para obtener más detalles, consulta Opciones de Pro durante la DG restringida.

Ejemplo

En la siguiente solicitud, se pide una ruta en automóvil que tenga en cuenta el tráfico, con una parada intermedia y una polilínea codificada. Se factura con el SKU de Pro:

{
  "method": "tools/call",
  "params": {
    "name": "compute_routes",
    "arguments": {
      "origin": {"address": "Ferry Building, San Francisco, CA"},
      "destination": {"address": "Golden Gate Park, San Francisco, CA"},
      "intermediate_waypoints": [
        {"address": "Palace of Fine Arts, San Francisco, CA"}
      ],
      "travel_mode": "DRIVE",
      "routing_preference": "ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL",
      "include_polyline": true
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

Respuesta

La respuesta contiene routes[], ordenadas de la más a la menos recomendada. Solo se devuelve una ruta, a menos que compute_alternative_routes sea true. Cada ruta incluye lo siguiente:

  • distanceMeters: Es la distancia de viaje de la ruta, en metros.
  • duration: Es el tiempo necesario para recorrer la ruta. Con ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, la duración tiene en cuenta las condiciones de tráfico.
  • encodedPolyline: Es la ruta de acceso de la ruta como una polilínea codificada, cuando include_polyline es true. Puedes usarla para dibujar la ruta en un mapa con otras APIs de Google Maps Platform.
  • attribution: Es la atribución que debes mostrar con la ruta. Consulta los requisitos de atribución.

Opciones de Pro durante la DG restringida

Durante la fase de DG restringida, las opciones de Pro solo están disponibles para los proyectos que se encuentran en la lista de entidades permitidas de Pro. Si tu proyecto aún no está en la lista de entidades permitidas, haz lo siguiente:

  • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL se trata como ROUTING_PREFERENCE_TRAFFIC_UNAWARE, y la solicitud se factura con el SKU de Essentials.
  • Una solicitud con más de 10 puntos de referencia intermedios devuelve un error INVALID_ARGUMENT ("Se admite un máximo de 10 puntos de referencia intermedios").

Para solicitar acceso, consulta Opciones de Pro durante la DG restringida.

Facturación y cuotas

Cada solicitud de compute_routes es un evento facturable:

Solicitar rutas alternativas, una polilínea, una hora de salida o llegada, o un medio de transporte diferente no cambia el SKU.

La cuota de compute_routes es de 300 consultas por minuto, por proyecto, compartida por ambos SKU. Para conocer los precios, consulta la tabla de precios principal y la tabla de precios de India.

Límites

  • Una solicitud puede incluir, como máximo, 25 puntos de referencia intermedios; de 11 a 25 es una opción Pro. Una solicitud con más de esa cantidad devuelve un error INVALID_ARGUMENT.
  • Las rutas de transporte público no admiten puntos de referencia intermedios. Una solicitud de transporte público con puntos de referencia intermedios devuelve un error INVALID_ARGUMENT.
  • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL no se admite para las rutas a pie o en bicicleta.
  • Para las rutas de transporte público, las horas de salida y llegada pueden ser de hasta 7 días en el pasado o 100 días en el futuro. Para otros medios de transporte, no pueden ser en el pasado y pueden ser hasta 365 días en el futuro.
  • Las coordenadas de los puntos de referencia deben estar dentro de límites geográficos válidos (latitud de -90 a 90, longitud de -180 a 180).
  • La herramienta no devuelve pasos, tramos ni detalles de líneas de transporte público.