경로 최적화 개요에서 간략히 설명한 대로 기본 요청은 필수 항목인 모델, 배송, 차량으로 구성됩니다.
- 모델은
Shipments및Vehicles를 모두 포함하여 전체 요청의 설정 및 제약 조건을 캡처합니다. - 배송은 수령 및 배송
VisitRequest가 포함된 작업 또는 실제 배송을 나타냅니다. 배송에는 로컬 설정 및 제약조건이 있습니다. - 차량은 차량, 운전자 또는 인력을 나타냅니다. 차량에는 로컬 설정 및 제약 조건도 있습니다.
각 항목의 속성은 특정 수준의 세부사항에서 최적화 문제의 일부를 설명합니다. 모델 전반의 제약조건은 모든 배송 및 차량에 적용되지만 배송 또는 차량에 지정된 제약조건 및 속성은 단일 배송 또는 차량에만 적용됩니다.
각 메시지 유형에 관한 전체 문서는 ShipmentModel (REST, gRPC), Shipment (REST, gRPC), Vehicle (REST, gRPC) 메시지에 관한 참조 문서를 참고하세요.
숙박 시설 OptimizeToursRequest개
최상위 OptimizeToursRequest 메시지(REST, gRPC)에서 일반적으로 사용되는 몇 가지 속성은 다음과 같습니다.
searchMode는 지정된 제약 조건을 충족하는 첫 번째 솔루션을 반환할지 아니면 설정된 기한 내에 최선의 솔루션을 찾을지 나타냅니다.considerRoadTraffic는 경로 설정 및 도착 예상 시간 추정에 실시간 트래픽을 사용할지 여부를 결정합니다.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는 모두 위의 예와 같이 요청 메시지를 사용하지만 방식은 다릅니다. 경로 최적화 요청을 하기 전에 다음 두 가지 방법의 차이를 이해하는 것이 중요합니다.