以批次形式,為一或多則 OptimizeToursRequest 訊息最佳化車輛行程。
這個方法是長時間執行的作業 (LRO)。最佳化輸入內容 (OptimizeToursRequest 訊息) 和輸出內容 (OptimizeToursResponse 訊息) 會以使用者指定的格式讀取及寫入 Cloud Storage。與 projects.optimizeTours 方法類似,每個 OptimizeToursRequest 都包含 ShipmentModel,並傳回包含 ShipmentRoute 欄位的 OptimizeToursResponse,這些欄位是一組由車輛執行的路線,可將整體成本降至最低。
使用者可以輪詢 operations.get 來查看 LRO 的狀態:
如果 LRO done 欄位為 false,表示至少有一項要求仍在處理中。其他要求可能已順利完成,結果會儲存在 Cloud Storage 中。
如果 LRO 的 done 欄位為 true,表示所有要求都已處理完畢。成功處理的要求結果會儲存在 Cloud Storage 中。如果要求失敗,Cloud Storage 中就不會有結果。如果 LRO 的 error 欄位已設定,則表示其中一個要求失敗,且該欄位包含相關錯誤。
HTTP 要求
POST https://routeoptimization.googleapis.com/v1/{parent=projects/*}:batchOptimizeTours
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 | |
|---|---|
parent |
必要欄位。用於發出呼叫的目標專案和位置。 格式:
如未指定位置,系統會自動選擇區域。 |
要求主體
要求主體會包含結構如下的資料:
| JSON 表示法 |
|---|
{
"modelConfigs": [
{
object ( |
| 欄位 | |
|---|---|
modelConfigs[] |
必要欄位。每個購買模型的輸入/輸出資訊,例如檔案路徑和資料格式。 |
回應主體
如果成功,回應主體會包含 Operation 的執行例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/cloud-platform
IAM 權限
需要 parent 資源的下列 IAM 權限:
routeoptimization.operations.create
詳情請參閱 IAM 說明文件。