Descripción general de la API de Routes

La API de Routes es un servicio que acepta una solicitud HTTPS y muestra la ruta ideal entre dos ubicaciones o las distancias y los tiempos de viaje para una matriz de rutas entre diferentes ubicaciones de origen y destino.

Por qué usar la API de Routes

Con la API de Routes, puedes obtener información precisa sobre las rutas y los viajes con los detalles del transporte, las condiciones actualizadas del tráfico y las rutas, y las preferencias de ruta:

  • Tipo y capacidad de los diferentes medios de transporte

  • La dirección en la que se dirige un vehículo

  • Lado 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 todas tus rutas con funciones opcionales como los peajes y los metadatos de viajes, como el tiempo, la distancia y el ahorro 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 depósito desde el cual enviar los 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.

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: transporte público, conducción, vehículos de dos ruedas, a pie o en bicicleta

    • Una serie de puntos de referencia que puedes optimizar para lograr el orden más eficiente de trasladarlos.

  • Varias formas de especificar orígenes, destinos y puntos de referencia:

    • Son 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 las opciones de ruta en función de tus necesidades y objetivos:

  • 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 tarifas de facturación de solicitudes más altas. Para obtener más detalles, 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 de rutas recomendadas entre varios puntos de partida y destino, incluidas la distancia y los tiempos de llegada estimados, para ayudarte a elegir los mejores orígenes y destinos según 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 haya calculado 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 son obligatorios para el origen, el destino, el TravelMode y una máscara de campo para especificar los campos que 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 que se muestran Formato de devolución
ComputeRoutes Muestra las rutas, los tramos y los pasos de una ruta, con rutas alternativas si así se solicita. 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 Prepárate Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que aparecen 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.

Próximos pasos