Descripción general de Compute Route Matrix

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

¿Necesitas rutas en auto? Si te interesan las instrucciones de ruta, consulta la Descripción general de Compute Routes.

¿Vas a migrar? Si migras desde la API de Distance Matrix (heredada), consulta las instrucciones de migración a partir de Por qué migrar a la API de Routes.

Por qué usar Compute Route Matrix

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

• Cómo asignar de la mejor manera un conjunto de trabajadores para que recojan una serie de paquetes

• Determinar el mejor almacén desde el cual enviar los 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 finalización. Puedes especificar varios orígenes y destinos por solicitud del servidor, con una cantidad de orígenes multiplicada por la cantidad de destinos de 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 estos tipos de datos de rutas para determinar la forma más eficiente de dirigir pasajeros, envíos o trabajadores entre varios orígenes y destinos:

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

• Tiempo de viaje estimado en condiciones de tráfico

Cómo funciona Compute Route Matrix

El método ComputeRouteMatrix acepta una solicitud HTTP POST con un cuerpo de solicitud JSON que contiene los detalles de la solicitud. Se requieren al menos un origen, dos o más destinos, travelMode y una máscara de campo para especificar qué campos se devolverán.

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

Cómo usar Compute Route Matrix

Bibliotecas cliente disponibles

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

¿Qué sigue?

• Obtén una matriz de rutas
• Opciones disponibles de la matriz de rutas
• Elige qué información devolver
• Migra desde la API de Distance Matrix (legacy)
• Migra de la versión preliminar de la API de Routes a la DG