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
Das folgende Beispiel zeigt ein Szenario, 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 Lastanforderung vonamountvon 80weightKg.vehicles[0]mit einem LastlimitmaxLoadvon 100weightKg.
Beispielanfrage mit Lastanforderungen und ‑limits 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" } ], "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 Gesamtlast aller Sendungen die Kapazität des Fahrzeugs überschreitet, 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 die kombinierte loadDemands der drei Sendungen (50 + 10 + 80 = 140) die 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, damit das Ladungsgewicht des Fahrzeugs nicht überschritten wird:
shipment[0]wird abgeholtshipment[1]wird abgeholtshipment[0]wird geliefertshipment[1]wird geliefertshipment[2]wird abgeholtshipment[2]wird geliefert
Die Beladung des Fahrzeugs ändert sich im Laufe der Route. Das können Sie im transitions-Array beobachten. Beispiel: transitions[2] zeigt das Fahrzeug mit einer Ladung von 60 weightKg nach der Abholung der ersten beiden Sendungen (50 + 10).
Das Attribut maxLoads in metrics zeigt, 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 nicht überschritten hat.
Flexible Grenzwerte für die Last
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 Ladelimits 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
{ "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. Der Optimierer stellt fest, dass die Verwendung beider Fahrzeuge kostengünstiger ist als die Verwendung eines Fahrzeugs und die Überschreitung des Softlimits.
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 Lieferung von 50weightKg. DermaxLoads-Wert ist „50“ und liegt damit unter dem Soft Limit. - Die zweite Route (
vehicleIndex: 1) verarbeitet die Sendungen mit 60 und 30weightKg. DermaxLoadsist „90“ und liegt damit ebenfalls unter dem Soft Limit. - Da keines der Fahrzeuge das weiche Limit überschreitet, wird für beide Routen kein
costPerUnitAboveSoftMax-Malus fürrouteCostsangezeigt.