Seperti yang dijelaskan secara singkat dalam Ringkasan Pengoptimalan Rute, permintaan dasar terdiri dari Model, Pengiriman, dan Kendaraan sebagai entitas yang diperlukan:
- Model merekam setelan dan batasan untuk seluruh permintaan,
termasuk
Shipments
danVehicles
. - Pengiriman menunjukkan tugas atau pengiriman sebenarnya yang mencakup
VisitRequest
pengambilan dan pengiriman. Pengiriman memiliki setelan dan batasan lokal. - Kendaraan mewakili kendaraan, pengemudi, atau personel. Kendaraan juga memiliki setelan dan batasan lokal.
Setiap properti entity menjelaskan bagian masalah pengoptimalan pada tingkat perincian tertentu. Batasan seluruh model diterapkan ke semua pengiriman dan kendaraan, sedangkan batasan dan properti yang ditentukan pada pengiriman atau kendaraan berlaku khusus untuk satu pengiriman atau kendaraan.
Untuk dokumentasi lengkap tentang setiap jenis pesan, lihat dokumentasi referensi untuk pesan ShipmentModel
(REST, gRPC), Shipment
(REST, gRPC), dan Vehicle
(REST, gRPC).
OptimizeToursRequest
properti
Beberapa properti yang umum digunakan dari pesan OptimizeToursRequest
tingkat teratas (REST, gRPC) mencakup properti berikut:
searchMode
menunjukkan apakah akan menampilkan solusi pertama yang memenuhi batasan yang ditentukan atau menemukan solusi terbaik dalam batas waktu yang ditetapkan.considerRoadTraffic
menentukan apakah traffic live akan digunakan atau tidak untuk pemilihan rute dan estimasi PWT.populateTransitionPolylines
menentukan apakah polyline rute akan ditampilkan dalam respons atau tidak.
Properti model
Beberapa properti pesan ShipmentModel
yang umum digunakan (REST, gRPC) mencakup:
globalStartTime
menunjukkan waktu mulai rute paling awal di semua kendaraan dan pengiriman. Kendaraan tidak dapat memulai transisi dan pengiriman pertamanya sebelum waktu ini.globalEndTime
menunjukkan waktu berakhir rute terbaru di semua kendaraan dan pengiriman. Semua pengiriman dan transisi yang ditetapkan harus diselesaikan sebelum waktu ini.
Properti pengiriman
Beberapa properti pesan Shipment
yang umum digunakan (REST, gRPC)
mencakup:
pickups[]
dandeliveries[]
mewakili tempat pengiriman dapat diambil atau diturunkan. Propertipickups[]
dandeliveries[]
menggunakan pesanVisitRequest
(REST, gRPC).loadDemands
menunjukkan beban yang diperlukan kendaraan untuk menyelesaikan pengiriman. Propertiload_limits
(REST, gRPC) yang sesuai pada kendaraan menunjukkan jumlah beban yang dapat ditampung kendaraan pada satu waktu. Baca selengkapnya tentang beban di Permintaan dan Batas Beban.penalty_cost
menunjukkan biaya yang timbul jika pengiriman dilewati. Baca informasi lebih lanjut tentang biaya di Parameter Model Biaya.
Properti kendaraan
Beberapa properti pesan Vehicle
yang umum digunakan (REST, gRPC)
mencakup:
startLocation
menunjukkan tempat kendaraan harus memulai rutenya. Properti ini bersifat opsional. Jika tidak ditentukan, rute kendaraan akan dimulai di lokasi pengiriman pertama yang ditetapkan.endLocation
menunjukkan tempat kendaraan harus mengakhiri rutenya. Properti ini bersifat opsional. Jika tidak ditentukan, rute kendaraan berakhir di lokasi pengiriman terakhir yang ditetapkan.startTimeWindows[]
menunjukkan kapan kendaraan dapat memulai rutenya. Properti ini bersifat opsional.endTimeWindows[]
menunjukkan kapan kendaraan dapat memulai dan mengakhiri rutenya. Kedua properti bersifat opsional.loadLimits
menunjukkan kapasitas kendaraan yang tersedia untuk memenuhi permintaan muatan pengiriman. Baca lebih lanjut permintaan dan batas beban di Permintaan dan Batas Beban.
Contoh permintaan lengkap dalam format JSON terlihat seperti ini:
{
"model": {
"shipments": [
{
"pickups": [
{
"arrivalLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
}
}
],
"deliveries": [
{
"arrivalLocation": {
"latitude": 37.79581,
"longitude": -122.4218856
}
}
]
}
],
"vehicles": [
{
"startLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
},
"endLocation": {
"latitude": 37.73881799999999,
"longitude": -122.4161
},
"costPerKilometer": 1.0
}
],
"globalStartTime": "2024-02-13T00:00:00.000Z",
"globalEndTime": "2024-02-14T06:00:00.000Z"
}
}
OptimizeTours
dan BatchOptimizeTours
menggunakan pesan permintaan seperti
contoh di atas, tetapi dengan cara berbeda. Sebelum membuat permintaan Pengoptimalan
Rute, penting untuk memahami perbedaan antara kedua metode tersebut: