Por qué usar la API de Routes
Con la API de Routes, puedes obtener rutas y datos de viajes precisos con detalles de transporte, condiciones de tráfico y de las rutas actualizadas, y preferencias de ruta:
Tipo y capacidades de los diferentes medios de transporte
Indica la dirección en la que se dirige un vehículo.
El lado de la ruta para subir o bajar pasajeros
Condiciones del tráfico y rutas cerradas
Preocupaciones de seguridad, como evitar áreas peligrosas o proporcionar áreas de partida seguras
Equilibra la latencia, la calidad y el costo en tus necesidades de planificación de ruta con funciones opcionales, como peajes y metadatos de viaje, como tiempo y distancia, y eficiencia de combustible.
También puedes determinar las rutas más eficientes para la programación de despachos, como las siguientes:
La mejor manera de asignar un conjunto de trabajadores para que recojan una serie de paquetes
Determinar el mejor almacén desde el que enviar paquetes a su destino final
¿Qué puedes hacer con la API de Routes?
Con la API de Routes, puedes obtener dos categorías principales de información de planificación de ruta:
Rutas desde una ubicación a uno o varios destinos
Una matriz de rutas posibles entre muchas ubicaciones de partida y destino.
Cómo obtener rutas para uno o varios destinos
Con el método Compute Routes de la API de Routes, puedes calcular lo siguiente entre ubicaciones:
Obtén instrucciones sobre cómo llegar a un destino o a varios con diferentes medios de transporte:
Medios de transporte, incluidos transporte público, conducción, vehículos de dos ruedas, caminar o circular en bicicleta
Una serie de puntos de referencia que puedes optimizar para determinar el orden más eficiente en el que recorrerlos.
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 tus 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.
Obtén una matriz de rutas posibles
El método Compute Route Matrix de la API de Routes proporciona una matriz de información para las rutas recomendadas entre varios puntos de partida y destino, incluida la distancia y los tiempos de llegada estimados, para ayudarte a elegir los mejores orígenes y destinos según tus necesidades comerciales. Puedes solicitar estos tipos de datos de distancia:
Distancia para un medio de transporte seleccionado
Distancia en kilómetros o millas
Tiempo estimado de viaje en el tráfico
Con los datos de distancia, puedes determinar la forma más eficiente de planificar rutas para pasajeros, envíos o trabajadores entre varios orígenes y destinos posibles.
Puedes transmitir elementos de la respuesta antes de que se haya calculado toda la matriz, lo que reduce la latencia de la respuesta.
Puedes especificar varios orígenes y destinos por solicitud del servidor con la cantidad de orígenes por la cantidad de destinos hasta 625.
Cómo funciona la API de Routes
La API de Routes tiene dos métodos: ComputeRoutes y ComputeRouteMatrix.
ComputeRoutes
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, un 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.
ComputeRouteMatrix
La API de Routes ComputeRouteMatrix acepta una solicitud POST HTTP con un cuerpo de solicitud JSON que contiene los detalles de la solicitud. Se requiere al menos un origen, dos o más destinos, travelMode y una máscara de campo para especificar qué campos mostrar.
Ejemplo
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
La respuesta contiene las rutas posibles para la combinación de todos los puntos de destino y origen.
Recursos
En la siguiente tabla, se resumen los recursos disponibles a través de la API de Routes junto con los datos que muestra.
| Recursos de datos | Datos que se muestran | Formato de devolución |
|---|---|---|
| ComputeRoutes | Muestra las rutas, los tramos y los pasos de una ruta, con rutas alternativas, si se solicita. | JSON |
| ComputeRouteMatrix | Devuelve un array de rutas desde un punto de referencia de origen hasta un punto de referencia de destino. |
Cómo usar la API de 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 | 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. |
| 3 | Cómo calcular la matriz de rutas y revisar la respuesta | Para obtener más información, consulta Obtén una matriz de rutas y Revisa la respuesta de la matriz de rutas. |
Bibliotecas cliente disponibles
Para obtener una lista de las bibliotecas cliente disponibles para la API de Routes, consulta Bibliotecas cliente.