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 entre varias 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 la descripción general de Compute Routes 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, puedes planificar rutas para tus vehículos o paquetes según tus preferencias con un amplio rango de detalles de ruta y, al mismo tiempo, optimizar los costos y la calidad.

¿Qué puedes hacer con Compute Routes?

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

  • Obtén instrucciones sobre cómo llegar a un destino o a varios destinos con diferentes medios de transporte:

    • 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 determinar el orden más eficiente en el que viajar a ellos.

  • Usa 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 el rumbo del vehículo

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

  • Controla 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 funcionan las rutas de procesamiento

El método ComputeRoutes de la API de Routes acepta una solicitud POST HTTP 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 las rutas, los tramos y los pasos de una ruta, con rutas alternativas, si se solicita. JSON

Cómo usar Compute Routes

1 Prepárate Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuación.
2 Comprende cómo factura la API de Routes Para obtener información, consulta Uso y facturación.
3 Cómo calcular una ruta y revisar la respuesta Para obtener más información, consulta Cómo obtener una ruta y Cómo revisar 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?