Descripción general de Compute Routes

Desarrolladores del Espacio Económico Europeo (EEE)

Introducción

Compute Routes es un método del servicio de la API de Routes que acepta una solicitud HTTPS y muestra la ruta ideal entre dos ubicaciones. Proporciona instrucciones sobre cómo llegar a múltiples ubicaciones en transporte público, bicicleta, automóvil, vehículos motorizados de 2 ruedas o a pie, con información del tráfico en tiempo real.

¿Necesitas matrices de rutas? Si te interesa una matriz de rutas, consulta Descripción general de Compute Route Matrix.

¿Estás migrando? Si migras desde la API de Distance Matrix (heredada), consulta las instrucciones de migración que comienzan con Por qué migrar a la API de Routes.

Por qué usar Compute Routes

Con Compute Routes, con una amplia variedad de detalles de rutas, puedes enrutar tus vehículos o paquetes según tus preferencias y, al mismo tiempo, optimizar el costo y la calidad.

¿Qué puedes hacer con Compute Routes?

Con el método Compute Routes de la API de Routes, puedes hacer lo siguiente:

  • Obtener instrucciones sobre cómo llegar para diferentes formas de viajar y para uno o varios destinos:

    • Modos de transporte: transporte público, automóvil, vehículos de dos ruedas, a pie o en bicicleta

    • Una serie de puntos de referencia que puedes optimizar para obtener el orden más eficiente en el que viajar a ellos

  • Usar 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, de manera opcional, con la orientación del vehículo

  • Ajustar las opciones de ruta según tus necesidades y objetivos:

  • Controlar 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)

Cómo funciona Compute Routes

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. Se requieren un origen, un destino, 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.

Recursos

En la siguiente tabla, se resumen los recursos disponibles a través del método Compute Routes de la API de Routes, junto con los datos que muestra.

Recursos de datos Datos que se muestran Formato de devolución
ComputeRoutes Muestra rutas, tramos y pasos para una ruta, con rutas alternativas, si se solicitan. JSON

Cómo usar Compute Routes

1 Inicia la configuración Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que siguen.
2 Comprende cómo factura la API de Routes Para obtener información, consulta Uso y facturación.
3 Calcula una ruta y revisa la respuesta Para obtener más información, consulta Obtén una ruta y Revisa las respuestas de la ruta.

Bibliotecas cliente disponibles

Para obtener una lista de las bibliotecas cliente disponibles para Compute Routes, consulta Bibliotecas cliente.

¿Qué sigue?