ShipmentModel
가 포함된 OptimizeToursRequest
를 전송하고 ShipmentRoute
가 포함된 OptimizeToursResponse
를 반환합니다. 이는 전체 비용을 최소화하는 차량이 실행할 경로 집합입니다.
ShipmentModel
모델은 주로 실행해야 하는 Shipment
와 Shipment
를 전송하는 데 사용할 수 있는 Vehicle
로 구성됩니다. ShipmentRoute
는 Shipment
를 Vehicle
에 할당합니다. 구체적으로는 일련의 Visit
를 각 차량에 할당합니다. 여기서 Visit
는 VisitRequest
(Shipment
의 픽업 또는 배달)에 해당합니다.
목표는 ShipmentModel
에 정의된 구성요소가 많은 경우 총 비용을 최소화하는 ShipmentRoute
를 Vehicle
에 할당하는 것입니다.
HTTP 요청
POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}:optimizeTours
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. 전화를 걸 대상 프로젝트 또는 위치입니다. 형식: * 위치를 지정하지 않으면 리전이 자동으로 선택됩니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "timeout": string, "model": { object ( |
입력란 | |
---|---|
timeout |
이 제한 시간을 설정하면 서버는 제한 시간이 경과하거나 동기식 요청에 대한 서버 기한에 도달하기 전에(둘 중 더 빠른 시간) 응답을 반환합니다. 비동기식 요청의 경우 서버는 제한 시간이 경과하기 전에 솔루션 (가능한 경우)을 생성합니다. 소수점 아래가 최대 9자리까지이고 ' |
model |
해결할 배송 모델입니다. |
solvingMode |
기본적으로 해결 모드는 |
searchMode |
요청을 해결하는 데 사용되는 검색 모드입니다. |
injectedFirstSolutionRoutes[] |
최적화 알고리즘이 이전 해와 유사한 첫 번째 해를 찾도록 안내합니다. 첫 번째 솔루션을 빌드할 때는 모델이 제한됩니다. 경로에서 배송되지 않은 모든 배송은 첫 번째 해결 방법에서 암묵적으로 건너뛰지만 연속적인 해결 방법으로 수행될 수 있습니다. 이 솔루션은 몇 가지 기본 유효성 가정을 충족해야 합니다.
삽입된 솔루션을 실행할 수 없는 경우, 유효성 검사 오류가 반드시 반환되지는 않으며, 실행 불가능한 것을 나타내는 오류가 대신 반환될 수 있습니다. |
injectedSolutionConstraint |
최적화 알고리즘을 제한하여 이전 해와 유사한 최종 해법을 찾습니다. 예를 들어, 이는 이미 완료되었거나 완료될 예정이지만 수정해서는 안 되는 경로의 일부를 고정하는 데 사용할 수 있습니다. 삽입된 솔루션을 실행할 수 없는 경우, 유효성 검사 오류가 반드시 반환되지는 않으며, 실행 불가능한 것을 나타내는 오류가 대신 반환될 수 있습니다. |
refreshDetailsRoutes[] |
비어 있지 않으면 지정된 경로는 기본 방문 순서 또는 이동 시간의 기본 순서를 수정하지 않고 새로고침되며 다른 세부정보만 업데이트됩니다. 이것으로 모델을 해결할 수는 없습니다. 2020년 11월부터 비어 있지 않은 경로의 다중선만 채워지며 전달된 경로의 이 필드는
|
interpretInjectedSolutionsUsingLabels |
true인 경우:
이 해석은 true인 경우 다음 카테고리의 라벨은 카테고리에 최대 한 번만 표시되어야 합니다.
삽입된 솔루션의 삽입된 솔루션에서 경로 방문 또는 전체 경로를 제거하면 암시적 제약 조건에 영향을 줄 수 있으며, 이로 인해 솔루션 변경, 검증 오류 또는 실행 불가능성이 발생할 수 있습니다. 참고: 호출자는 각 |
considerRoadTraffic |
|
populatePolylines |
true인 경우 응답 |
populateTransitionPolylines |
true인 경우 |
allowLargeDeadlineDespiteInterruptionRisk |
이 속성을 설정하면 요청의 기한 (https://grpc.io/blog/deadlines 참고)을 최대 60분으로 설정할 수 있습니다. 그렇지 않은 경우 최대 기한은 30분입니다. 오래 지속되는 요청은 중단 위험이 훨씬 큽니다 (그러나 여전히 작음). |
useGeodesicDistances |
true인 경우 이동 거리는 Google 지도 거리 대신 최단 거리(최단 거리)를 사용하여 계산되고, 이동 시간은 |
label |
이 요청을 식별하는 데 사용할 수 있는 라벨( |
geodesicMetersPerSecond |
|
maxValidationErrors |
반환된 유효성 검사 오류의 수를 자릅니다. 이러한 오류는 resolveMode=VALIDATE_ONLY가 아닌 이상 BadRequest 오류 세부정보 (https://cloud.google.com/apis/design/errors#error_details)로 INVALID_ARGUMENT 오류 페이로드에 일반적으로 첨부됩니다. |
응답 본문
성공한 경우 응답 본문에 OptimizeToursResponse
의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/cloud-platform