Method: projects.batchOptimizeTours

以批次形式,為一或多則 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

string

必要欄位。用於發出呼叫的目標專案和位置。

格式:

  • projects/{project-id}
  • projects/{project-id}/locations/{location-id}

如未指定位置,系統會自動選擇區域。

要求主體

要求主體會包含結構如下的資料:

JSON 表示法
{
  "modelConfigs": [
    {
      object (AsyncModelConfig)
    }
  ]
}
欄位
modelConfigs[]

object (AsyncModelConfig)

必要欄位。每個購買模型的輸入/輸出資訊,例如檔案路徑和資料格式。

回應主體

如果成功,回應主體會包含 Operation 的執行例項。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/cloud-platform

IAM 權限

需要 parent 資源的下列 IAM 權限:

  • routeoptimization.operations.create

詳情請參閱 IAM 說明文件