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 說明文件。