Por qué usar la API de Routes
Con la API de Routes, puedes obtener información de viajes y rutas precisas a través de los detalles sobre transporte, las condiciones actualizadas de las rutas y el tráfico, y las preferencias de ruta:
Tipos de diferentes medios de transporte y sus capacidades
La dirección a la que se dirige un vehículo
En el costado de la ruta para recoger o dejar pasajeros
Condiciones de tráfico y rutas cerradas
Inquietudes relacionadas con la seguridad, como evitar áreas peligrosas o proporcionar áreas seguras para que los pasajeros recojan
Equilibra la latencia, la calidad y el costo en todas tus necesidades de planificación de ruta con funciones opcionales, como peajes y metadatos de viajes, como tiempo y distancia, y ahorro de combustible.
También puedes determinar las rutas más eficientes para la programación de despachos, como:
La mejor manera de asignar un conjunto de trabajadores para recoger una serie de paquetes
Determinar el mejor almacén desde el cual 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 enrutamiento:
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 entre ubicaciones:
Obtén instrucciones sobre cómo llegar para diferentes medios de transporte y para uno o varios destinos:
Medios de transporte, incluidos transporte público, conducción, vehículos de dos ruedas, a pie o en bicicleta
Es una serie de puntos de referencia que puedes optimizar para lograr un viaje más eficiente.
Varias maneras 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
Ajusta tus opciones de rutas en función de tus necesidades y objetivos:
Selecciona rutas con mayor ahorro de combustible o energía para el tipo de motor de tu vehículo: diésel, eléctrico, híbrido, de gas. Para obtener más información, consulta Obtén una ruta ecológica.
Establece opciones detalladas para el cálculo del tráfico, lo que te permite tomar decisiones de compensación entre calidad y latencia. Para obtener más información, consulta Especifica cómo y si incluir datos de tráfico.
Establece la orientación del vehículo (dirección del viaje) y la información de los carriles de los puntos de referencia para aumentar la precisión de la hora de llegada estimada. Para obtener más información, consulta Especifica la orientación y el lado de la ruta del vehículo.
Especifica ubicaciones de paso en comparación con las de terminales y ubicaciones seguras para las paradas. Para obtener más detalles, consulta Cómo configurar la parada en una ruta y Cómo configurar un punto por el cual pasar una ruta.
Solicita información sobre los peajes, junto con la distancia de la ruta y la hora de llegada estimada. Para obtener más detalles, consulta Cómo calcular las tarifas de peaje de una ruta.
Controla la latencia y la calidad mediante la solicitud de 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 más altas. Para obtener más detalles, consulta Elige la información que deseas 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, incluidas la distancia y las horas de llegada estimadas, para ayudarte a elegir los mejores orígenes y destinos en función de las necesidades de tu empresa. 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 con 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 la cantidad de orígenes multiplicada 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 HTTP POST con un cuerpo de solicitud JSON que contiene los detalles de la solicitud. Los campos obligatorios son origin, Destination, 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 solicitados.
ComputeRouteMatrix
La API de Routes ComputeRouteMatrix acepta una solicitud HTTP POST con un cuerpo de solicitud JSON que contiene los detalles de la solicitud. Los campos obligatorios son, 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 |
|---|---|---|
| ComputeRoutes | Muestra las rutas, los tramos y los pasos de una ruta, con rutas alternativas, si se solicitan. | JSON |
| ComputeRouteMatrix | Muestra 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 | Preparación | Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que siguen. |
| 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 Obtén una matriz de ruta y Revisa la respuesta de la matriz de ruta. |
Bibliotecas cliente disponibles
Si deseas obtener una lista de las bibliotecas cliente disponibles para la API de Routes, consulta Bibliotecas cliente.