单个非阻塞优化 API 方法

本指南介绍了 OptimizeToursLongRunning 和 OptimizeToursUri API 方法的实验性发布，用户可以使用这些方法发出单个非阻塞优化请求。在非阻塞优化中，用户会从方法中快速收到一个 Operation proto，该 proto 可用于通过调用 GetOperation 来引用优化状态。如需了解详情，请参阅长时间运行的操作。

与阻塞方法 OptimizeTours 相比，这些非阻塞方法具有可靠性优势，因为在执行优化时，客户端无需保持与服务器的连接。此外，与 BatchOptimizeTours 相比，这些新方法可更轻松地调试故障，因为每项优化都与单个长时间运行的操作 (LRO) 相关联。

如果用户希望以内嵌方式发送优化请求，可以使用 OptimizeToursLongRunning 方法；如果用户希望使用 Google Cloud Storage 上传请求和读取响应，可以使用 OptimizeToursUri 方法。

OptimizeToursLongRunning

示例：发出 OptimizeToursLongRunning 请求

在发出请求之前，请将以下参数替换为适合您环境的值：

  • 确保您已按照使用 OAuth 中的说明配置应用默认凭据。

  • 将 PROJECT_NUMBER_OR_ID 设置为您的 Cloud 项目编号或 ID。

    以下命令会向 Route Optimization API 发送 OptimizeToursLongRunning 请求，并接收与其关联的操作 ID。GetOperation 方法可用于查询操作的状态。操作完成后，元数据还会包含最终的 OptimizeToursResponse。

    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

与 BatchOptimizeTours 类似，您可以使用 OptimizeToursUri 继续将优化请求和响应存储在 Google Cloud Storage 中。Cloud Storage URI 必须在 OptimizeToursUri 请求消息中指定。返回的 Operation 状态仅与单个提交的 OptimizeToursRequest 相关联。

示例：发出 OptimizeToursUri 请求

在发出请求之前，请将以下参数替换为适合您环境的值：

  • 确保您已按照使用 OAuth 中的说明配置应用默认凭据。

  • 将 PROJECT_NUMBER_OR_ID 设置为您的 Cloud 项目编号或 ID。

    以下命令会向 Route Optimization API 发送 OptimizeToursUri 请求，并接收与其关联的操作 ID。使用 GetOperation 方法查询操作的状态。操作完成后，OptimizeToursResponse 会远程存储在请求中提供的输出 URI 路径中。

    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