Descripción general de la API de Routes

La API de Routes es un servicio que acepta solicitudes HTTPS y devuelve la ruta ideal entre dos ubicaciones o las distancias y los recorridos horarios 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 de viajes y rutas precisas usando los detalles de transporte, el estado actualizado del tráfico y las rutas, y preferencias:

  • 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 permitir que los pasajeros realicen un recorrido seguro áreas

  • Equilibra la latencia, la calidad y el costo en todas tus necesidades de enrutamiento con elementos como peajes y metadatos de viajes, como tiempo y distancia, y eficiencia

También puedes determinar las rutas más eficientes para la programación de despachos, como como:

  • La mejor manera de asignar un conjunto de trabajadores para recoger 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 enrutamiento información:

  • 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, que puedes calcular entre ubicaciones:

  • Obtén instrucciones sobre cómo llegar para diferentes medios de transporte y para una o varias destinos:

    • medios de transporte, incluidos el transporte público, la conducción y los vehículos de dos ruedas caminar o andar en bicicleta.

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

  • 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:

  • Controla la latencia y la calidad mediante la solicitud de solo los datos que necesitas una máscara de campo, lo que ayuda a evitar tiempos de procesamiento innecesarios y mayores solicitar tarifas de facturación. Para obtener más información, 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 inicio y finalización puntos, incluidas la distancia y las horas de llegada estimadas, para ayudarte a elegir la los mejores orígenes y destinos según tu para abordar necesidades comerciales complejas. 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 enrutar pasajeros, envíos o trabajadores entre varios orígenes posibles y destinos.

Puedes transmitir elementos de la respuesta antes de que se haya procesado toda la matriz y, así, reducir la latencia de 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 contenga los detalles de la solicitud Los campos obligatorios son un origen, 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 te muestra los campos solicitado.

ComputeRouteMatrix

La API de Routes ComputeRouteMatrix acepta una solicitud HTTP POST con Un cuerpo de solicitud JSON que contenga los detalles de la solicitud Debes ingresar al menos uno origin, dos o más destinos, journeyMode y una máscara de campo para especificar para mostrar los resultados.

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 posibles rutas para la combinación de todos los orígenes como puntos de referencia de destino y destino.

Recursos

En la siguiente tabla, se resumen los recursos disponibles mediante las 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 solicita. JSON
ComputeRouteMatrix Devuelve un array de rutas desde un punto de referencia de origen hacia un destino. de referencia.

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 rutas. 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.

¿Qué sigue?