Descripción general de Compute Routes

Introducción

Compute Routes es un método del servicio de la API de Routes que acepta una solicitud HTTPS y devuelve 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 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, que ofrece una amplia gama de detalles de rutas, puedes dirigir tus vehículos o paquetes según tus preferencias 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 para diferentes formas de viajar y para uno o varios destinos:

  • Modos de transporte: transporte público, conducción, vehículos de dos ruedas, camiones, a pie o en bicicleta.

  • Una serie de puntos de referencia que puedes optimizar para determinar el orden más eficiente en el que se deben recorrer.

• 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 la dirección del vehículo

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

  • Personaliza las rutas para camiones y otros vehículos grandes especificando atributos del vehículo, como las dimensiones, el peso y los materiales peligrosos. Para obtener más detalles, consulta Descripción general de la ruta de vehículos grandes.

  • Selecciona rutas con mayor ahorro de combustible o energía según el tipo de motor de tu vehículo: Diésel, Eléctrico, Híbrido, Gasolina. Para obtener más información, consulta Cómo obtener 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 detalles, consulta Especifica cómo y si se deben incluir datos de tráfico.

  • Establece el rumbo del vehículo (dirección de viaje) y la información del lado de la ruta para los puntos de referencia para aumentar la precisión de la hora de llegada estimada. Para obtener más detalles, consulta Especifica la dirección del vehículo y el lado de la ruta.

  • Especifica las ubicaciones de paso, las terminales y las ubicaciones de parada segura. Para obtener más detalles, consulta Cómo establecer una parada en una ruta y Cómo establecer un punto por el que debe pasar una ruta.

  • Solicita información sobre peajes, junto con la distancia de la ruta y la hora estimada de llegada. Para obtener más detalles, consulta Calcula las tarifas de peaje de una ruta.

• 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 detalles, consulta Elige qué información mostrar.

Cómo funciona Compute Routes

El método ComputeRoutes de la API de Routes acepta una solicitud POST de HTTP con un cuerpo de solicitud JSON que contiene los detalles de la solicitud. Se requieren un origen, un destino, un travelMode y una máscara de campo para especificar qué campos se deben devolver.

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

Cómo usar Compute Routes

Bibliotecas cliente disponibles

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

¿Qué sigue?

• Obtén una ruta
• Opciones de ruta disponibles
• Elige qué información se devolverá
• Migra desde la API de Directions (heredada)
• Migra de la versión preliminar de la API de Routes a la versión de DG