Proporciona instrucciones sobre cómo llegar entre varias ubicaciones en transporte público, bicicleta, automóvil, vehículos motorizados de 2 ruedas o a pie, con información del tráfico en tiempo real.
¿Necesitas matrices de rutas? Si te interesa una matriz de rutas, consulta la descripción general de Compute Routes Matrix.
¿Estás migrando? Si migras desde la API de Distance Matrix (heredada), consulta las instrucciones de migración que comienzan con Por qué migrar a la API de Routes.
Por qué usar Compute Routes
Con Compute Routes, puedes planificar rutas para tus vehículos o paquetes según tus preferencias con un amplio rango de detalles de ruta, a la vez que optimizas el costo y la calidad.
¿Qué puedes hacer con Compute Routes?
Con el método Compute Routes
de la API de Routes, puedes hacer lo siguiente:
Obtén instrucciones sobre cómo llegar a un destino o a varios destinos con diferentes medios de transporte:
Modos de transporte: transporte público, automóvil, vehículos de dos ruedas, a pie o en bicicleta
Una serie de puntos de referencia que puedes optimizar para determinar el orden más eficiente en el que viajar a ellos.
Usa varias formas de especificar orígenes, destinos y puntos de referencia:
Cadenas de texto Por ejemplo, "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043" o "CWF6+FWX Mountain View, California"
IDs de lugar
Coordenadas de latitud y longitud, opcionalmente con el rumbo del vehículo
Ajusta las opciones de ruta según tus necesidades y objetivos:
Selecciona rutas que ahorren combustible o energía según el tipo de motor de tu vehículo: diésel, eléctrico, híbrido o gasolina. Para obtener más información, consulta Cómo obtener una ruta ecológica.
Establece opciones detalladas para el cálculo del tráfico, lo que te permite tomar decisiones sobre la calidad en función de la latencia. Para obtener más información, consulta Cómo especificar si se incluyen datos de tráfico y cómo hacerlo.
Establece el rumbo del vehículo (dirección de viaje) y la información del costado de la ruta para los puntos de referencia para aumentar la precisión de la hora de llegada estimada. Para obtener más información, consulta Especifica el sentido de circulación y el lado de la ruta del vehículo.
Especifica las ubicaciones de paso y de terminal, y las ubicaciones de parada seguras. Para obtener más información, consulta Cómo establecer una parada a lo largo de una ruta y Cómo establecer un punto por el que debe pasar una ruta.
Solicita información sobre peajes, junto con la distancia de la ruta y la hora de llegada estimada. Para obtener más información, consulta Cómo calcular los peajes de una ruta.
Controla la latencia y la calidad solicitando solo los datos que necesitas con una máscara de campo, lo que te ayuda a evitar tiempos de procesamiento innecesarios y tarifas de facturación de solicitudes más altas. Para obtener más información, consulta Elige qué información mostrar.
Cómo funcionan las rutas de procesamiento
El método ComputeRoutes
de la API de Routes acepta una solicitud POST HTTP con un cuerpo de solicitud JSON que contiene los detalles de la solicitud. Se requieren un origen, un destino, travelMode
y una máscara de campo para especificar qué campos mostrar.
Ejemplo
curl -X POST -d '{ "origin": { "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043" }, "destination": { "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Luego, el servicio calcula la ruta solicitada y muestra los campos que solicitaste.
Recursos
En la siguiente tabla, se resumen los recursos disponibles a través del método Compute Routes de la API de Routes, junto con los datos que muestra.
Recursos de datos | Datos que se muestran | Formato de la devolución |
---|---|---|
ComputeRoutes | Muestra las rutas, los tramos y los pasos de una ruta, con rutas alternativas, si se solicita. | JSON |
Cómo usar Compute Routes
1 | Prepárate | Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuación. |
2 | Comprende cómo factura la API de Routes | Para obtener información, consulta Uso y facturación. |
3 | Cómo calcular una ruta y revisar la respuesta | Para obtener más información, consulta Cómo obtener una ruta y Cómo revisar las respuestas de la ruta. |
Bibliotecas cliente disponibles
Para obtener una lista de las bibliotecas cliente disponibles para Compute Routes, consulta Bibliotecas cliente.
¿Qué sigue?
- Obtén una ruta
- Opciones de ruta disponibles
- Elige qué información mostrar
- Cómo migrar de la API de Directions (heredada)
- Cómo migrar de la versión preliminar de la API de Routes a la versión GA