- Representasi JSON
- Pengiriman
- VisitRequest
- LatLng
- Waypoint
- Location
- TimeWindow
- Kendaraan
- TravelMode
- RouteModifiers
- UnloadingPolicy
- LoadLimit
- Interval
- DurationLimit
- DistanceLimit
- BreakRule
- BreakRequest
- FrequencyConstraint
- DurationDistanceMatrix
- Baris
- TransitionAttributes
- ShipmentTypeIncompatibility
- IncompatibilityMode
- ShipmentTypeRequirement
- RequirementMode
- PrecedenceRule
Model pengiriman berisi serangkaian pengiriman yang harus dilakukan oleh serangkaian kendaraan, sekaligus meminimalkan biaya keseluruhan, yang merupakan jumlah dari:
- biaya pemilihan rute kendaraan (jumlah biaya per total waktu, biaya per waktu perjalanan, dan biaya tetap untuk semua kendaraan).
- penalti pengiriman yang tidak dilakukan.
- biaya durasi global pengiriman
Representasi JSON |
---|
{ "shipments": [ { object ( |
Kolom | |
---|---|
shipments[] |
Kumpulan pengiriman yang harus dilakukan dalam model. |
vehicles[] |
Kumpulan kendaraan yang dapat digunakan untuk melakukan kunjungan. |
global |
Waktu mulai dan waktu berakhir global model: tidak ada waktu di luar rentang ini yang dapat dianggap valid. Rentang waktu model harus kurang dari satu tahun, yaitu Saat menggunakan kolom Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
global |
Jika tidak ditetapkan, 00:00:00 UTC, 1 Januari 1971 (yaitu detik: 31536000, nano: 0) akan digunakan sebagai default. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
global |
"Durasi global" dari keseluruhan rencana adalah perbedaan antara waktu mulai efektif paling awal dan waktu akhir efektif terbaru dari semua kendaraan. Pengguna dapat menetapkan biaya per jam untuk jumlah tersebut untuk mencoba dan mengoptimalkan penyelesaian tugas paling awal, misalnya. Biaya ini harus dalam unit yang sama dengan |
duration |
Menentukan matriks durasi dan jarak yang digunakan dalam model. Jika kolom ini kosong, Google Maps atau jarak geodesik akan digunakan, bergantung pada nilai kolom Contoh penggunaan:
|
duration |
Tag yang menentukan sumber matriks durasi dan jarak; Tag sesuai dengan |
duration |
Tag yang menentukan tujuan matriks durasi dan jarak; Tag sesuai dengan |
transition |
Atribut transisi ditambahkan ke model. |
shipment |
Kumpulan shipment_types yang tidak kompatibel (lihat |
shipment |
Kumpulan persyaratan |
precedence |
Kumpulan aturan prioritas yang harus diterapkan dalam model. |
max |
Membatasi jumlah maksimum kendaraan aktif. Kendaraan aktif jika rutenya melakukan setidaknya satu pengiriman. Hal ini dapat digunakan untuk membatasi jumlah rute jika jumlah pengemudi lebih sedikit daripada kendaraan dan armada kendaraan bersifat heterogen. Pengoptimalan kemudian akan memilih subset kendaraan terbaik yang akan digunakan. Harus benar-benar positif. |
Pengiriman
Pengiriman satu item, dari salah satu pengambilannya ke salah satu pengirimannya. Agar pengiriman dianggap telah dilakukan, kendaraan unik harus mengunjungi salah satu lokasi pengambilannya (dan mengurangi kapasitas cadangannya), lalu mengunjungi salah satu lokasi pengirimannya nanti (sehingga meningkatkan kembali kapasitas cadangannya).
Representasi JSON |
---|
{ "displayName": string, "pickups": [ { object ( |
Kolom | |
---|---|
display |
Nama tampilan pengiriman yang ditentukan pengguna. Panjangnya dapat mencapai 63 karakter dan dapat menggunakan karakter UTF-8. |
pickups[] |
Kumpulan alternatif pengambilan yang terkait dengan pengiriman. Jika tidak ditentukan, kendaraan hanya perlu mengunjungi lokasi yang sesuai dengan pengiriman. |
deliveries[] |
Kumpulan alternatif pengiriman yang terkait dengan pengiriman. Jika tidak ditentukan, kendaraan hanya perlu mengunjungi lokasi yang sesuai dengan pengambilan. |
load |
Permintaan muatan pengiriman (misalnya berat, volume, jumlah palet, dll.). Kunci dalam peta harus berupa ID yang menjelaskan jenis beban yang sesuai, idealnya juga menyertakan unit. Misalnya: "weight_kg", "volume_gallons", "pallet_count", dll. Jika kunci tertentu tidak muncul di peta, beban yang sesuai akan dianggap sebagai null. |
allowed |
Kumpulan kendaraan yang dapat melakukan pengiriman ini. Jika kosong, semua kendaraan dapat melakukannya. Kendaraan diberikan berdasarkan indeksnya dalam daftar |
costs |
Menentukan biaya yang dikeluarkan saat pengiriman ini dikirim oleh setiap kendaraan. Jika ditentukan, harus memiliki SALAH SATU:
Biaya ini harus dalam unit yang sama dengan |
costs |
Indeks kendaraan yang menerapkan |
pickup |
Menentukan waktu pengalihan absolut maksimum dibandingkan dengan jalur terpendek dari pengambilan ke pengiriman. Jika ditentukan, nilainya harus non-negatif, dan pengiriman harus berisi minimal pengambilan dan pengiriman. Misalnya, t adalah waktu terpendek yang diperlukan untuk berpindah dari alternatif pengambilan yang dipilih langsung ke alternatif pengiriman yang dipilih. Kemudian, setelan
Jika batas relatif dan absolut ditentukan pada pengiriman yang sama, batas yang lebih membatasi akan digunakan untuk setiap kemungkinan pasangan pengambilan/pengiriman. Mulai 10/2017, pengalihan hanya didukung jika durasi perjalanan tidak bergantung pada kendaraan. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
pickup |
Menentukan durasi maksimum dari awal pengambilan hingga awal pengiriman paket. Jika ditentukan, nilainya harus non-negatif, dan pengiriman harus berisi minimal pengambilan dan pengiriman. Hal ini tidak bergantung pada alternatif yang dipilih untuk pengambilan dan pengiriman, atau pada kecepatan kendaraan. Hal ini dapat ditentukan bersama dengan batasan pengalihan maksimum: solusi akan mematuhi kedua spesifikasi tersebut. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
shipment |
String yang tidak kosong yang menentukan "jenis" untuk pengiriman ini. Fitur ini dapat digunakan untuk menentukan inkompatibilitas atau persyaratan antara Berbeda dengan |
label |
Menentukan label untuk pengiriman ini. Label ini dilaporkan dalam respons di |
ignore |
Jika benar, lewati pengiriman ini, tetapi jangan terapkan Mengabaikan pengiriman akan menyebabkan error validasi jika ada Mengabaikan pengiriman yang dilakukan di |
penalty |
Jika pengiriman tidak selesai, penalti ini akan ditambahkan ke biaya keseluruhan rute. Pengiriman dianggap selesai jika salah satu alternatif pengambilan dan pengirimannya dikunjungi. Biaya dapat dinyatakan dalam unit yang sama yang digunakan untuk semua kolom terkait biaya lainnya dalam model dan harus positif. PENTING: Jika tidak ditentukan, penalti ini dianggap tidak terbatas, yaitu pengiriman harus diselesaikan. |
pickup |
Menentukan waktu pengalihan relatif maksimum dibandingkan dengan jalur terpendek dari pengambilan ke pengiriman. Jika ditentukan, nilainya harus non-negatif, dan pengiriman harus berisi minimal pengambilan dan pengiriman. Misalnya, t adalah waktu terpendek yang diperlukan untuk berpindah dari alternatif pengambilan yang dipilih langsung ke alternatif pengiriman yang dipilih. Kemudian, setelan
Jika batas relatif dan absolut ditentukan pada pengiriman yang sama, batas yang lebih membatasi akan digunakan untuk setiap kemungkinan pasangan pengambilan/pengiriman. Mulai 10/2017, pengalihan hanya didukung jika durasi perjalanan tidak bergantung pada kendaraan. |
VisitRequest
Permintaan kunjungan yang dapat dilakukan oleh kendaraan: memiliki geolokasi (atau dua, lihat di bawah), waktu buka dan tutup yang diwakili oleh periode waktu, dan waktu durasi layanan (waktu yang dihabiskan oleh kendaraan setelah tiba untuk mengambil atau mengantar barang).
Representasi JSON |
---|
{ "arrivalLocation": { object ( |
Kolom | |
---|---|
arrival |
Geolokasi tempat kendaraan tiba saat melakukan |
arrival |
Titik jalan tempat kendaraan tiba saat melakukan |
departure |
Geolokasi tempat kendaraan berangkat setelah menyelesaikan |
departure |
Titik jalan tempat kendaraan berangkat setelah menyelesaikan |
tags[] |
Menentukan tag yang dilampirkan ke permintaan kunjungan. String kosong atau duplikat tidak diizinkan. |
time |
Periode waktu yang membatasi waktu kedatangan pada kunjungan. Perhatikan bahwa kendaraan dapat berangkat di luar periode waktu kedatangan, yaitu waktu kedatangan + durasi tidak perlu berada dalam periode waktu. Hal ini dapat menyebabkan waktu tunggu jika kendaraan tiba sebelum Tidak adanya Periode waktu harus terpisah, yaitu tidak ada periode waktu yang tumpang-tindih atau berdekatan dengan periode waktu lain, dan periode waktu tersebut harus dalam urutan yang meningkat.
|
duration |
Durasi kunjungan, yaitu waktu yang dihabiskan kendaraan antara kedatangan dan keberangkatan (akan ditambahkan ke kemungkinan waktu tunggu; lihat Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
cost |
Biaya untuk melayani permintaan kunjungan ini di rute kendaraan. Hal ini dapat digunakan untuk membayar biaya yang berbeda untuk setiap pengambilan atau pengiriman alternatif. Biaya ini harus dalam unit yang sama dengan |
load |
Memuat permintaan kunjungan ini. Kolom ini sama seperti kolom |
visit |
Menentukan jenis kunjungan. Ini dapat digunakan untuk mengalokasikan waktu tambahan yang diperlukan kendaraan untuk menyelesaikan kunjungan ini (lihat Jenis hanya dapat muncul sekali. |
label |
Menentukan label untuk |
LatLng
Objek yang merepresentasikan pasangan garis lintang/bujur. Ini dinyatakan sebagai pasangan nilai ganda untuk mewakili derajat lintang dan derajat bujur. Kecuali ditentukan lain, objek ini harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.
Representasi JSON |
---|
{ "latitude": number, "longitude": number } |
Kolom | |
---|---|
latitude |
Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0]. |
longitude |
Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0]. |
Waypoint
Mengenkapsulasi titik jalan. Titik jalan menandai lokasi kedatangan dan keberangkatan VisitRequests, serta lokasi awal dan akhir Kendaraan.
Representasi JSON |
---|
{ "sideOfRoad": boolean, // Union field |
Kolom | |
---|---|
side |
Opsional. Menunjukkan bahwa lokasi titik jalan ini dimaksudkan untuk memiliki preferensi agar kendaraan berhenti di sisi jalan tertentu. Saat Anda menetapkan nilai ini, rute akan melewati lokasi sehingga kendaraan dapat berhenti di sisi jalan yang dituju lokasi dari tengah jalan. Opsi ini tidak berfungsi untuk mode perjalanan 'BERJALAN KAKI'. |
Kolom union location_type . Berbagai cara untuk merepresentasikan lokasi. location_type hanya dapat berupa salah satu dari berikut: |
|
location |
Titik yang ditentukan menggunakan koordinat geografis, termasuk judul opsional. |
place |
ID Tempat POI yang terkait dengan titik jalan. |
Lokasi
Mengenkapsulasi lokasi (titik geografis, dan judul opsional).
Representasi JSON |
---|
{
"latLng": {
object ( |
Kolom | |
---|---|
lat |
Koordinat geografis titik jalan. |
heading |
Arah kompas yang terkait dengan arah aliran traffic. Nilai ini digunakan untuk menentukan sisi jalan yang akan digunakan untuk pengambilan dan pengantaran. Nilai arah dapat berkisar dari 0 hingga 360, dengan 0 menentukan arah utara, 90 menentukan arah timur, dll. |
TimeWindow
Periode waktu membatasi waktu peristiwa, seperti waktu kedatangan pada kunjungan, atau waktu mulai dan berakhir kendaraan.
Batas jangka waktu hard, startTime
dan endTime
, menerapkan waktu paling awal dan paling akhir peristiwa, sehingga startTime <= event_time <=
endTime
. Batas bawah periode waktu soft, softStartTime
, menyatakan preferensi agar peristiwa terjadi pada atau setelah softStartTime
dengan menimbulkan biaya yang sebanding dengan berapa lama sebelum softStartTime peristiwa terjadi. Batas atas periode waktu soft, softEndTime
, menyatakan preferensi agar peristiwa terjadi pada atau sebelum softEndTime
dengan menimbulkan biaya yang sebanding dengan berapa lama setelah softEndTime
peristiwa terjadi. startTime
, endTime
, softStartTime
, dan softEndTime
harus berada dalam batas waktu global (lihat ShipmentModel.global_start_time
dan ShipmentModel.global_end_time
) dan harus mematuhi:
0 <= `startTime` <= `endTime` and
0 <= `startTime` <= `softStartTime` and
0 <= `softEndTime` <= `endTime`.
Representasi JSON |
---|
{ "startTime": string, "endTime": string, "softStartTime": string, "softEndTime": string, "costPerHourBeforeSoftStartTime": number, "costPerHourAfterSoftEndTime": number } |
Kolom | |
---|---|
start |
Waktu mulai periode waktu yang ketat. Jika tidak ditentukan, nilainya akan ditetapkan ke Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
end |
Waktu berakhir periode waktu yang ketat. Jika tidak ditentukan, nilainya akan ditetapkan ke Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
soft |
Waktu mulai lembut periode waktu. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
soft |
Waktu akhir tidak pasti untuk periode waktu. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
cost |
Biaya per jam ditambahkan ke biaya lain dalam model jika peristiwa terjadi sebelum softStartTime, yang dihitung sebagai:
Biaya ini harus positif, dan kolom ini hanya dapat ditetapkan jika softStartTime telah ditetapkan. |
cost |
Biaya per jam yang ditambahkan ke biaya lain dalam model jika peristiwa terjadi setelah
Biaya ini harus positif, dan kolom hanya dapat ditetapkan jika |
Kendaraan
Membuat model kendaraan dalam masalah pengiriman. Memecahkan masalah pengiriman akan membuat rute yang dimulai dari startLocation
dan berakhir di endLocation
untuk kendaraan ini. Rute adalah urutan kunjungan (lihat ShipmentRoute
).
Representasi JSON |
---|
{ "displayName": string, "travelMode": enum ( |
Kolom | |
---|---|
display |
Nama tampilan kendaraan yang ditentukan pengguna. Panjangnya dapat mencapai 63 karakter dan dapat menggunakan karakter UTF-8. |
travel |
Mode perjalanan yang memengaruhi jalan yang dapat digunakan oleh kendaraan dan kecepatannya. Lihat juga |
route |
Kumpulan kondisi yang harus dipenuhi yang memengaruhi cara rute dihitung untuk kendaraan tertentu. |
start |
Lokasi geografis tempat kendaraan memulai perjalanan sebelum mengambil kiriman. Jika tidak ditentukan, kendaraan akan dimulai pada pengambilan pertamanya. Jika model pengiriman memiliki matriks durasi dan jarak, |
start |
Titik jalan yang mewakili lokasi geografis tempat kendaraan memulai perjalanan sebelum mengambil pengiriman apa pun. Jika |
end |
Lokasi geografis tempat kendaraan berakhir setelah menyelesaikan |
end |
Titik jalan yang mewakili lokasi geografis tempat kendaraan berakhir setelah menyelesaikan |
start |
Menentukan tag yang dilampirkan ke awal rute kendaraan. String kosong atau duplikat tidak diizinkan. |
end |
Menentukan tag yang dilampirkan ke akhir rute kendaraan. String kosong atau duplikat tidak diizinkan. |
start |
Periode waktu saat kendaraan dapat berangkat dari lokasi awalnya. Nilai ini harus berada dalam batas waktu global (lihat kolom Periode waktu yang termasuk dalam kolom berulang yang sama harus terpisah, yaitu tidak ada periode waktu yang dapat tumpang-tindih atau berdekatan dengan periode waktu lain, dan periode waktu tersebut harus dalam urutan kronologis.
|
end |
Jangka waktu saat kendaraan dapat tiba di lokasi akhirnya. Nilai ini harus berada dalam batas waktu global (lihat kolom Periode waktu yang termasuk dalam kolom berulang yang sama harus terpisah, yaitu tidak ada periode waktu yang dapat tumpang-tindih atau berdekatan dengan periode waktu lain, dan periode waktu tersebut harus dalam urutan kronologis.
|
unloading |
Kebijakan pemuatan diterapkan pada kendaraan. |
load |
Kapasitas kendaraan (misalnya, berat, volume, jumlah palet). Kunci dalam peta adalah ID jenis pemuatan, yang konsisten dengan kunci kolom |
cost |
Biaya kendaraan: semua biaya dijumlahkan dan harus dalam unit yang sama dengan Biaya per jam rute kendaraan. Biaya ini diterapkan ke total waktu yang diperlukan untuk rute, dan mencakup waktu perjalanan, waktu tunggu, dan waktu kunjungan. Menggunakan |
cost |
Biaya per jam perjalanan rute kendaraan. Biaya ini hanya diterapkan untuk waktu perjalanan yang ditempuh oleh rute (yaitu, yang dilaporkan di |
cost |
Biaya per kilometer rute kendaraan. Biaya ini diterapkan ke jarak yang dilaporkan di |
fixed |
Biaya tetap diterapkan jika kendaraan ini digunakan untuk menangani pengiriman. |
used |
Kolom ini hanya berlaku untuk kendaraan jika rutenya tidak melayani pengiriman apa pun. Dalam hal ini, kolom ini menunjukkan apakah kendaraan harus dianggap sebagai bekas atau tidak. Jika benar, kendaraan akan pergi dari lokasi awal ke lokasi akhir meskipun tidak melayani pengiriman apa pun, dan biaya waktu dan jarak yang dihasilkan dari perjalanan awal --> akhir akan diperhitungkan. Jika tidak, kendaraan tidak akan melakukan perjalanan dari lokasi awal ke lokasi akhir, dan tidak ada |
route |
Batas yang diterapkan pada total durasi rute kendaraan. Dalam |
travel |
Batas yang diterapkan pada durasi perjalanan rute kendaraan. Dalam |
route |
Batas yang diterapkan pada total jarak rute kendaraan. Dalam |
extra |
Menentukan peta dari string visitTypes ke durasi. Durasi adalah waktu selain Jika permintaan kunjungan memiliki beberapa jenis, durasi akan ditambahkan untuk setiap jenis di peta. |
break |
Menjelaskan jadwal istirahat yang akan diterapkan pada kendaraan ini. Jika kosong, tidak ada istirahat yang akan dijadwalkan untuk kendaraan ini. |
label |
Menentukan label untuk kendaraan ini. Label ini dilaporkan dalam respons sebagai |
ignore |
Jika benar, Jika pengiriman dilakukan oleh kendaraan yang diabaikan di Jika pengiriman dilakukan oleh kendaraan yang diabaikan di |
travel |
Menentukan faktor perkalian yang dapat digunakan untuk meningkatkan atau mengurangi waktu perjalanan kendaraan ini. Misalnya, menetapkannya ke 2,0 berarti kendaraan ini lebih lambat dan memiliki waktu perjalanan dua kali lipat dari kendaraan standar. Pengganda ini tidak memengaruhi durasi kunjungan. Hal ini memengaruhi biaya jika PERINGATAN: Waktu perjalanan akan dibulatkan ke detik terdekat setelah kelipatan ini diterapkan, tetapi sebelum melakukan operasi numerik apa pun. Oleh karena itu, kelipatan kecil dapat menyebabkan hilangnya presisi. Lihat juga |
TravelMode
Mode perjalanan yang dapat digunakan oleh kendaraan.
Mode perjalanan ini harus merupakan subkumpulan dari mode perjalanan Rute Pilihan API Google Maps Platform, lihat: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/Shared.Types/RouteTravelMode.
Enum | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
Mode perjalanan tidak ditentukan, setara dengan DRIVING . |
DRIVING |
Mode perjalanan yang sesuai dengan rute mobil (mobil, ...). |
WALKING |
Mode perjalanan yang sesuai dengan rute jalan kaki. |
RouteModifiers
Mengenkapsulasi serangkaian kondisi opsional yang harus dipenuhi saat menghitung rute kendaraan. Hal ini mirip dengan RouteModifiers
di Routes Preferred API Google Maps Platform; lihat: https://developers.google.com/maps/documentation/routes/reference/rest/v2/RouteModifiers.
Representasi JSON |
---|
{ "avoidTolls": boolean, "avoidHighways": boolean, "avoidFerries": boolean, "avoidIndoor": boolean } |
Kolom | |
---|---|
avoid |
Menentukan apakah akan menghindari jalan tol jika memungkinkan. Preferensi akan diberikan ke rute yang tidak berisi jalan tol. Hanya berlaku untuk mode perjalanan bermotor. |
avoid |
Menentukan apakah akan menghindari jalan raya jika memungkinkan. Preferensi akan diberikan ke rute yang tidak berisi jalan raya. Hanya berlaku untuk mode perjalanan bermotor. |
avoid |
Menentukan apakah akan menghindari feri jika memungkinkan. Preferensi akan diberikan ke rute yang tidak berisi perjalanan dengan feri. Hanya berlaku untuk mode perjalanan bermotor. |
avoid |
Opsional. Menentukan apakah akan menghindari navigasi di dalam ruangan jika memungkinkan. Preferensi akan diberikan ke rute yang tidak berisi navigasi dalam ruangan. Hanya berlaku untuk mode perjalanan |
UnloadingPolicy
Kebijakan tentang cara kendaraan dapat dibongkar muatannya. Hanya berlaku untuk pengiriman yang memiliki pengambilan dan pengiriman.
Pengiriman lainnya dapat terjadi di mana saja di rute, terlepas dari unloadingPolicy
.
Enum | |
---|---|
UNLOADING_POLICY_UNSPECIFIED |
Kebijakan pembongkaran yang tidak ditentukan; pengiriman hanya boleh dilakukan setelah pengambilan yang sesuai. |
LAST_IN_FIRST_OUT |
Pengiriman harus dilakukan dalam urutan terbalik dari pengambilan |
FIRST_IN_FIRST_OUT |
Pengiriman harus dilakukan dalam urutan yang sama dengan pengambilan |
LoadLimit
Menentukan batas muatan yang berlaku untuk kendaraan, misalnya "truk ini hanya boleh mengangkut hingga 3.500 kg". Lihat loadLimits
.
Representasi JSON |
---|
{ "softMaxLoad": string, "costPerUnitAboveSoftMax": number, "startLoadInterval": { object ( |
Kolom | |
---|---|
soft |
Batas beban yang dapat dilewati. Lihat |
cost |
Jika beban pernah melebihi |
start |
Interval muatan kendaraan yang dapat diterima di awal rute. |
end |
Interval muatan kendaraan yang dapat diterima di akhir rute. |
max |
Jumlah beban maksimum yang dapat diterima. |
Interval
Interval jumlah beban yang dapat diterima.
Representasi JSON |
---|
{ "min": string, "max": string } |
Kolom | |
---|---|
min |
Beban minimum yang dapat diterima. Harus ≥ 0. Jika keduanya ditentukan, |
max |
Muatan maksimum yang dapat diterima. Harus ≥ 0. Jika tidak ditentukan, beban maksimum tidak dibatasi oleh pesan ini. Jika keduanya ditentukan, |
DurationLimit
Batas yang menentukan durasi maksimum rute kendaraan. Dapat berupa keras atau lembut.
Saat kolom batas lunak ditentukan, nilai minimum maksimum lunak dan biaya terkaitnya harus ditentukan bersama.
Representasi JSON |
---|
{ "maxDuration": string, "softMaxDuration": string, "quadraticSoftMaxDuration": string, "costPerHourAfterSoftMax": number, "costPerSquareHourAfterQuadraticSoftMax": number } |
Kolom | |
---|---|
max |
Batas keras yang membatasi durasi maksimal maxDuration. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
soft |
Batas yang dapat dilewati tidak menerapkan batas durasi maksimum, tetapi jika dilanggar akan membuat rute dikenai biaya. Biaya ini ditambahkan ke biaya lain yang ditentukan dalam model, dengan unit yang sama. Jika ditentukan, Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
quadratic |
Batas yang dapat dilewati tidak menerapkan batas durasi maksimum, tetapi jika dilanggar akan membuat rute dikenai biaya, kuadrat dalam durasi. Biaya ini ditambahkan ke biaya lain yang ditentukan dalam model, dengan unit yang sama. Jika ditentukan,
Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
cost |
Biaya per jam yang dikenakan jika nilai minimum
Biaya tidak boleh negatif. |
cost |
Biaya per jam persegi yang dikenakan jika nilai minimum Biaya tambahan adalah 0 jika durasi berada di bawah nilai minimum, jika tidak, biayanya bergantung pada durasi sebagai berikut:
Biaya tidak boleh negatif. |
DistanceLimit
Batas yang menentukan jarak maksimum yang dapat ditempuh. Dapat berupa keras atau lembut.
Jika batas lunak ditentukan, softMaxMeters
dan costPerKilometerAboveSoftMax
harus ditentukan dan tidak boleh negatif.
Representasi JSON |
---|
{ "maxMeters": string, "softMaxMeters": string, "costPerKilometerBelowSoftMax": number, "costPerKilometerAboveSoftMax": number } |
Kolom | |
---|---|
max |
Batas keras yang membatasi jarak maksimal maxMeters. Batas tidak boleh negatif. |
soft |
Batas yang dapat dilewati tidak menerapkan batas jarak maksimum, tetapi jika dilanggar akan menghasilkan biaya yang ditambahkan ke biaya lain yang ditentukan dalam model, dengan unit yang sama. Jika ditentukan, softMaxMeters harus kurang dari maxMeters dan tidak boleh bernilai negatif. |
cost |
Biaya per kilometer yang dikeluarkan, meningkat hingga
Biaya ini tidak didukung di |
cost |
Biaya per kilometer yang dikenakan jika jarak melebihi batas
Biaya tidak boleh negatif. |
BreakRule
Aturan untuk membuat jeda waktu bagi kendaraan (misalnya istirahat makan siang). Jeda adalah periode waktu yang berurutan selama kendaraan tetap tidak ada aktivitas di posisinya saat ini dan tidak dapat melakukan kunjungan apa pun. Jeda dapat terjadi:
- selama perjalanan antara dua kunjungan (yang mencakup waktu tepat sebelum atau tepat setelah kunjungan, tetapi tidak di tengah kunjungan), dalam hal ini, waktu transit yang sesuai antara kunjungan akan diperpanjang,
- atau sebelum kendaraan mulai (kendaraan mungkin tidak mulai di tengah jeda), dalam hal ini tidak akan memengaruhi waktu mulai kendaraan.
- atau setelah akhir kendaraan (sama, dengan waktu akhir kendaraan).
Representasi JSON |
---|
{ "breakRequests": [ { object ( |
Kolom | |
---|---|
break |
Urutan jeda. Lihat pesan |
frequency |
Beberapa |
BreakRequest
Urutan istirahat (yaitu jumlah dan urutannya) yang berlaku untuk setiap kendaraan harus diketahui sebelumnya. BreakRequest
berulang menentukan urutan tersebut, dalam urutan yang harus terjadi. Periode waktunya (earliestStartTime
/ latestStartTime
) dapat tumpang-tindih, tetapi harus kompatibel dengan urutan (ini diperiksa).
Representasi JSON |
---|
{ "earliestStartTime": string, "latestStartTime": string, "minDuration": string } |
Kolom | |
---|---|
earliest |
Wajib. Batas bawah (inklusif) pada awal jeda. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
latest |
Wajib. Batas atas (inklusif) pada awal jeda. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
min |
Wajib. Durasi minimum jeda iklan. Harus positif. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
FrequencyConstraint
Anda dapat lebih membatasi frekuensi dan durasi jeda yang ditentukan di atas, dengan menerapkan frekuensi jeda minimum, seperti "Harus ada jeda minimal 1 jam setiap 12 jam". Dengan asumsi bahwa ini dapat ditafsirkan sebagai "Dalam periode waktu geser 12 jam, harus ada setidaknya satu jeda selama minimal satu jam", contoh tersebut akan diterjemahkan menjadi FrequencyConstraint
berikut:
{
minBreakDuration { seconds: 3600 } # 1 hour.
maxInterBreakDuration { seconds: 39600 } # 11 hours (12 - 1 = 11).
}
Waktu dan durasi jeda dalam solusi akan mematuhi semua batasan tersebut, selain periode waktu dan durasi minimum yang telah ditentukan di BreakRequest
.
Dalam praktiknya, FrequencyConstraint
dapat diterapkan untuk jeda yang tidak berurutan. Misalnya, jadwal berikut mengikuti contoh "1 jam setiap 12 jam":
04:00 vehicle start
.. performing travel and visits ..
09:00 1 hour break
10:00 end of the break
.. performing travel and visits ..
12:00 20-min lunch break
12:20 end of the break
.. performing travel and visits ..
21:00 1 hour break
22:00 end of the break
.. performing travel and visits ..
23:59 vehicle end
Representasi JSON |
---|
{ "minBreakDuration": string, "maxInterBreakDuration": string } |
Kolom | |
---|---|
min |
Wajib. Durasi jeda minimum untuk batasan ini. Non-negatif. Lihat deskripsi Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
max |
Wajib. Rentang maksimum interval waktu yang diizinkan di rute yang tidak menyertakan setidaknya sebagian jeda Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
DurationDistanceMatrix
Menentukan matriks durasi dan jarak dari lokasi awal kunjungan dan kendaraan ke lokasi akhir kunjungan dan kendaraan.
Representasi JSON |
---|
{
"rows": [
{
object ( |
Kolom | |
---|---|
rows[] |
Menentukan baris matriks durasi dan jarak. Elemennya harus sama banyak dengan |
vehicle |
Tag yang menentukan kendaraan mana yang menerapkan matriks jarak dan durasi ini. Jika kosong, ini berlaku untuk semua kendaraan, dan hanya boleh ada satu matriks. Setiap awal kendaraan harus sama persis dengan satu matriks, yaitu hanya satu kolom Semua matriks harus memiliki |
Baris
Menentukan baris matriks durasi dan jarak.
Representasi JSON |
---|
{ "durations": [ string ], "meters": [ number ] } |
Kolom | |
---|---|
durations[] |
Nilai durasi untuk baris tertentu. Elemennya harus sama banyak dengan Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
meters[] |
Nilai jarak untuk baris tertentu. Jika tidak ada biaya atau batasan yang merujuk pada jarak dalam model, kolom ini dapat dibiarkan kosong; jika tidak, kolom ini harus memiliki elemen sebanyak |
TransitionAttributes
Menentukan atribut transisi antara dua kunjungan berturut-turut di rute. Beberapa TransitionAttributes
dapat berlaku untuk transisi yang sama: dalam hal ini, semua biaya tambahan akan ditambahkan dan batasan atau batas yang paling ketat akan berlaku (mengikuti semantik "AND" alami).
Representasi JSON |
---|
{
"srcTag": string,
"excludedSrcTag": string,
"dstTag": string,
"excludedDstTag": string,
"cost": number,
"costPerKilometer": number,
"distanceLimit": {
object ( |
Kolom | |
---|---|
src |
Tag yang menentukan kumpulan transisi (src->dst) yang berlaku untuk atribut ini. Kunjungan sumber atau awal kendaraan cocok jika |
excluded |
Lihat |
dst |
Kunjungan tujuan atau akhir kendaraan cocok jika |
excluded |
Lihat |
cost |
Menentukan biaya untuk melakukan transisi ini. Nilai ini dalam unit yang sama dengan semua biaya lainnya dalam model dan tidak boleh negatif. Biaya ini diterapkan di atas semua biaya lain yang sudah ada. |
cost |
Menentukan biaya per kilometer yang diterapkan ke jarak yang ditempuh saat melakukan transisi ini. Jumlah ini ditambahkan ke |
distance |
Menentukan batas jarak yang ditempuh saat melakukan transisi ini. Mulai 06/2021, hanya batas lunak yang didukung. |
delay |
Menentukan penundaan yang terjadi saat melakukan transisi ini. Penundaan ini selalu terjadi setelah menyelesaikan kunjungan sumber dan sebelum memulai kunjungan tujuan. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
ShipmentTypeIncompatibility
Menentukan ketidakcocokan antara pengiriman, bergantung pada shipmentType-nya. Tampilan pengiriman yang tidak kompatibel di rute yang sama dibatasi berdasarkan mode inkompatibilitas.
Representasi JSON |
---|
{
"types": [
string
],
"incompatibilityMode": enum ( |
Kolom | |
---|---|
types[] |
Daftar jenis yang tidak kompatibel. Dua pengiriman yang memiliki |
incompatibility |
Mode yang diterapkan pada inkompatibilitas. |
IncompatibilityMode
Mode yang menentukan cara pembatasan tampilan pengiriman yang tidak kompatibel di rute yang sama.
Enum | |
---|---|
INCOMPATIBILITY_MODE_UNSPECIFIED |
Mode inkompatibilitas tidak ditentukan. Nilai ini tidak boleh digunakan. |
NOT_PERFORMED_BY_SAME_VEHICLE |
Dalam mode ini, dua pengiriman dengan jenis yang tidak kompatibel tidak akan pernah dapat menggunakan kendaraan yang sama. |
NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY |
Untuk dua pengiriman dengan jenis yang tidak kompatibel dengan mode inkompatibilitas
|
ShipmentTypeRequirement
Menentukan persyaratan antara pengiriman berdasarkan shipmentType-nya. Detail persyaratan ditentukan oleh mode persyaratan.
Representasi JSON |
---|
{
"requiredShipmentTypeAlternatives": [
string
],
"dependentShipmentTypes": [
string
],
"requirementMode": enum ( |
Kolom | |
---|---|
required |
Daftar jenis pengiriman alternatif yang diperlukan oleh |
dependent |
Semua pengiriman dengan jenis di kolom CATATAN: Rantai persyaratan sehingga |
requirement |
Mode yang diterapkan ke persyaratan. |
RequirementMode
Mode yang menentukan tampilan pengiriman dependen di rute.
Enum | |
---|---|
REQUIREMENT_MODE_UNSPECIFIED |
Mode persyaratan tidak ditentukan. Nilai ini tidak boleh digunakan. |
PERFORMED_BY_SAME_VEHICLE |
Dalam mode ini, semua pengiriman "tergantung" harus menggunakan kendaraan yang sama dengan setidaknya satu pengiriman "wajib". |
IN_SAME_VEHICLE_AT_PICKUP_TIME |
Dengan mode Oleh karena itu, pengambilan paket "tergantung" harus memiliki:
|
IN_SAME_VEHICLE_AT_DELIVERY_TIME |
Sama seperti sebelumnya, kecuali pengiriman "tergantung" harus memiliki pengiriman "wajib" di kendaraannya pada saat pengiriman. |
PrecedenceRule
Aturan prioritas antara dua peristiwa (setiap peristiwa adalah pengambilan atau pengiriman paket): peristiwa "kedua" harus dimulai minimal offsetDuration
setelah peristiwa "pertama" dimulai.
Beberapa prioritas dapat merujuk ke peristiwa yang sama (atau terkait), misalnya, "pengambilan B terjadi setelah pengiriman A" dan "pengambilan C terjadi setelah pengambilan B".
Selain itu, prioritas hanya berlaku jika kedua pengiriman dilakukan dan diabaikan jika tidak.
Representasi JSON |
---|
{ "firstIsDelivery": boolean, "secondIsDelivery": boolean, "offsetDuration": string, "firstIndex": integer, "secondIndex": integer } |
Kolom | |
---|---|
first |
Menunjukkan apakah peristiwa "pertama" adalah pengiriman. |
second |
Menunjukkan apakah peristiwa "kedua" adalah pengiriman. |
offset |
Offset antara peristiwa "pertama" dan "kedua". Nilainya dapat negatif. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
first |
Indeks pengiriman peristiwa "pertama". Kolom ini harus ditentukan. |
second |
Indeks pengiriman peristiwa "kedua". Kolom ini harus ditentukan. |