Descripción general de Compute Route Matrix

Desarrolladores del Espacio Económico Europeo (EEE)

Compute Route Matrix es un método del servicio de la API de Routes que acepta una solicitud HTTPS y muestra las distancias y los tiempos de viaje de una matriz de rutas entre diferentes ubicaciones de origen y destino. Calcula las distancias y la duración del viaje de varios destinos para hasta 625 elementos de ruta.

¿Necesitas instrucciones sobre cómo llegar a algún lugar? Si te interesan las instrucciones sobre cómo llegar, consulta la descripción general de las rutas de Compute.

¿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 Matrix

Con Compute Routes Matrix, puedes determinar las rutas más eficientes para la programación de envíos, como las siguientes:

  • La mejor manera de asignar un conjunto de trabajadores para que recojan una serie de paquetes

  • Determinar el mejor almacén desde el que enviar paquetes a su destino final

¿Qué puedes hacer con Compute Route Matrix?

Con Compute Route Matrix, puedes obtener una matriz de rutas posibles entre muchas ubicaciones de inicio y destino. 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. Puedes transmitir elementos de la respuesta antes de que se calcule toda la matriz, lo que reduce la latencia de la respuesta.

Puedes solicitar este tipo de datos de ruta para determinar la forma más eficiente de desviar pasajeros, envíos o trabajadores entre varios orígenes y destinos:

  • Distancia en kilómetros o millas para un medio de transporte seleccionado

  • Tiempo estimado de viaje en el tráfico

Cómo funciona Compute Route Matrix

El método ComputeRouteMatrix acepta una solicitud POST HTTP con un cuerpo de solicitud JSON que contiene los detalles de la solicitud. Se requiere 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 del método Compute Route Matrix de la API de Routes, junto con los datos que muestra.

Recursos de datos Datos que se muestran Formato de devolución
ComputeRouteMatrix Muestra un array de rutas desde un punto de referencia de origen hasta un punto de referencia de destino. JSON

Cómo usar Compute Route Matrix

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 la matriz de rutas y revisar la respuesta Para obtener más información, consulta Obtén una matriz de rutas y Revisa la respuesta de la matriz de rutas.

Bibliotecas cliente disponibles

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

¿Qué sigue?