경로 최적화 개요에 간단히 설명한 것처럼 기본 요청은 Model, Shipment, Vehicles로 필수 항목으로 구성됩니다.
- 모델은
Shipments
및Vehicles
를 모두 포함하여 전체 요청의 설정과 제약조건을 캡처합니다. - 배송은 수령 및 배송
VisitRequest
가 포함된 작업 또는 실제 배송을 나타냅니다. 배송에는 현지 설정과 제한사항이 있습니다. - 차량은 차량, 운전자 또는 직원을 나타냅니다. 차량에는 로컬 설정과 제약 조건도 있습니다.
각 항목의 속성은 특정 세부 수준에서 최적화 문제의 일부를 설명합니다. 모델 전체 제약 조건은 모든 배송과 차량에 적용되지만, 배송 또는 차량에 지정된 제약 조건 및 속성은 단일 배송 또는 차량에만 적용됩니다.
각 메시지 유형에 대한 전체 문서는 ShipmentModel
(REST, gRPC), Shipment
(REST, gRPC), Vehicle
(REST, gRPC) 메시지의 참조 문서를 확인하세요.
숙박 시설 OptimizeToursRequest
개
최상위 OptimizeToursRequest
메시지(REST, gRPC)의 일반적으로 사용되는 속성은 다음과 같습니다.
searchMode
는 지정된 제약 조건을 충족하는 첫 번째 솔루션을 반환할지 또는 정해진 기한 내에 최적의 솔루션을 찾을지 여부를 나타냅니다.considerRoadTraffic
은 실시간 트래픽을 라우팅 및 ETA 추정에 사용할지 결정합니다.populateTransitionPolylines
은 응답에서 경로 다중선을 반환할지 여부를 결정합니다.
모델 속성
일반적으로 사용되는 ShipmentModel
메시지 (REST, gRPC)의 속성은 다음과 같습니다.
globalStartTime
은 모든 차량과 배송에서 경로의 가장 이른 시작 시간을 나타냅니다. 이 시간 전에 차량은 첫 번째 전환 및 배송을 시작할 수 없습니다.globalEndTime
은 모든 차량과 배송의 경로의 가장 늦은 종료 시간을 나타냅니다. 할당된 모든 배송 및 전환은 이 시간 전에 완료되어야 합니다.
배송 속성
일반적으로 사용되는 Shipment
메시지 (REST, gRPC)의 속성은 다음과 같습니다.
pickups[]
및deliveries[]
는 배송 상품을 수령하거나 반납할 수 있는 위치를 나타냅니다.pickups[]
및deliveries[]
속성은 모두VisitRequest
메시지 (REST, gRPC)를 사용합니다.loadDemands
는 차량이 배송을 완료하는 데 필요한 부하를 나타냅니다. 차량의 해당load_limits
(REST, gRPC) 속성은 차량이 한 번에 수용할 수 있는 부하를 나타냅니다. 부하 수요 및 한도에서 부하에 대해 자세히 알아보세요.penalty_cost
: 배송을 건너뛸 경우 발생하는 비용을 나타냅니다. 비용에 대한 자세한 내용은 비용 모델 매개변수를 참조하세요.
차량 속성
일반적으로 사용되는 Vehicle
메시지 (REST, gRPC)의 속성은 다음과 같습니다.
startLocation
는 차량이 경로를 시작해야 하는 위치를 나타냅니다. 이 속성은 선택사항입니다. 지정하지 않으면 차량의 경로는 처음 할당된 배송의 위치에서 시작됩니다.endLocation
는 차량이 경로를 종료해야 하는 위치를 나타냅니다. 이 속성은 선택사항입니다. 지정하지 않으면 차량 경로가 마지막으로 할당된 배송 위치에서 종료됩니다.startTimeWindows[]
는 차량이 경로를 시작할 수 있는 시점을 나타냅니다. 이 속성은 선택사항입니다.endTimeWindows[]
는 차량이 경로를 시작하고 종료할 수 있는 시점을 나타냅니다. 두 속성 모두 선택사항입니다.loadLimits
는 화물의 적재 수요를 충족하는 데 사용할 수 있는 차량의 용량을 나타냅니다. 부하 수요 및 한도에서 부하 요구 및 한도에 대해 자세히 알아보세요.
JSON 형식의 전체 요청 예는 다음과 같습니다.
{
"model": {
"shipments": [
{
"pickups": [
{
"arrivalLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
}
}
],
"deliveries": [
{
"arrivalLocation": {
"latitude": 37.79581,
"longitude": -122.4218856
}
}
]
}
],
"vehicles": [
{
"startLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
},
"endLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
},
"costPerKilometer": 1.0
}
],
"globalStartTime": "2024-02-13T00:00:00.000Z",
"globalEndTime": "2024-02-14T06:00:00.000Z"
}
}
OptimizeTours
와 BatchOptimizeTours
는 모두 위의 예시와 같이 요청 메시지를 소비하지만 다른 방식으로 사용됩니다. 경로 최적화를 요청하기 전에 다음 두 가지 방법의 차이점을 이해하는 것이 중요합니다.