In diesem Beispiel wird gezeigt, wie Sie loadDemands und loadLimits verwenden, um Einschränkungen der Fahrzeugkapazität in einer Route Optimization API-Anfrage zu verwalten.
Eine vollständige konzeptionelle Übersicht finden Sie im Dokument Wichtige Konzepte für Lastanforderungen und ‑limits.
Beispielanfrage
Im folgenden Beispiel wird ein Szenario veranschaulicht, in dem ein einzelnes Fahrzeug mit einem Ladungsgewichtslimit drei Sendungen mit unterschiedlichem Gewicht ausliefern muss.
Diese Beispielanfrage enthält die folgenden lastbezogenen Parameter:
shipments[0]mit einer Lastanforderungamountvon 50weightKg.shipments[1]mit einer Lastanforderung vonamountvon 10weightKg.shipments[2]mit einer Lastanforderungamountvon 80weightKg.vehicles[0]mit einer Belastungsgrenze vonmaxLoad= 100weightKg.
Beispielanfrage mit Lastanforderungen und ‑limits
{ "populatePolylines": false, "populateTransitionPolylines": false, "model": { "globalStartTime": "2023-01-13T16:00:00Z", "globalEndTime": "2023-01-14T16:00:00Z", "shipments": [ { "deliveries": [ { "arrivalLocation": { "latitude": 37.789456, "longitude": -122.390192 }, "duration": "250s" } ], "pickups": [ { "arrivalLocation": { "latitude": 37.794465, "longitude": -122.394839 }, "duration": "150s" } ], "penaltyCost": 100.0, "loadDemands": { "weightKg": { "amount": "50" } } }, { "deliveries": [ { "arrivalLocation": { "latitude": 37.789116, "longitude": -122.395080 }, "duration": "250s" } ], "pickups": [ { "arrivalLocation": { "latitude": 37.794465, "longitude": -122.394839 }, "duration": "150s" } ], "penaltyCost": 15.0, "loadDemands": { "weightKg": { "amount": "10" } } }, { "deliveries": [ { "arrivalLocation": { "latitude": 37.795242, "longitude": -122.399347 }, "duration": "250s" } ], "pickups": [ { "arrivalLocation": { "latitude": 37.794465, "longitude": -122.394839 }, "duration": "150s" } ], "penaltyCost": 50.0, "loadDemands": { "weightKg": { "amount": "80" } } } ], "vehicles": [ { "endLocation": { "latitude": 37.794465, "longitude": -122.394839 }, "startLocation": { "latitude": 37.794465, "longitude": -122.394839 }, "costPerHour": 40.0, "costPerKilometer": 10.0, "loadLimits": { "weightKg": { "maxLoad": "100" } } } ] } }
Beispielantwort
In der Antwort wird die optimierte Route für das Fahrzeug angezeigt. Da die Gesamtladung aller Sendungen die Kapazität des Fahrzeugs übersteigt, erstellt der Optimierer eine Reihenfolge von Abholungen und Zustellungen, um sicherzustellen, dass die loadLimits nicht verletzt werden.
Eine Antwort auf die Anfrage mit Lastanforderungen und ‑limits ansehen
{ "routes": [ { "vehicleStartTime": "2023-01-13T16:00:00Z", "vehicleEndTime": "2023-01-13T16:43:27Z", "visits": [ { "isPickup": true, "startTime": "2023-01-13T16:00:00Z", "detour": "0s", "loadDemands": { "weightKg": { "amount": "50" } } }, { "shipmentIndex": 1, "isPickup": true, "startTime": "2023-01-13T16:02:30Z", "detour": "150s", "loadDemands": { "weightKg": { "amount": "10" } } }, { "startTime": "2023-01-13T16:08:55Z", "detour": "150s", "loadDemands": { "weightKg": { "amount": "-50" } } }, { "shipmentIndex": 1, "startTime": "2023-01-13T16:16:37Z", "detour": "343s", "loadDemands": { "weightKg": { "amount": "-10" } } }, { "shipmentIndex": 2, "isPickup": true, "startTime": "2023-01-13T16:27:07Z", "detour": "1627s", "loadDemands": { "weightKg": { "amount": "80" } } }, { "shipmentIndex": 2, "startTime": "2023-01-13T16:36:26Z", "detour": "0s", "loadDemands": { "weightKg": { "amount": "-80" } } } ], "transitions": [ { "travelDuration": "0s", "waitDuration": "0s", "totalDuration": "0s", "startTime": "2023-01-13T16:00:00Z", "vehicleLoads": { "weightKg": {} } }, { "travelDuration": "0s", "waitDuration": "0s", "totalDuration": "0s", "startTime": "2023-01-13T16:02:30Z", "vehicleLoads": { "weightKg": { "amount": "50" } } }, { "travelDuration": "235s", "travelDistanceMeters": 795, "waitDuration": "0s", "totalDuration": "235s", "startTime": "2023-01-13T16:05:00Z", "vehicleLoads": { "weightKg": { "amount": "60" } } }, { "travelDuration": "212s", "travelDistanceMeters": 791, "waitDuration": "0s", "totalDuration": "212s", "startTime": "2023-01-13T16:13:05Z", "vehicleLoads": { "weightKg": { "amount": "10" } } }, { "travelDuration": "380s", "travelDistanceMeters": 1190, "waitDuration": "0s", "totalDuration": "380s", "startTime": "2023-01-13T16:20:47Z", "vehicleLoads": { "weightKg": {} } }, { "travelDuration": "409s", "travelDistanceMeters": 1371, "waitDuration": "0s", "totalDuration": "409s", "startTime": "2023-01-13T16:29:37Z", "vehicleLoads": { "weightKg": { "amount": "80" } } }, { "travelDuration": "171s", "travelDistanceMeters": 665, "waitDuration": "0s", "totalDuration": "171s", "startTime": "2023-01-13T16:40:36Z", "vehicleLoads": { "weightKg": {} } } ], "metrics": { "performedShipmentCount": 3, "travelDuration": "1407s", "waitDuration": "0s", "delayDuration": "0s", "breakDuration": "0s", "visitDuration": "1200s", "totalDuration": "2607s", "travelDistanceMeters": 4812, "maxLoads": { "weightKg": { "amount": "80" } } }, "routeCosts": { "model.vehicles.cost_per_kilometer": 48.12, "model.vehicles.cost_per_hour": 28.966666666666665 }, "routeTotalCost": 77.086666666666659 } ], "metrics": { "aggregatedRouteMetrics": { "performedShipmentCount": 3, "travelDuration": "1407s", "waitDuration": "0s", "delayDuration": "0s", "breakDuration": "0s", "visitDuration": "1200s", "totalDuration": "2607s", "travelDistanceMeters": 4812, "maxLoads": { "weightKg": { "amount": "80" } } }, "usedVehicleCount": 1, "earliestVehicleStartTime": "2023-01-13T16:00:00Z", "latestVehicleEndTime": "2023-01-13T16:43:27Z", "totalCost": 77.086666666666659, "costs": { "model.vehicles.cost_per_hour": 28.966666666666665, "model.vehicles.cost_per_kilometer": 48.12 } } }
Da das kombinierte loadDemands der drei Sendungen (50 + 10 + 80 = 140) das loadLimits des Fahrzeugs (100) überschreitet, kann das Fahrzeug nicht alle Sendungen gleichzeitig abholen. Der Optimierer berücksichtigt nur Routen, bei denen shipment[0] und shipment[2] nicht gleichzeitig im Fahrzeug sind, da diese Sendungen mit ihrem kombinierten Gewicht das Ladungsgewicht des Fahrzeugs überschreiten.
Die Route hat die folgenden visits, um das zulässige Gesamtgewicht des Fahrzeugs nicht zu überschreiten:
shipment[0]wird abgeholtshipment[1]wird abgeholtshipment[0]wird ausgeliefertshipment[1]wird ausgeliefertshipment[2]wird abgeholtshipment[2]wird ausgeliefert
Die Ladung des Fahrzeugs ändert sich im Laufe der Route. Das können Sie im transitions-Array beobachten. transitions[2] zeigt beispielsweise das Fahrzeug mit einer Ladung von 60 weightKg nach dem Abholen der ersten beiden Sendungen (50 + 10).
Das Attribut maxLoads in metrics gibt an, dass die maximale Last, die zu einem beliebigen Zeitpunkt auf der Route transportiert wurde, 80 weightKg betrug. Damit wird bestätigt, dass die Lösung das Limit von 100 weightKg des Fahrzeugs eingehalten hat.
Weiche Lastlimits
Im folgenden Beispiel wird gezeigt, wie Sie ein weiches Lastlimit verwenden, um eine Route mit mehreren Fahrzeugen zu optimieren. Bei der Lösung werden die Sendungen auf die beiden Fahrzeuge aufgeteilt, um die Kostenüberschreitung für die Überschreitung des weichen Ladegrenzgewichts des Fahrzeugs zu vermeiden.
Beispielanfrage
Diese Anfrage enthält jetzt drei reine Lieferungen und zwei Fahrzeuge mit derselben loadLimits und softMaxLoad.
Die wichtigsten Parameter für dieses Beispiel sind:
- Die drei Sendungen haben zusammen ein
loadDemandsvon 140weightKg(50- 60 + 30).
- Es gibt zwei Fahrzeuge mit einem
softMaxLoadvon „100“weightKgund einemcostPerUnitAboveSoftMaxvon 5,0.
Beispielanfrage mit einem Soft-Load-Limit ansehen
{ "populatePolylines": false, "populateTransitionPolylines": false, "model": { "globalStartTime": "2023-01-13T16:00:00Z", "globalEndTime": "2023-01-14T16:00:00Z", "shipments": [ { "deliveries": [ { "arrivalLocation": { "latitude": 37.789456, "longitude": -122.390192 }, "duration": "250s" } ], "loadDemands": { "weightKg": { "amount": "50" } } }, { "deliveries": [ { "arrivalLocation": { "latitude": 37.789116, "longitude": -122.395080 }, "duration": "250s" } ], "loadDemands": { "weightKg": { "amount": "60" } } }, { "deliveries": [ { "arrivalLocation": { "latitude": 37.795242, "longitude": -122.399347 }, "duration": "250s" } ], "loadDemands": { "weightKg": { "amount": "30" } } } ], "vehicles": [ { "endLocation": { "latitude": 37.794465, "longitude": -122.394839 }, "startLocation": { "latitude": 37.794465, "longitude": -122.394839 }, "costPerHour": 40.0, "costPerKilometer": 10.0, "loadLimits": { "weightKg": { "maxLoad": "150", "softMaxLoad": "100", "costPerUnitAboveSoftMax": 5.0 } } }, { "endLocation": { "latitude": 37.794465, "longitude": -122.394839 }, "startLocation": { "latitude": 37.794465, "longitude": -122.394839 }, "costPerHour": 40.0, "costPerKilometer": 10.0, "loadLimits": { "weightKg": { "maxLoad": "150", "softMaxLoad": "100", "costPerUnitAboveSoftMax": 5.0 } } } ] } }
Beispielantwort
Die Antwort enthält jetzt zwei Routen, eine für jedes Fahrzeug. Das Optimierungsprogramm stellt fest, dass die Verwendung beider Fahrzeuge kostengünstiger ist als die Verwendung eines Fahrzeugs und die Überschreitung des weichen Limits.
Antwort auf die Anfrage mit einem Soft-Load-Limit ansehen
{ "routes": [ { "vehicleStartTime": "2023-01-13T16:00:00Z", "vehicleEndTime": "2023-01-13T16:13:31Z", "visits": [ { "startTime": "2023-01-13T16:03:53Z", "detour": "0s", "loadDemands": { "weightKg": { "amount": "-50" } } } ], "transitions": [ { "travelDuration": "233s", "travelDistanceMeters": 794, "waitDuration": "0s", "totalDuration": "233s", "startTime": "2023-01-13T16:00:00Z", "vehicleLoads": { "weightKg": { "amount": "50" } } }, { "travelDuration": "328s", "travelDistanceMeters": 1188, "waitDuration": "0s", "totalDuration": "328s", "startTime": "2023-01-13T16:08:03Z", "vehicleLoads": { "weightKg": {} } } ], "metrics": { "performedShipmentCount": 1, "travelDuration": "561s", "visitDuration": "250s", "totalDuration": "811s", "travelDistanceMeters": 1982, "maxLoads": { "weightKg": { "amount": "50" } } }, "routeCosts": { "model.vehicles.cost_per_kilometer": 19.82, "model.vehicles.cost_per_hour": 9.01 }, "routeTotalCost": 28.83 }, { "vehicleIndex": 1, "vehicleStartTime": "2023-01-13T16:00:00Z", "vehicleEndTime": "2023-01-13T16:21:43Z", "visits": [ { "shipmentIndex": 1, "startTime": "2023-01-13T16:05:54Z", "detour": "0s", "loadDemands": { "weightKg": { "amount": "-60" } } }, { "shipmentIndex": 2, "startTime": "2023-01-13T16:13:52Z", "detour": "473s", "loadDemands": { "weightKg": { "amount": "-30" } } } ], "transitions": [ { "travelDuration": "354s", "travelDistanceMeters": 1196, "waitDuration": "0s", "totalDuration": "354s", "startTime": "2023-01-13T16:00:00Z", "vehicleLoads": { "weightKg": { "amount": "90" } } }, { "travelDuration": "228s", "travelDistanceMeters": 808, "waitDuration": "0s", "totalDuration": "228s", "startTime": "2023-01-13T16:10:04Z", "vehicleLoads": { "weightKg": { "amount": "30" } } }, { "travelDuration": "221s", "travelDistanceMeters": 655, "waitDuration": "0s", "totalDuration": "221s", "startTime": "2023-01-13T16:18:02Z", "vehicleLoads": { "weightKg": {} } } ], "metrics": { "performedShipmentCount": 2, "travelDuration": "803s", "visitDuration": "500s", "totalDuration": "1303s", "travelDistanceMeters": 2659, "maxLoads": { "weightKg": { "amount": "90" } } }, "routeCosts": { "model.vehicles.cost_per_kilometer": 26.59, "model.vehicles.cost_per_hour": 14.48 }, "routeTotalCost": 41.07 } ], "metrics": { "aggregatedRouteMetrics": { "performedShipmentCount": 3, "travelDuration": "1364s", "visitDuration": "750s", "totalDuration": "2114s", "travelDistanceMeters": 4641, "maxLoads": { "weightKg": { "amount": "90" } } }, "usedVehicleCount": 2, "earliestVehicleStartTime": "2023-01-13T16:00:00Z", "latestVehicleEndTime": "2023-01-13T16:21:43Z", "totalCost": 69.90, "costs": { "model.vehicles.cost_per_kilometer": 46.41, "model.vehicles.cost_per_hour": 23.49 } } }
Die folgenden Felder zeigen, wie der Optimierer die Sendungen auf die beiden Fahrzeuge aufgeteilt hat, um die Ladungen unter dem Softlimit von 100 weightKg zu halten.
- Die erste Route (
vehicleIndex: 0) verarbeitet die 50weightKg-Sendung. DermaxLoadsbeträgt „50“ und liegt damit unter dem weichen Limit. - Die zweite Route (
vehicleIndex: 1) verarbeitet die 60- und 30-weightKg-Sendungen. DermaxLoadsbeträgt „90“ und liegt damit ebenfalls unter dem weichen Limit. - Da keines der Fahrzeuge das Soft Limit überschreitet, wird für beide Routen kein
costPerUnitAboveSoftMax-Malus fürrouteCostsangezeigt.