Сообщение OptimizeToursRequest ( REST , gRPC ) содержит ряд свойств, связанных со стоимостью . Вместе эти параметры стоимости представляют модель стоимости запроса. Модель затрат отражает многие цели оптимизации запроса высокого уровня, такие как:
- Приоритет более быстрых маршрутов
Vehicleнад более короткими маршрутами или наоборот - Принятие решения о том, соответствуют ли затраты на доставку
ShipmentстоимостиShipmentзавершения. - Выполнение самовывоза и доставки в пределах временных окон только тогда, когда это экономически эффективно.
Посмотреть пример запроса с указанием стоимости
{
"model": {
"globalStartTime": "2023-01-13T16:00:00-08:00",
"globalEndTime": "2023-01-14T16:00:00-08:00",
"shipments": [
{
"deliveries": [
{
"arrivalLocation": {
"latitude": 37.789456,
"longitude": -122.390192
},
"duration": "250s"
}
],
"pickups": [
{
"arrivalLocation": {
"latitude": 37.794465,
"longitude": -122.394839
},
"duration": "150s"
}
],
"penaltyCost": 100.0
},
{
"deliveries": [
{
"arrivalLocation": {
"latitude": 37.789116,
"longitude": -122.395080
},
"duration": "250s"
}
],
"pickups": [
{
"arrivalLocation": {
"latitude": 37.794465,
"longitude": -122.394839
},
"duration": "150s"
}
],
"penaltyCost": 5.0
},
{
"deliveries": [
{
"arrivalLocation": {
"latitude": 37.795242,
"longitude": -122.399347
},
"duration": "250s"
}
],
"pickups": [
{
"arrivalLocation": {
"latitude": 37.794465,
"longitude": -122.394839
},
"duration": "150s"
}
],
"penaltyCost": 50.0
}
],
"vehicles": [
{
"endLocation": {
"latitude": 37.794465,
"longitude": -122.394839
},
"startLocation": {
"latitude": 37.794465,
"longitude": -122.394839
},
"costPerHour": 40.0,
"costPerKilometer": 10.0
}
]
}
}
Свойства стоимости Vehicle
Сообщение Vehicle ( REST , gRPC ) имеет несколько свойств стоимости:
-
Vehicle.cost_per_hour: представляет стоимость эксплуатации транспортного средства в час, включая время в пути, ожидание, посещение и перерыв. -
Vehicle.cost_per_kilometer: представляет стоимость километра пути, пройденного транспортным средством. -
Vehicle.cost_per_traveled_hour: представляет стоимость эксплуатации транспортного средства только во время пути, исключая время ожидания, посещения и перерыва.
Эти параметры стоимости позволяют оптимизатору найти компромисс между временем и пройденным расстоянием. Затраты, понесенные оптимизированным маршрутом, отображаются в ответном сообщении как metrics.costs :
По мере увеличения costPerHour оптимизатор пытается найти более быстрые маршруты, которые могут не быть самыми короткими . В этом примере самый быстрый маршрут оказывается самым коротким, поэтому изменения в параметрах стоимости малоэффективны.
Свойства стоимости Shipment
Сообщение Shipment ( REST , gRPC ) также имеет несколько параметров стоимости:
-
Shipment.penalty_costпредставляет собой стоимость, понесенную в результате пропуска отгрузки. -
Shipment.VisitRequest.costпредставляет стоимость конкретного получения или доставки, используемую в первую очередь для обеспечения компромисса между несколькими вариантами получения или доставки для одной отправки.
В параметрах стоимости Shipment используются те же безразмерные единицы, что и в параметрах стоимости Vehicle . Затраты, понесенные при отправке Shipment , превышают стоимость штрафа, Shipment не включается ни в один маршрут Vehicle и вместо этого отображается в списке skipped_shipments в ответном сообщении.
Свойства стоимости ShipmentModel
Сообщение ShipmentModel ( REST , gRPC ) включает одно свойство стоимости globalDurationCostPerHour . Эти затраты рассчитываются исходя из общего времени, необходимого всем транспортным средствам для прохождения ShipmentRoute . Увеличение globalDurationCostPerHour отдает приоритет более раннему завершению всех поставок.
Свойства стоимости ответа на оптимизацию маршрута
Сообщение OptimizeToursResponse ( REST , gRPC ) имеет свойства стоимости, которые представляют затраты, понесенные в процессе выполнения ShipmentRoute . Свойства metrics.costs и metrics.totalCost представляют количество единиц затрат, понесенных по всем маршрутам в ответе. Каждая запись routes имеет свойства routeCosts и routeTotalCosts , которые представляют затраты для этого конкретного маршрута.
Посмотреть ответ на пример запроса со стоимостью
{
"routes": [
{
"vehicleStartTime": "2023-01-14T00:00:00Z",
"vehicleEndTime": "2023-01-14T00:28:22Z",
"visits": [
{
"isPickup": true,
"startTime": "2023-01-14T00:00:00Z",
"detour": "0s"
},
{
"shipmentIndex": 2,
"isPickup": true,
"startTime": "2023-01-14T00:02:30Z",
"detour": "150s"
},
{
"startTime": "2023-01-14T00:08:55Z",
"detour": "150s"
},
{
"shipmentIndex": 2,
"startTime": "2023-01-14T00:21:21Z",
"detour": "572s"
}
],
"transitions": [
{
"travelDuration": "0s",
"waitDuration": "0s",
"totalDuration": "0s",
"startTime": "2023-01-14T00:00:00Z"
},
{
"travelDuration": "0s",
"waitDuration": "0s",
"totalDuration": "0s",
"startTime": "2023-01-14T00:02:30Z"
},
{
"travelDuration": "235s",
"travelDistanceMeters": 795,
"waitDuration": "0s",
"totalDuration": "235s",
"startTime": "2023-01-14T00:05:00Z"
},
{
"travelDuration": "496s",
"travelDistanceMeters": 1893,
"waitDuration": "0s",
"totalDuration": "496s",
"startTime": "2023-01-14T00:13:05Z"
},
{
"travelDuration": "171s",
"travelDistanceMeters": 665,
"waitDuration": "0s",
"totalDuration": "171s",
"startTime": "2023-01-14T00:25:31Z"
}
],
"metrics": {
"performedShipmentCount": 2,
"travelDuration": "902s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "800s",
"totalDuration": "1702s",
"travelDistanceMeters": 3353
},
"routeCosts": {
"model.vehicles.cost_per_kilometer": 33.53,
"model.vehicles.cost_per_hour": 18.911111111111111
},
"routeTotalCost": 52.441111111111113
}
],
"skippedShipments": [
{
"index": 1
}
],
"metrics": {
"aggregatedRouteMetrics": {
"performedShipmentCount": 2,
"travelDuration": "902s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "800s",
"totalDuration": "1702s",
"travelDistanceMeters": 3353
},
"usedVehicleCount": 1,
"earliestVehicleStartTime": "2023-01-14T00:00:00Z",
"latestVehicleEndTime": "2023-01-14T00:28:22Z",
"totalCost": 57.441111111111113,
"costs": {
"model.vehicles.cost_per_kilometer": 33.53,
"model.vehicles.cost_per_hour": 18.911111111111111,
"model.shipments.penalty_cost": 5
}
}
}
В примере ответа metrics.costs верхнего уровня:
{
"metrics": {
...
"costs": {
"model.vehicles.cost_per_hour": 18.911111111111111,
"model.vehicles.cost_per_kilometer": 33.53,
"model.shipments.penalty_cost": 5
}
}
}
Значение model.shipments.penalty_cost представляет собой затраты, понесенные из-за пропущенных поставок. Свойство skippedShipments перечисляет, какие поставки были пропущены.
В этом примере пропускается только model.shipments[1] в примере запроса. model.shipments[1] имеет штрафную стоимость в 5 единиц, что соответствует общему ключу model.shipments.penalty_cost в примере ответа. Низкая penaltyCost доставки по сравнению со costPerHour 40,0 за час и 10,0 costPerKilometer у Vehicle делает пропустить доставку более рентабельной, чем завершить ее.
Расширенная тема: затраты и мягкие ограничения
Некоторые свойства сообщения OptimizeToursRequest ( REST , gRPC ) представляют мягкие ограничения , которые представляют собой ограничения, которые влекут за собой затраты, когда они не могут быть удовлетворены.
Например, ограничения LoadLimit транспортного средства ( REST , gRPC ) имеют свойства softMaxLoad и costPerUnitAboveSoftMax . Вместе они влекут за собой затраты, пропорциональные единицам нагрузки, превышающим softMaxLoad , что позволяет превысить предел только в том случае, если это имеет смысл с точки зрения затрат.
Аналогично, ограничения TimeWindow ( REST , gRPC ) имеют свойства soft_start_time и soft_end_time с соответствующими cost_per_hour_before_soft_start_time и cost_per_hour_after_soft_end_time , которые возникают в зависимости от того, насколько рано или поздно происходит ограниченное событие по отношению к TimeWindow .
Как и все параметры модели стоимости, затраты с мягкими ограничениями выражаются в тех же безразмерных единицах, что и другие параметры стоимости.
Ограничения LoadLimit подробно рассматриваются в разделе «Требования и ограничения нагрузки» . Ограничения TimeWindow подробно рассматриваются в разделе «Ограничения окон времени получения и доставки» .