Por qué usar la API de Routes
Con la API de Routes, puedes obtener información precisa sobre las rutas y los viajes mediante los detalles del transporte, las condiciones actualizadas del tráfico y las rutas, y las preferencias de ruta:
Tipo y capacidades de los diferentes medios de transporte
En qué dirección se dirige un vehículo
Al costado de la ruta para recoger o dejar pasajeros
Condiciones del tráfico y rutas cerradas
Inquietudes de seguridad, como evitar áreas peligrosas o proporcionar áreas de retiro seguras
Equilibra la latencia, la calidad y el costo en función de tus necesidades de ruta con funciones opcionales como peajes y metadatos de viajes, como la hora, la distancia y el ahorro de combustible.
También puedes determinar las rutas más eficientes para la programación de despachos, por ejemplo:
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 los paquetes hasta 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 enrutamiento:
Rutas desde una ubicación a uno o varios destinos
Una matriz de rutas posibles entre muchas ubicaciones de partida y destino.
Obtén rutas para uno o varios destinos
Con el método Compute Routes
de la API de Routes, puedes calcular entre ubicaciones:
Obtén instrucciones sobre cómo llegar a diferentes medios de transporte y para uno o varios destinos:
Medios de transporte, incluidos el transporte público, la conducción, los vehículos de dos ruedas y el paseo a pie o en bicicleta
Una serie de puntos de referencia que puedes optimizar para obtener el orden más eficiente de trasladarlos.
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 la orientación del vehículo
Optimiza las opciones de ruta en función de tus necesidades y objetivos:
Selecciona rutas con mayor ahorro de combustible o eficiencia energética para el tipo de motor de tu vehículo: diésel, eléctrico, híbrido o a gas. Para obtener más información, consulta Cómo encontrar una ruta ecológica.
Configura opciones detalladas para el cálculo del tráfico, lo que te permitirá tomar decisiones de compensación entre calidad y latencia. Para obtener más información, consulta Especifica cómo y si quieres incluir datos de tráfico.
Establece la orientación del vehículo (dirección del viaje) y el margen de la ruta para los puntos de referencia a fin de aumentar la precisión de la hora de llegada estimada. Para obtener más información, consulta Cómo especificar la orientación y el lado de la ruta de un vehículo.
Especifica ubicaciones de transferencia en comparación con terminales y ubicaciones seguras para las paradas. Para obtener más información, consulta Cómo configurar una parada en una ruta y Cómo establecer un punto para una ruta que pasará.
Solicita información sobre el peaje, junto con la distancia de la ruta y la hora de llegada estimada. Para obtener más información, consulta Cómo calcular las tarifas de peaje de una ruta.
Controla la latencia y la calidad mediante la solicitud solo de los datos que necesitas mediante una máscara de campo, lo que te ayuda a evitar tiempos de procesamiento innecesarios y tasas de facturación de solicitudes más altas. Para obtener más detalles, consulta Elige qué información se 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 rutas recomendadas entre varios puntos de partida y llegada, lo que incluye la distancia y los tiempos de llegada estimados, para ayudarte a elegir los mejores orígenes y destinos según tus necesidades empresariales. Puedes solicitar estos tipos de datos de distancia:
Distancia de un medio de transporte seleccionado
Distancia en kilómetros o millas
Tiempo de viaje estimado en tráfico
Con los datos de distancia, puedes determinar la forma más eficiente de enrutar a los pasajeros, envíos o trabajadores entre varios orígenes y destinos posibles.
Puedes transmitir elementos de la respuesta antes de que se calcule toda la matriz, lo que disminuye la latencia de la respuesta.
Puedes especificar varios orígenes y destinos por solicitud del servidor con una cantidad de hasta 625 multiplicada por la cantidad de destinos.
Cómo funciona la API de Routes
La API de Routes tiene dos métodos: ComputeRoute
y ComputeRouteMatrix
.
ComputeRoute
El método ComputeRoute
de la API de Routes acepta una solicitud HTTP POST con un cuerpo de solicitud JSON que contiene los detalles de la solicitud. Es obligatorio incluir un origen, un destino, un TravelMode y una máscara de campo para especificar qué campos se deben 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 HTTP POST con un cuerpo de solicitud JSON que contiene los detalles de la solicitud. Se requieren 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 referencia de origen y destino.
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 mostrados | Formato de devolución |
---|---|---|
ComputeRoute | Muestra rutas, tramos y pasos para una ruta, con rutas alternativas si se solicita. | JSON |
ComputeRouteMatrix | Muestra un arreglo de rutas desde un punto de referencia de origen a un punto de referencia de destino. |
Cómo usar la API de Routes
1 | Prepárate | Para comenzar, consulta Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuación. |
2 | Calcula una ruta y revisa la respuesta | Para obtener más información, consulta Cómo obtener una ruta y Revisa las respuestas de la ruta. |
3 | Calcula la matriz de las rutas y revisa la respuesta | Para obtener más información, consulta Cómo obtener una matriz de rutas y Revisa la respuesta de la matriz de ruta. |
Bibliotecas cliente disponibles
Si quieres obtener una lista de las bibliotecas cliente disponibles para la API de Routes, consulta Bibliotecas cliente.