同步和异步端点

Route Optimization API 公开了两种方法：

• OptimizeTours 是一种同步方法，用于返回针对 OptimizeToursRequest 的优化路线。客户端必须保持与路线优化 API 的连接处于打开状态，直到请求得到处理并返回 OptimizeToursResponse 或错误为止。
• BatchOptimizeTours 是一种异步方法，可接受一个或多个 OptimizeToursRequest 的 URI 以及相应的 OptimizeToursResponse 消息，并返回用于检查批处理完成情况的长时间运行的操作 (LRO) 的资源名称（REST、gRPC）。OptimizeToursRequest 在后台处理，因此客户端只需保持与路线优化 API 的连接足够长的时间，以提交 BatchOptimizeToursRequest 或调用 GetOperation 来检查 LRO 状态。BatchOptimizeTours 从 Google Cloud Storage 读取请求并将响应写入其中。

使用场景

OptimizeTours 非常适合解决小型简单请求，或解决时间不超过几分钟的请求。与路线优化 API 保持长期有效的连接会增加在返回解决方案之前中断的风险。

BatchOptimizeTours 可以处理更大的请求和求解时间更长的请求，因为它不需要与路线优化 API 建立长期连接。

长时间运行的操作

使用 GetOperation 方法从 Route Optimization API 读取 LRO，以检查批次的完成状态。LRO 包含一个 done 属性，用于指示整个批次的处理是否已完成；还包含一个 error 字段，用于报告处理期间遇到的错误。如果 done 为 true 且不存在 error，则表示批处理已成功完成。如果存在 error，则表示部分或全部批次处理失败。

BatchOptimizeTours 请求的典型生命周期如下：

1. 向 Route Optimization API 提交 BatchOptimizeToursRequest，该 API 会返回 LRO 的资源名称。
2. 使用返回的 LRO 资源名称轮询 GetOperation，直到 LRO 响应中出现 done 或 error 属性。
3. 如果 done 为 true 且不存在任何错误，则从 BatchOptimizeTours 请求中指定的 Google Cloud Storage URI 读取 OptimizeToursResponses。如果存在 error，请检查错误，在 Google Cloud Storage 中相应地更新 OptimizeToursRequest，然后根据观察到的错误重试。

您可以通过多种方式发送 OptimizeTours 和 BatchOptimizeTours 请求，既可以从命令行发送，也可以使用客户端库发送。

下一步：发出 API 请求