Route Optimization API는 해당하는 위치의 차량에 대한 경로를 반환합니다. 요청을 수행합니다. 배송은 차량에 할당되거나 지정할 수 있습니다.
OptimizeToursResponse 메시지 (REST, gRPC)에는
속성:
routes[]은(는) 할당된 배송이 있는 각 차량의 경로입니다. 각Route에는 개별 경로의 속성을 반영하는 측정항목이 포함됩니다.metrics은(는) 모든 연령대의 전체 응답에 대해 집계된 측정항목입니다 차량 및 경로 계획도에 포함됩니다. 최상위 측정항목에는 모든 경로에서 집계된 값이 포함된 경로별 측정항목
최적화 결과에 따라 일부 속성이 채워지지 않을 수도 있습니다.
skippedShipments[]에는 차량으로 진행되지 않는 배송이 나열됩니다. 지정된 기간 내에 배송할 수 없는 경우 배송을 건너뛸 수 있습니다. 배송 비용이 벌금 비용을 초과하는 경우입니다. 예를 들어 배송의 수령 또는 배송 기간이timeWindow차량이 필요한 기간에 방문을 수행할 수 있습니다validationErrors[]는 요청을 무효화하는 오류를 지정합니다. 요청의solvingMode가VALIDATE_ONLY일반DEFAULT_SOLVE모드에서는 유효성 검사 오류가 발생합니다. 응답 본문 대신 오류 메시지에 표시됩니다. 참고:VALIDATE_ONLY해결 모드는 여러 오류를 한 번에 보고할 수 있습니다. 요청을 빠르게 디버깅하는 데 유용합니다.
경로 속성
각 routes[] 항목은 ShipmentRoute 메시지 (REST, gRPC)입니다. 각
ShipmentRoute은 출발한 특정 차량의 경로 할당을 나타냅니다.
요청을 처리합니다 해당 속성과 관련된 중요한 ShipmentRoute 속성
Vehicle 포함:
vehicleIndex는 상응하는Vehicle요청 메시지를 전송합니다. REST 응답은 값이 0인 경우 이 속성을 생략합니다.vehicleStartTime은 차량이 경로를 시작해야 하는 시간입니다.vehicleEndTime은 차량이 운행을 완료할 것으로 예상되는 시간입니다. 있습니다.
응답에서 routes는 다음과 같이 표시됩니다.
{
"routes": [
{
"vehicleStartTime": "2024-02-13T00:00:00Z",
"vehicleEndTime": "2024-02-13T00:38:42Z",
"visits": [
...
],
"transitions": [
...
],
"metrics": {
...
},
...
}
],
...
}
각 ShipmentRoute에는 차량이 실행할 visits의 순서가 지정된 목록이 포함되어 있습니다.
합니다. 각 Visit (REST, gRPC)는 VisitRequest
(REST, gRPC)를 사용합니다. 중요 Visit
속성은 다음과 같습니다.
shipmentIndex는 이 방문에 속한 배송의 0부터 시작하는 색인입니다. 로 설정합니다.isPickup는 방문이 승차인 경우 true이고, 방문이 승차인 경우 false입니다. 배달. 값이 false인 경우 REST 응답은 이 속성을 생략합니다.visitRequestIndex는 다음 항목의VisitRequest의 0부터 시작하는 색인입니다. 해당하는 요청에서Shipment.pickups또는Shipment.deliveriesVisit를 나타냅니다. REST 응답은 값은 0입니다.startTime은 방문이 시작될 것으로 예상되는 시간입니다.loadDemands는Visit입니다. 게재 방문수의 로드 금액이 음수입니다. 이는 부하를 나타냅니다. 차량에서 제거됩니다.
Visit 예는 다음과 같습니다.
{
"routes": [
{
...
"visits": [
{
"isPickup": true,
"startTime": "2024-02-13T00:00:00Z",
"detour": "0s"
},
...
],
},
...
],
...
}
각 ShipmentRoute에는 다음을 나타내는 transitions의 순서가 지정된 목록이 포함되어 있습니다.
차량의 visits 간 이동입니다. 중요한 Transition 메시지
(REST, gRPC) 속성은 다음과 같습니다.
startTime은 차량이 작업을 시작하는 시간입니다. 있습니다.travelDuration은 차량이 이동해야 하는 시간입니다. 전환을 완료할 수 있습니다travelDistanceMeters는 차량이 이동해야 하는 거리(미터)입니다. 전환을 완료할 수 있습니다.trafficInfoUnavailable는 다음에 대한 교통정보 데이터를 사용할 수 있는지 여부를 나타냅니다. 있습니다.waitDuration는 차량이 대기할 수 있을 때까지 대기하는 유휴 시간을 나타냅니다. 다음Visit가 시작됩니다. 이는start_time의 팔로우 중인 사용자:Visit명totalDuration은 총 전환 기간(여행 포함)입니다. 대기 시간, 휴식 시간, 지연 시간이 있습니다.vehicleLoads는 화물이 운반되는 적재량에 화물 유형을 매핑합니다. 확인할 수 있습니다.
Transition 예는 다음과 같습니다.
{
"routes": [
{
...
"transitions": [
...
{
"travelDuration": "1171s",
"travelDistanceMeters": 9004,
"waitDuration": "0s",
"totalDuration": "1171s",
"startTime": "2024-02-13T00:00:00Z"
},
...
],
...
}
],
...
}
vists과 transitions의 관계는 다음에 설명되어 있습니다.
수령 및 배송 중지 주문 최적화와
ShipmentRoute 참조 문서 (REST, gRPC)
측정항목 속성
Metrics 메시지 (REST, gRPC)는 전체 솔루션을 요약합니다.
몇 가지 중요한 Metrics 속성은 다음과 같습니다.
totalCost은(는) 경로를 완료하는 데 발생한 총 비용입니다. 자세히 알아보기 비용 모델 매개변수의 비용 정보usedVehicleCount는 솔루션에 사용되는 총 차량 수입니다. 옵티마이저가 차량의 용도를 판단할 때 차량에 빈 경로가 있을 수 있습니다. 필요하지 않습니다.skippedMandatoryShipmentCount는 건너뛴 배송의 수입니다. '필수'입니다. 필수 배송에서 다음과 같은penaltyCost를 지정하지 않았습니다. 배송을 건너뛰는 경우 발생합니다. 필수 배송은 여전히 지정된 제약조건에서 성능이 실현될 수 없는 경우 건너뜁니다. 비용 모델 매개변수에서 비용에 대해 자세히 알아보세요.
추가 측정항목은 AggregatedMetrics 메시지 (REST,
gRPC)를 사용합니다. AggregatedMetrics 메시지 유형은 다음에 사용됩니다.
Metrics.aggregatedRouteMetrics 속성 및 ShipmentRoute.metrics
Metrics.aggregatedRouteMetrics 속성에는
OptimizeToursResponse의 ShipmentRoute ShipmentRoute.metrics마다
속성에는 해당 ShipmentRoute에 대한 측정항목이 포함됩니다.
중요한 AggregatedMetrics 속성은 다음과 같습니다.
performedShipmentCount는 차량이 수행한 배송 수입니다. 학습합니다.travelDuration은 차량이 운송 중 소비한 총 시간입니다. 갈 수 있습니다.waitDuration은 차량이 완료하는 동안 대기한 총 시간입니다. 학습합니다.delayDuration은 차량의 총 지연 시간입니다. 일반적으로 요청에TransitionAttributes가 사용되지 않으면 0을 반환합니다.breakDuration은(는) 휴식 시간 동안 차량이 보낸 총 시간입니다. 갈 수 있습니다.visitDuration은(는) 차량이 방문을 수행하는 동안 소비한 총 시간입니다. 갈 수 있습니다. 이는 사실상Visit에 해당하는VisitRequest의VisitRequest.duration값 차량에 할당됩니다.totalDuration은 차량을 완료하는 데 필요한 총 소요 시간입니다. 경로.travelDistanceMeters은(는) 차량이 이동한 총거리입니다. 갈 수 있습니다.maxLoads는 차량을 이동할 수 없습니다.
Metrics 메시지의 예시는 다음과 같습니다.
{
"routes": [
...
],
"metrics": {
"aggregatedRouteMetrics": {
"performedShipmentCount": 1,
"travelDuration": "2322s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "0s",
"totalDuration": "2322s",
"travelDistanceMeters": 18603
},
"usedVehicleCount": 1,
"earliestVehicleStartTime": "2024-02-13T00:00:00Z",
"latestVehicleEndTime": "2024-02-13T00:38:42Z",
"totalCost": 18.603,
"costs": {
"model.vehicles.cost_per_kilometer": 18.603
}
}
}
전체 예시
요청 구성의 요청에 대한 전체 응답 예는 다음과 같습니다. 예를 들면 다음과 같습니다.
{
"routes": [
{
"vehicleStartTime": "2024-02-13T00:00:00Z",
"vehicleEndTime": "2024-02-13T00:38:42Z",
"visits": [
{
"isPickup": true,
"startTime": "2024-02-13T00:00:00Z",
"detour": "0s"
},
{
"startTime": "2024-02-13T00:19:31Z",
"detour": "0s"
}
],
"transitions": [
{
"travelDuration": "0s",
"waitDuration": "0s",
"totalDuration": "0s",
"startTime": "2024-02-13T00:00:00Z"
},
{
"travelDuration": "1171s",
"travelDistanceMeters": 9004,
"waitDuration": "0s",
"totalDuration": "1171s",
"startTime": "2024-02-13T00:00:00Z"
},
{
"travelDuration": "1151s",
"travelDistanceMeters": 9599,
"waitDuration": "0s",
"totalDuration": "1151s",
"startTime": "2024-02-13T00:19:31Z"
}
],
"metrics": {
"performedShipmentCount": 1,
"travelDuration": "2322s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "0s",
"totalDuration": "2322s",
"travelDistanceMeters": 18603
},
"routeCosts": {
"model.vehicles.cost_per_kilometer": 18.603
},
"routeTotalCost": 18.603
}
],
"metrics": {
"aggregatedRouteMetrics": {
"performedShipmentCount": 1,
"travelDuration": "2322s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "0s",
"totalDuration": "2322s",
"travelDistanceMeters": 18603
},
"usedVehicleCount": 1,
"earliestVehicleStartTime": "2024-02-13T00:00:00Z",
"latestVehicleEndTime": "2024-02-13T00:38:42Z",
"totalCost": 18.603,
"costs": {
"model.vehicles.cost_per_kilometer": 18.603
}
}
}