이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Method: projects.locations.optimizeToursLongRunning

HTTP 요청
경로 매개변수
요청 본문
- JSON 표현
응답 본문
승인 범위
IAM 권한

이는 큰 시간 제한 값으로 최적화하도록 설계된 locations.optimizeTours 메서드의 변형입니다. 몇 분 이상 걸리는 최적화에는 locations.optimizeTours 메서드보다 이 메서드를 사용하는 것이 좋습니다.

반환된 long-running operation (LRO)의 이름은 <parent>/operations/<operation_id> 형식이며, 이를 사용하여 계산 진행 상황을 추적할 수 있습니다. metadata 필드 유형은 OptimizeToursLongRunningMetadata입니다. 성공하면 response 필드 유형은 OptimizeToursResponse입니다.

실험 단계: 자세한 내용은 https://developers.google.com/maps/tt/route-optimization/experimental/otlr/make-request를 참고하세요.

HTTP 요청

POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}:optimizeToursLongRunning

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수

매개변수
`parent`	`string` 필수 항목입니다. 전화를 걸 프로젝트 또는 위치를 타겟팅합니다. 형식: `projects/{project-id}` `projects/{project-id}/locations/{location-id}` 위치를 지정하지 않으면 리전이 자동으로 선택됩니다.

parent

string

필수 항목입니다. 전화를 걸 프로젝트 또는 위치를 타겟팅합니다.

형식:

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

위치를 지정하지 않으면 리전이 자동으로 선택됩니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현

JSON 표현
{ "timeout": string, "model": { object (`ShipmentModel`) }, "solvingMode": enum (`SolvingMode`), "searchMode": enum (`SearchMode`), "injectedFirstSolutionRoutes": [ { object (`ShipmentRoute`) } ], "injectedSolutionConstraint": { object (`InjectedSolutionConstraint`) }, "refreshDetailsRoutes": [ { object (`ShipmentRoute`) } ], "interpretInjectedSolutionsUsingLabels": boolean, "considerRoadTraffic": boolean, "populatePolylines": boolean, "populateTransitionPolylines": boolean, "allowLargeDeadlineDespiteInterruptionRisk": boolean, "useGeodesicDistances": boolean, "label": string, "geodesicMetersPerSecond": number, "maxValidationErrors": integer }

{
  "timeout": string,
  "model": {
    object (ShipmentModel)
  },
  "solvingMode": enum (SolvingMode),
  "searchMode": enum (SearchMode),
  "injectedFirstSolutionRoutes": [
    {
      object (ShipmentRoute)
    }
  ],
  "injectedSolutionConstraint": {
    object (InjectedSolutionConstraint)
  },
  "refreshDetailsRoutes": [
    {
      object (ShipmentRoute)
    }
  ],
  "interpretInjectedSolutionsUsingLabels": boolean,
  "considerRoadTraffic": boolean,
  "populatePolylines": boolean,
  "populateTransitionPolylines": boolean,
  "allowLargeDeadlineDespiteInterruptionRisk": boolean,
  "useGeodesicDistances": boolean,
  "label": string,
  "geodesicMetersPerSecond": number,
  "maxValidationErrors": integer
}

필드
`timeout`	`string (Duration format)` 이 제한 시간이 설정되면 제한 시간이 경과하거나 동기 요청의 서버 기한에 도달하기 전에 서버에서 응답을 반환합니다(둘 중 더 빠른 시점). 비동기 요청의 경우 서버는 제한 시간이 경과하기 전에 솔루션을 생성합니다 (가능한 경우). 소수점 아래가 최대 9자리까지이고 '`s`'로 끝나는 초 단위 기간입니다. 예를 들면 `"3.5s"`입니다.
`model`	`object (ShipmentModel)` 해결할 배송 모델입니다.
`solvingMode`	`enum (SolvingMode)` 기본적으로 해결 모드는 `DEFAULT_SOLVE` (0)입니다.
`searchMode`	`enum (SearchMode)` 요청을 해결하는 데 사용된 검색 모드입니다.
`injectedFirstSolutionRoutes[]`	`object (ShipmentRoute)` 최적화 알고리즘이 이전 솔루션과 유사한 첫 번째 솔루션을 찾도록 안내합니다. 첫 번째 솔루션을 빌드할 때 모델이 제한됩니다. 경로에서 수행되지 않은 배송은 첫 번째 솔루션에서 암시적으로 건너뛰지만 후속 솔루션에서는 수행될 수 있습니다. 솔루션은 몇 가지 기본적인 유효성 가정을 충족해야 합니다. 모든 경로에서 `vehicleIndex`이 범위 내에 있어야 하며 중복되지 않아야 합니다. 모든 방문에서 `shipmentIndex` 및 `visitRequestIndex`이 범위 내에 있어야 합니다. 배송은 하나의 경로에서만 참조할 수 있습니다. 수령-배송 상품의 수령은 배송 전에 이루어져야 합니다. 하나 이상의 수령 대안 또는 배송 대안을 수행할 수 있습니다. 모든 경로에서 시간이 증가하고 있습니다 (즉, `vehicleStartTime <= visits[0].start_time <= visits[1].start_time ... <= vehicleEndTime`) 배송은 허용된 차량에서만 수행할 수 있습니다. `Shipment.allowed_vehicle_indices`이 비어 있거나 `vehicleIndex`이 `Shipment.allowed_vehicle_indices`에 포함된 경우 차량이 허용됩니다. 삽입된 솔루션이 불가능한 경우 유효성 검사 오류가 반환되지 않을 수 있으며 불가능함을 나타내는 오류가 대신 반환될 수 있습니다.
`injectedSolutionConstraint`	`object (InjectedSolutionConstraint)` 최적화 알고리즘이 이전 솔루션과 유사한 최종 솔루션을 찾도록 제한합니다. 예를 들어 이미 완료되었거나 완료될 예정이지만 수정해서는 안 되는 경로의 일부를 고정하는 데 사용할 수 있습니다. 삽입된 솔루션이 불가능한 경우 유효성 검사 오류가 반환되지 않을 수 있으며 불가능함을 나타내는 오류가 대신 반환될 수 있습니다.
`refreshDetailsRoutes[]`	`object (ShipmentRoute)` 비어 있지 않으면 지정된 경로가 새로고침되며, 방문 또는 이동 시간의 기본 순서는 수정되지 않습니다. 다른 세부정보만 업데이트됩니다. 이렇게 해도 모델이 해결되지는 않습니다. 2020년 11월부터는 비어 있지 않은 경로의 폴리라인만 채우며 `populatePolylines`이 true여야 합니다. 전달된 경로의 `routePolyline` 필드가 경로 `transitions`와 일치하지 않을 수 있습니다. 이 필드는 `injectedFirstSolutionRoutes` 또는 `injectedSolutionConstraint`와 함께 사용할 수 없습니다. `Shipment.ignore` 및 `Vehicle.ignore`는 동작에 영향을 미치지 않습니다. 관련 배송 또는 차량이 무시되는지 여부와 관계없이 비어 있지 않은 모든 경로의 모든 방문 사이에 폴리라인이 계속 채워집니다.
`interpretInjectedSolutionsUsingLabels`	`boolean` 참인 경우: `vehicleIndex` 대신 `ShipmentRoute.vehicle_label`를 사용하여 삽입된 솔루션의 경로를 요청의 차량과 일치시킵니다. 원래 `ShipmentRoute.vehicle_index`의 매핑을 새 `ShipmentRoute.vehicle_index`에 재사용하여 비어 있지 않은 경우 `ConstraintRelaxation.vehicle_indices`를 업데이트하지만 매핑은 명확해야 합니다 (즉, 여러 `ShipmentRoute`가 동일한 원래 `vehicleIndex`를 공유해서는 안 됨). 삽입된 솔루션의 방문을 요청의 배송과 일치시키기 위해 `shipmentIndex` 대신 `ShipmentRoute.Visit.shipment_label`을 사용합니다. 삽입된 솔루션의 건너뛴 배송을 요청 배송과 일치시키기 위해 `SkippedShipment.index` 대신 `SkippedShipment.label`을 사용합니다. 이 해석은 `injectedFirstSolutionRoutes`, `injectedSolutionConstraint`, `refreshDetailsRoutes` 필드에 적용됩니다. 요청의 배송 또는 차량 색인이 솔루션이 생성된 이후 변경된 경우에 사용할 수 있습니다. 예를 들어 배송 또는 차량이 요청에서 삭제되거나 요청에 추가된 경우입니다. true인 경우 다음 카테고리의 라벨이 카테고리에 최대 한 번 표시되어야 합니다. 요청의 `Vehicle.label` 요청의 `Shipment.label` 삽입된 솔루션의 `ShipmentRoute.vehicle_label` `SkippedShipment.label` 및 `ShipmentRoute.Visit.shipment_label`가 삽입된 솔루션에 표시됩니다 (`shipmentLabel`가 두 번 표시되어야 하는 수령/배송 방문 쌍 제외). 삽입된 솔루션의 `vehicleLabel`이 요청 차량에 해당하지 않으면 해당 경로가 방문과 함께 솔루션에서 삭제됩니다. 삽입된 솔루션의 `shipmentLabel`이 요청된 배송과 일치하지 않으면 해당 방문이 솔루션에서 삭제됩니다. 삽입된 솔루션의 `SkippedShipment.label`이 요청된 배송과 일치하지 않으면 `SkippedShipment`이 솔루션에서 삭제됩니다. 삽입된 솔루션에서 경로 방문 또는 전체 경로를 삭제하면 암시된 제약 조건에 영향을 미쳐 솔루션 변경, 유효성 검사 오류 또는 불가능성이 발생할 수 있습니다. 참고: 호출자는 각 `Vehicle.label` (또는 `Shipment.label`)은 삽입된 솔루션에 사용된 `OptimizeToursResponse`을 생성한 이전 요청과 삽입된 솔루션을 포함하는 현재 요청이라는 두 관련 요청에서 사용되는 차량 (또는 배송) 엔티티를 고유하게 식별합니다. 위에서 설명한 고유성 검사만으로는 이 요구사항을 보장할 수 없습니다.
`considerRoadTraffic`	`boolean` `ShipmentRoute` 필드 `Transition.travel_duration`, `Visit.start_time`, `vehicleEndTime`을 계산하고, `ShipmentRoute.has_traffic_infeasibilities` 필드를 설정하고, `OptimizeToursResponse.total_cost` 필드를 계산할 때 트래픽 추정치를 고려합니다.
`populatePolylines`	`boolean` true인 경우 폴리라인이 응답 `ShipmentRoute`에 채워집니다.
`populateTransitionPolylines`	`boolean` true인 경우 폴리라인과 경로 토큰이 응답 `ShipmentRoute.transitions`에 채워집니다.
`allowLargeDeadlineDespiteInterruptionRisk`	`boolean` 이 값이 설정되면 요청의 기한 (https://grpc.io/blog/deadlines 참고)이 최대 60분까지 될 수 있습니다. 그렇지 않으면 최대 기한은 30분입니다. 장기 실행 요청은 중단될 위험이 훨씬 더 크지만 여전히 작습니다.
`useGeodesicDistances`	`boolean` true인 경우 이동 거리는 Google 지도 거리 대신 측지선 거리를 사용하여 계산되고 이동 시간은 `geodesicMetersPerSecond`에 정의된 속도로 측지선 거리를 사용하여 계산됩니다.
`label`	`string` 이 요청을 식별하는 데 사용할 수 있는 라벨로, `OptimizeToursResponse.request_label`에 다시 보고됩니다.
`geodesicMetersPerSecond`	`number` `useGeodesicDistances`가 true인 경우 이 필드를 설정해야 하며 이동 시간 계산에 적용되는 속도를 정의합니다. 값은 1.0미터/초 이상이어야 합니다.
`maxValidationErrors`	`integer` 반환된 유효성 검사 오류 수를 자릅니다. 이러한 오류는 일반적으로 BadRequest 오류 세부정보(https://cloud.google.com/apis/design/errors#error_details)로 INVALID_ARGUMENT 오류 페이로드에 연결됩니다(solvingMode=VALIDATE_ONLY인 경우는 제외). `OptimizeToursResponse.validation_errors` 필드를 참고하세요. 기본값은 100이며 최대값은 10,000입니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

routeoptimization.operations.create

자세한 내용은 IAM 문서를 참조하세요.

Method: projects.locations.optimizeToursLongRunning 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.