Panduan ini menunjukkan bagaimana jumlah kendaraan yang disediakan dalam solusi Pengoptimalan Rute dapat bervariasi bergantung pada parameter permintaan.
Route Optimization API tidak hanya mengoptimalkan pesanan penyelesaian pengiriman, tetapi juga menetapkan pengiriman tersebut ke kendaraan untuk mengoptimalkan biaya dalam batasan yang Anda kelola.
Pada contoh pertama, jumlah kendaraan cocok dengan jumlah pengiriman, dengan semua kendaraan memiliki biaya dan properti lokasi yang sama. Setiap kendaraan memiliki biaya per jam operasional dan biaya per kilometer yang ditempuh, yang akan membantu meminimalkan waktu dan jarak perjalanan. Orang mungkin berharap beberapa kendaraan akan ditugaskan pengiriman, tetapi contoh respons menunjukkan solusi biaya paling murah berdasarkan parameter model biaya yang ditentukan.
Lihat contoh permintaan dengan beberapa kendaraan
{
"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": 50.0,
"costPerKilometer": 10.0
},
{
"endLocation": {
"latitude": 37.794465,
"longitude": -122.394839
},
"startLocation": {
"latitude": 37.794465,
"longitude": -122.394839
},
"costPerHour": 50.0,
"costPerKilometer": 10.0
},
{
"endLocation": {
"latitude": 37.794465,
"longitude": -122.394839
},
"startLocation": {
"latitude": 37.794465,
"longitude": -122.394839
},
"costPerHour": 50.0,
"costPerKilometer": 10.0
}
]
}
}
Lihat respons terhadap permintaan dengan beberapa kendaraan
{
"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": 23.638888888888889
},
"routeTotalCost": 57.168888888888887
},
{
"vehicleIndex": 1
},
{
"vehicleIndex": 2
}
],
"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": 62.168888888888887,
"costs": {
"model.vehicles.cost_per_hour": 23.638888888888889,
"model.shipments.penalty_cost": 5,
"model.vehicles.cost_per_kilometer": 33.53
}
}
}
Pemecah masalah menetapkan semua pengiriman hanya ke satu kendaraan, sehingga melewati satu pengiriman
meskipun kendaraan tersedia cukup banyak. Hal ini karena biaya pengoperasian
kendaraan tambahan terlalu tinggi, dan tidak efektif bagi
kendaraan apa pun untuk menyelesaikan pengiriman yang dilewati mengingat biaya penaltinya yang rendah.
Meskipun kapasitas kendaraan tersedia, satu kendaraan dapat melakukan semua pengiriman yang ditetapkan dengan cara yang paling hemat biaya. Kendaraan dalam permintaan tidak
memiliki properti usedIfRouteIsEmpty yang ditetapkan (lihat dokumentasi pesan
Vehicle (REST, gRPC) untuk mengetahui detailnya), sehingga tidak dikenai biaya jika
tidak digunakan.
Mengubah parameter biaya untuk memprioritaskan solusi yang lebih singkat secara global dan bukan rute kendaraan yang lebih pendek akan menyebabkan lebih banyak kendaraan berpartisipasi dalam solusi ini. Contoh permintaan berikutnya mengganti Vehicle.costPerHour dengan
ShipmentModel.globalDurationCostPerHour global, yang memprioritaskan solusi
dengan total waktu operasional yang lebih singkat untuk kendaraan tertentu. Biaya penalti
untuk shipment[1] juga dinaikkan guna mengurangi kemungkinannya
dilewati.
Lihat contoh permintaan menggunakan
globalDurationCostPerHour
{
"model": {
"globalStartTime": "2023-01-13T16:00:00-08:00",
"globalEndTime": "2023-01-14T16:00:00-08:00",
"globalDurationCostPerHour": 150.0,
"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": 75.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
},
"costPerKilometer": 10.0
},
{
"endLocation": {
"latitude": 37.794465,
"longitude": -122.394839
},
"startLocation": {
"latitude": 37.794465,
"longitude": -122.394839
},
"costPerKilometer": 10.0
},
{
"endLocation": {
"latitude": 37.794465,
"longitude": -122.394839
},
"startLocation": {
"latitude": 37.794465,
"longitude": -122.394839
},
"costPerKilometer": 10.0
}
]
}
}
Hasilnya menunjukkan bahwa penggunaan parameter biaya per jam global menyebabkan ketiga kendaraan digunakan, bukan hanya satu.
Lihat respons terhadap permintaan menggunakan
globalDurationCostPerHour
{
"routes": [
{
"vehicleStartTime": "2023-01-14T00:00:00Z",
"vehicleEndTime": "2023-01-14T00:16:20Z",
"visits": [
{
"shipmentIndex": 2,
"isPickup": true,
"startTime": "2023-01-14T00:00:00Z",
"detour": "0s"
},
{
"shipmentIndex": 2,
"startTime": "2023-01-14T00:09:19Z",
"detour": "0s"
}
],
"transitions": [
{
"travelDuration": "0s",
"waitDuration": "0s",
"totalDuration": "0s",
"startTime": "2023-01-14T00:00:00Z"
},
{
"travelDuration": "409s",
"travelDistanceMeters": 1371,
"waitDuration": "0s",
"totalDuration": "409s",
"startTime": "2023-01-14T00:02:30Z"
},
{
"travelDuration": "171s",
"travelDistanceMeters": 665,
"waitDuration": "0s",
"totalDuration": "171s",
"startTime": "2023-01-14T00:13:29Z"
}
],
"metrics": {
"performedShipmentCount": 1,
"travelDuration": "580s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "400s",
"totalDuration": "980s",
"travelDistanceMeters": 2036
},
"routeCosts": {
"model.vehicles.cost_per_kilometer": 20.36
},
"routeTotalCost": 20.36
},
{
"vehicleIndex": 1,
"vehicleStartTime": "2023-01-14T00:00:00Z",
"vehicleEndTime": "2023-01-14T00:18:54Z",
"visits": [
{
"shipmentIndex": 1,
"isPickup": true,
"startTime": "2023-01-14T00:00:00Z",
"detour": "0s"
},
{
"shipmentIndex": 1,
"startTime": "2023-01-14T00:08:24Z",
"detour": "0s"
}
],
"transitions": [
{
"travelDuration": "0s",
"waitDuration": "0s",
"totalDuration": "0s",
"startTime": "2023-01-14T00:00:00Z"
},
{
"travelDuration": "354s",
"travelDistanceMeters": 1192,
"waitDuration": "0s",
"totalDuration": "354s",
"startTime": "2023-01-14T00:02:30Z"
},
{
"travelDuration": "380s",
"travelDistanceMeters": 1190,
"waitDuration": "0s",
"totalDuration": "380s",
"startTime": "2023-01-14T00:12:34Z"
}
],
"metrics": {
"performedShipmentCount": 1,
"travelDuration": "734s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "400s",
"totalDuration": "1134s",
"travelDistanceMeters": 2382
},
"routeCosts": {
"model.vehicles.cost_per_kilometer": 23.82
},
"routeTotalCost": 23.82
},
{
"vehicleIndex": 2,
"vehicleStartTime": "2023-01-14T00:00:00Z",
"vehicleEndTime": "2023-01-14T00:16:14Z",
"visits": [
{
"isPickup": true,
"startTime": "2023-01-14T00:00:00Z",
"detour": "0s"
},
{
"startTime": "2023-01-14T00:06:25Z",
"detour": "0s"
}
],
"transitions": [
{
"travelDuration": "0s",
"waitDuration": "0s",
"totalDuration": "0s",
"startTime": "2023-01-14T00:00:00Z"
},
{
"travelDuration": "235s",
"travelDistanceMeters": 795,
"waitDuration": "0s",
"totalDuration": "235s",
"startTime": "2023-01-14T00:02:30Z"
},
{
"travelDuration": "339s",
"travelDistanceMeters": 1276,
"waitDuration": "0s",
"totalDuration": "339s",
"startTime": "2023-01-14T00:10:35Z"
}
],
"metrics": {
"performedShipmentCount": 1,
"travelDuration": "574s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "400s",
"totalDuration": "974s",
"travelDistanceMeters": 2071
},
"routeCosts": {
"model.vehicles.cost_per_kilometer": 20.71
},
"routeTotalCost": 20.71
}
],
"metrics": {
"aggregatedRouteMetrics": {
"performedShipmentCount": 3,
"travelDuration": "1888s",
"waitDuration": "0s",
"delayDuration": "0s",
"breakDuration": "0s",
"visitDuration": "1200s",
"totalDuration": "3088s",
"travelDistanceMeters": 6489
},
"usedVehicleCount": 3,
"earliestVehicleStartTime": "2023-01-14T00:00:00Z",
"latestVehicleEndTime": "2023-01-14T00:18:54Z",
"totalCost": 112.14,
"costs": {
"model.vehicles.cost_per_kilometer": 64.89,
"model.global_duration_cost_per_hour": 47.25
}
}
}
Dalam respons ini, ketiga kendaraan tersebut sedang digunakan (per metrics.usedVehicleCount)
dengan setiap kendaraan diberi satu pengiriman untuk diselesaikan. Dengan lokasi awal, lokasi akhir, dan costPerKilometer yang identik, ketiga kendaraan tersebut
secara efektif dapat dipertukarkan, sehingga tidak masalah pengiriman mana yang ditetapkan ke
kendaraan yang mana.
globalDurationCostPerHour menyebabkan pengoptimal menemukan solusi yang
lebih pendek secara keseluruhan: perbedaan antara earliestVehicleStartTime dan
latestVehicleEndTime hanya 18 menit 54 detik, bukan 28
menit dan 22 detik pada respons sebelumnya. Meskipun demikian, metrics.costs.model.vehicles.cost_per_kilometer telah meningkat, yang mencerminkan total
jarak yang ditempuh oleh tiga kendaraan bekas. Hal ini menunjukkan satu cara di mana model biaya memungkinkan Anda melakukan kompromi:
- Peningkatan biaya waktu global: Tingkatkan penggunaan kendaraan untuk meminimalkan waktu penyelesaian secara keseluruhan, dengan mengorbankan jarak dan waktu kendaraan yang lebih besar selama transit.
- Peningkatan biaya waktu kendaraan: Kurangi penggunaan kendaraan dan waktu yang dihabiskan selama transit, dengan mengorbankan solusi keseluruhan yang lebih lama.
Perhatikan bahwa nilai globalDurationCostPerHour 150,0 dalam contoh ini ditetapkan
pada tiga kali costPerHour kendaraan individual sebesar 50,0 dari contoh
sebelumnya. Nilai biaya global ini secara efektif memperkirakan bahwa ketiga kendaraan tersebut akan
beroperasi secara bersamaan, tetapi dalam praktiknya, asumsi tersebut mungkin tidak
mencerminkan kenyataan dan bahkan dapat berdampak negatif terhadap kualitas hasil.
Seperti yang dijelaskan dalam Parameter Model Biaya, semua parameter biaya dinyatakan dalam unit tanpa dimensi yang sama, tetapi dapat memiliki arti yang sangat berbeda. Biasanya, parameter value model biaya harus didasarkan pada realitas sebanyak mungkin, karena biaya buatan seperti dalam contoh ini dapat menyebabkan API dioptimalkan untuk tujuan yang tidak cocok dengan intent Anda.