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
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 |
parent |
string
필수 항목입니다. 전화를 걸 프로젝트와 위치를 타겟팅합니다. 형식: * projects/{project-id} * projects/{project-id}/locations/{location-id} 위치를 지정하지 않으면 리전이 자동으로 선택됩니다.
|
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
필드 |
modelConfigs[] |
object (AsyncModelConfig )
필수 항목입니다. 각 구매 모델의 입력/출력 정보(예: 파일 경로, 데이터 형식)
|
응답 본문
성공한 경우 응답 본문에 Operation
의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/cloud-platform
IAM 권한
parent
리소스에 대해서는 다음 IAM 권한이 필요합니다.
routeoptimization.operations.create
자세한 내용은 IAM 문서를 참조하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-12-22(UTC)
[null,null,["최종 업데이트: 2024-12-22(UTC)"],[[["The `batchOptimizeTours` method optimizes vehicle tours for multiple requests as a Long Running Operation (LRO), reading inputs and writing outputs to Cloud Storage."],["Users can monitor the LRO status using `operations.get`, with results becoming available in Cloud Storage upon completion."],["The request body requires `modelConfigs` which specifies file paths and data formats for each model using the `AsyncModelConfig` structure."],["Authorization requires the `https://www.googleapis.com/auth/cloud-platform` OAuth scope and the `routeoptimization.operations.create` IAM permission."],["Successful responses contain an `Operation` instance providing information about the ongoing operation."]]],["This API method `batchOptimizeTours` optimizes vehicle tours for multiple `OptimizeToursRequest` messages via a Long Running Operation (LRO). Inputs and outputs are stored in Cloud Storage. Each request includes a `ShipmentModel`, and returns `ShipmentRoute` fields, minimizing overall cost. Users can check the LRO's status via `operations.get`. The `done` field indicates completion, while the `error` field shows failures. Requires `routeoptimization.operations.create` IAM permission and `cloud-platform` OAuth scope. The parent parameter will be used for routing.\n"]]