Métodos de la API de Optimization sin bloqueo

En esta guía, se presenta el lanzamiento experimental de los métodos de API OptimizeToursLongRunning y OptimizeToursUri que permiten a los usuarios realizar solicitudes de optimización únicas y no bloqueantes. En una optimización sin bloqueo, el usuario recibe rápidamente un proto de Operation del método que se puede usar para hacer referencia al estado de la optimización llamando a GetOperation. Consulta Operaciones de larga duración para obtener más detalles.

Estos métodos no bloqueantes proporcionan beneficios de confiabilidad sobre el método bloqueante OptimizeTours, ya que el cliente no necesita mantener la conexión con el servidor mientras se ejecuta la optimización. Además, estos nuevos métodos facilitan la depuración de errores en comparación con BatchOptimizeTours, ya que cada optimización se asocia con una sola operación de larga duración (LRO).

Los usuarios que prefieran insertar la solicitud de optimización pueden usar el método OptimizeToursLongRunning, mientras que los que prefieran subir las solicitudes y leer la respuesta con Google Cloud Storage pueden usar el método OptimizeToursUri.

OptimizeToursLongRunning

Ejemplo: Realiza una solicitud OptimizeToursLongRunning

Antes de realizar una solicitud, reemplaza los siguientes parámetros por valores adecuados para tu entorno:

• Asegúrate de tener configuradas las credenciales predeterminadas de la aplicación como se describe en Usa OAuth.

• Establece PROJECT_NUMBER_OR_ID en el ID o número de tu proyecto de Cloud.

  El siguiente comando envía una solicitud OptimizeToursLongRunning a la API de Route Optimization y recibe un ID de operación asociado a ella. El método GetOperation se puede usar para consultar el estado de la operación. Una vez que se completa la operación, los metadatos también contienen el OptimizeToursResponse final.

  curl -X POST 'https://routeoptimization.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID:optimizeToursLongRunning' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  --data @- <<EOM
  {
    "model": {
      "shipments": [
        {
          "pickups": [
            {
              "arrivalLocation": {
                "latitude": 37.42506261000996,
                "longitude": -122.09535511930135
              }
            }
          ],
          "deliveries": [
            {
              "arrivalLocation": {
                "latitude": 37.42421503206021,
                "longitude": -122.09526063135228
              }
            }
          ]
        }
      ],
      "vehicles": [
        {
          "travelMode": "DRIVING",
          "costPerKilometer": 1.0
        }
      ],
    }
  }
  EOM

OptimizeToursUri

Al igual que BatchOptimizeTours, puedes usar OptimizeToursUri para seguir almacenando tu solicitud y respuesta de optimización en Google Cloud Storage. Los URIs de Cloud Storage se deben especificar en el mensaje de solicitud OptimizeToursUri. El estado Operation que se devuelve solo está asociado con el único OptimizeToursRequest enviado.

Ejemplo: Realiza una solicitud OptimizeToursUri

Antes de realizar una solicitud, reemplaza los siguientes parámetros por valores adecuados para tu entorno:

• Asegúrate de tener configuradas las credenciales predeterminadas de la aplicación como se describe en Usa OAuth.

• Establece PROJECT_NUMBER_OR_ID en el ID o número de tu proyecto de Cloud.

  El siguiente comando envía una solicitud OptimizeToursUri a la API de Route Optimization y recibe un ID de operación asociado a ella. Usa el método GetOperation para consultar el estado de la operación. Una vez que se completa la operación, el OptimizeToursResponse se almacena de forma remota en la ruta de URI de salida proporcionada en la solicitud.

  curl -X POST 'https://routeoptimization.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID:optimizeToursUri' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  --data @- <<EOM
  {
    "input": {
      "uri": "gs://bucket/path/input/object.json"
    },
    "output": {
      "uri": "gs://bucket/path/output/object.json"
    }
  }
  EOM