- Representasi JSON
- Pengiriman
- VisitRequest
- LatLng
- Titik jalan
- Location
- TimeWindow
- Kendaraan
- TravelMode
- UnloadingPolicy
- LoadLimit
- Interval
- DurationLimit
- DistanceLimit
- BreakRule
- BreakRequest
- FrequencyConstraint
- DurationDistanceMatrix
- Baris
- TransitionAttributes
- ShipmentTypeIncompatibility
- IncompatibilityMode
- ShipmentTypeRequirement
- RequirementMode
- PrecedenceRule
Model pengiriman berisi satu set pengiriman yang harus dilakukan oleh serangkaian kendaraan, sekaligus meminimalkan biaya keseluruhan, yang merupakan penjumlahan dari:
- biaya perutean kendaraan (jumlah biaya per total waktu, biaya per waktu perjalanan, dan biaya tetap untuk semua kendaraan).
- penalti pengiriman yang tidak dilakukan.
- biaya durasi pengiriman global
Representasi JSON |
---|
{ "shipments": [ { object ( |
Kolom | |
---|---|
shipments[] |
Rangkaian pengiriman yang harus dilakukan dalam model. |
vehicles[] |
Kumpulan kendaraan yang dapat digunakan untuk melakukan kunjungan. |
globalStartTime |
Waktu mulai dan berakhir global untuk 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 RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
globalEndTime |
Jika tidak disetel, 00:00:00 UTC, 1 Januari 1971 (yaitu detik: 31536000, nanos: 0) akan digunakan sebagai default. Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
globalDurationCostPerHour |
"Durasi global" dari keseluruhan rencana adalah perbedaan antara waktu mulai efektif paling awal dan waktu berakhir efektif terbaru untuk semua kendaraan. Misalnya, pengguna dapat menetapkan biaya per jam ke kuantitas tersebut untuk mencoba dan mengoptimalkan penyelesaian pekerjaan paling awal. Biaya ini harus dalam unit yang sama dengan |
durationDistanceMatrices[] |
Menentukan matriks durasi dan jarak yang digunakan dalam model. Jika kolom ini kosong, jarak Google Maps atau geodesi akan digunakan, bergantung pada nilai kolom Contoh penggunaan:
|
durationDistanceMatrixSrcTags[] |
Tag yang menentukan sumber matriks durasi dan jarak; Tag sesuai dengan |
durationDistanceMatrixDstTags[] |
Tag yang menentukan tujuan matriks durasi dan jarak; Tag sesuai dengan |
transitionAttributes[] |
Atribut transisi ditambahkan ke model. |
shipmentTypeIncompatibilities[] |
Kumpulan Shipping_types yang tidak kompatibel (lihat |
shipmentTypeRequirements[] |
Kumpulan persyaratan |
precedenceRules[] |
Kumpulan aturan prioritas yang harus diterapkan di model. |
maxActiveVehicles |
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 multi-penumpang. Pengoptimalan tersebut 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 dilaksanakan, kendaraan unik harus mengunjungi salah satu lokasi pengambilannya (dan mengurangi kapasitas cadangannya), lalu mengunjungi salah satu lokasi pengirimannya nanti (dan karenanya meningkatkan kembali kapasitas cadangannya).
Representasi JSON |
---|
{ "displayName": string, "pickups": [ { object ( |
Kolom | |
---|---|
displayName |
Nama tampilan pengiriman yang ditetapkan oleh pengguna. Panjang maksimal 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 penjemputan. |
loadDemands |
Pemuatan permintaan pengiriman (misalnya berat, volume, jumlah palet, dll.). Kunci dalam peta harus berupa ID yang menjelaskan jenis beban yang sesuai, idealnya juga termasuk unitnya. Misalnya: "weight_kg", "volume_gallons", "pallet_count", dll. Jika kunci tertentu tidak muncul di peta, beban yang terkait akan dianggap sebagai null. Objek yang berisi daftar pasangan |
allowedVehicleIndices[] |
Kumpulan kendaraan yang dapat melakukan pengiriman ini. Jika kosong, semua kendaraan dapat menjalankannya. Kendaraan diberikan berdasarkan indeksnya di daftar |
costsPerVehicle[] |
Menentukan biaya yang dikeluarkan saat pengiriman ini dikirimkan oleh setiap kendaraan. Jika ditentukan, kolom harus memiliki EITHER:
Biaya ini harus berada dalam unit yang sama dengan |
costsPerVehicleIndices[] |
Indeks kendaraan yang menerapkan |
pickupToDeliveryAbsoluteDetourLimit |
Menentukan waktu putar balik absolut maksimum dibandingkan dengan jalur terpendek dari pengambilan ke pengiriman. Jika ditentukan, nilainya harus positif, dan pengiriman harus berisi setidaknya opsi pengambilan dan pengantaran. Misalnya, anggaplah waktu tersingkat untuk beralih dari alternatif pengambilan yang dipilih langsung ke alternatif pengiriman yang dipilih. Kemudian, menyetel
Jika batas relatif dan absolut ditentukan pada pengiriman yang sama, batas yang lebih membatasi akan digunakan untuk setiap kemungkinan pasangan pengambilan/pengiriman. Mulai tahun 2017/10, putar balik hanya didukung jika durasi perjalanan tidak bergantung pada kendaraan. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
pickupToDeliveryTimeLimit |
Menentukan durasi maksimum dari awal pengambilan hingga awal pengiriman pengiriman. Jika ditentukan, nilainya harus positif, dan pengiriman harus berisi setidaknya opsi pengambilan dan pengantaran. Hal ini tidak bergantung pada alternatif mana yang dipilih untuk pengambilan dan pengantaran, atau kecepatan kendaraan. Hal ini dapat ditentukan bersama batasan maksimum pengalihan: solusi akan mengikuti kedua spesifikasi tersebut. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
shipmentType |
String yang tidak kosong yang menentukan "jenis" untuk pengiriman ini. Fitur ini dapat digunakan untuk menentukan inkompatibilitas atau persyaratan antara Berbeda dari |
label |
Menentukan label untuk pengiriman ini. Label ini dilaporkan dalam respons dalam |
ignore |
Jika benar, lewati pengiriman ini, tetapi jangan terapkan Mengabaikan pengiriman menyebabkan error validasi jika ada Mengabaikan pengiriman yang dilakukan di |
penaltyCost |
Jika pengiriman tidak selesai, penalti ini akan ditambahkan ke biaya keseluruhan rute. Pengiriman dianggap selesai jika salah satu alternatif pengambilan dan pengantaran dikunjungi. Biaya dapat dinyatakan dalam unit yang sama yang digunakan untuk semua kolom terkait biaya lainnya dalam model dan harus bernilai positif. PENTING: Jika penalti ini tidak ditentukan, maka akan dianggap tidak terbatas, yaitu pengiriman harus diselesaikan. |
pickupToDeliveryRelativeDetourLimit |
Menentukan waktu putar balik relatif maksimum dibandingkan dengan jalur terpendek dari pengambilan ke pengiriman. Jika ditentukan, nilainya harus positif, dan pengiriman harus berisi setidaknya opsi pengambilan dan pengantaran. Misalnya, anggaplah waktu tersingkat untuk beralih dari alternatif pengambilan yang dipilih langsung ke alternatif pengiriman yang dipilih. Kemudian, menyetel
Jika batas relatif dan absolut ditentukan pada pengiriman yang sama, batas yang lebih membatasi akan digunakan untuk setiap kemungkinan pasangan pengambilan/pengiriman. Mulai tahun 2017/10, putar balik hanya didukung jika durasi perjalanan tidak bergantung pada kendaraan. |
VisitRequest
Permintaan kunjungan yang dapat dilakukan dengan kendaraan: memiliki lokasi geografis (atau dua, lihat di bawah), jam buka dan tutup yang diwakili oleh jangka waktu, dan waktu durasi layanan (waktu yang dihabiskan oleh kendaraan setelah kendaraan tiba untuk mengambil atau mengembalikan barang).
Representasi JSON |
---|
{ "arrivalLocation": { object ( |
Kolom | |
---|---|
arrivalLocation |
Geo-lokasi tempat kendaraan tiba saat melakukan |
arrivalWaypoint |
Titik jalan tempat kendaraan tiba saat melakukan |
departureLocation |
Geo-lokasi tempat kendaraan berangkat setelah menyelesaikan |
departureWaypoint |
Titik jalan tempat kendaraan berangkat setelah menyelesaikan |
tags[] |
Menentukan tag yang disertakan ke permintaan kunjungan. String kosong atau duplikat tidak diizinkan. |
timeWindows[] |
Periode waktu yang membatasi waktu kedatangan pada kunjungan. Perhatikan bahwa kendaraan dapat berangkat di luar periode waktu kedatangan, yaitu waktu kedatangan + durasi tidak harus berada di dalam jangka waktu. Hal ini dapat menyebabkan waktu tunggu jika kendaraan tiba sebelum Tidak adanya Periode waktu harus terpisah, yaitu tidak boleh ada periode waktu yang tumpang tindih atau berdekatan dengan yang lain, dan periode tersebut harus dalam urutan yang meningkat.
|
duration |
Durasi kunjungan, yaitu waktu yang dihabiskan oleh kendaraan antara kedatangan dan keberangkatan (untuk ditambahkan ke kemungkinan waktu tunggu; lihat Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
cost |
Biaya untuk melayani permintaan kunjungan ini pada rute kendaraan. Kartu ini dapat digunakan untuk membayar biaya yang berbeda untuk setiap pengambilan atau pengiriman alternatif. Biaya ini harus dalam unit yang sama dengan |
loadDemands |
Muat permintaan kunjungan ini. Ini sama seperti kolom Objek yang berisi daftar pasangan |
visitTypes[] |
Menentukan jenis kunjungan. Izin ini dapat digunakan untuk mengalokasikan waktu tambahan yang diperlukan kendaraan untuk menyelesaikan kunjungan ini (lihat Suatu jenis hanya dapat muncul sekali. |
label |
Menentukan label untuk |
LatLng
Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan double untuk mewakili derajat lintang dan derajat bujur. Kecuali jika 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 Kunjungan, serta lokasi awal dan akhir Kendaraan.
Representasi JSON |
---|
{ "sideOfRoad": boolean, // Union field |
Kolom | |
---|---|
sideOfRoad |
Opsional. Menunjukkan bahwa lokasi titik jalan ini dimaksudkan untuk memiliki preferensi agar kendaraan berhenti di sisi jalan tertentu. Jika Anda menetapkan nilai ini, rute akan melewati lokasi sehingga kendaraan dapat berhenti di sisi jalan yang membiaskan lokasi dari tengah jalan. Opsi ini tidak berfungsi untuk 'BERJALAN' mode perjalanan. |
Kolom union location_type . Berbagai cara untuk merepresentasikan lokasi. location_type hanya dapat berupa salah satu dari berikut: |
|
location |
Titik yang ditetapkan menggunakan koordinat geografis, yang mencakup arah opsional. |
placeId |
ID Tempat POI yang terkait dengan titik jalan. |
Lokasi
Mengenkapsulasi lokasi (titik geografis dan judul opsional).
Representasi JSON |
---|
{
"latLng": {
object ( |
Kolom | |
---|---|
latLng |
Koordinat geografis titik jalan. |
heading |
Arah kompas yang terkait dengan arah arus lalu lintas. Nilai ini digunakan untuk menentukan sisi jalan yang akan digunakan untuk pengangkutan dan penurunan penumpang. Nilai arah dapat berasal dari 0 hingga 360, dengan 0 menentukan arah utara, 90 menentukan arah Timur, dll. |
TimeWindow
Jendela waktu membatasi waktu peristiwa, seperti waktu kedatangan di kunjungan, atau waktu mulai dan berakhir kendaraan.
Batas periode waktu sulit, startTime
dan endTime
, menerapkan waktu paling awal dan terbaru untuk peristiwa, sehingga startTime <= event_time <=
endTime
. Batas bawah periode waktu lunak, softStartTime
, menyatakan preferensi agar peristiwa terjadi pada atau setelah softStartTime
dengan menimbulkan biaya yang proporsional dengan durasi sebelum softStartTime peristiwa tersebut terjadi. Batas atas periode waktu lunak, softEndTime
, menyatakan preferensi agar peristiwa terjadi pada atau sebelum softEndTime
dengan menimbulkan biaya yang sebanding dengan berapa lama setelah softEndTime
peristiwa tersebut 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` <= `softStartTime` <= `endTime` and
0 <= `startTime` <= `softEndTime` <= `endTime`.
Representasi JSON |
---|
{ "startTime": string, "endTime": string, "softStartTime": string, "softEndTime": string, "costPerHourBeforeSoftStartTime": number, "costPerHourAfterSoftEndTime": number } |
Kolom | |
---|---|
startTime |
Waktu mulai periode waktu yang sulit. Jika tidak ditentukan, nilai tersebut akan ditetapkan ke Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
endTime |
Waktu berakhir periode waktu sulit. Jika tidak ditentukan, nilai tersebut akan ditetapkan ke Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
softStartTime |
Waktu soft start dari jangka waktu. Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
softEndTime |
Waktu berakhir sementara pada jangka waktu. Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
costPerHourBeforeSoftStartTime |
Biaya per jam yang ditambahkan ke biaya lain dalam model jika peristiwa terjadi sebelum softStartTime, dihitung sebagai:
Biaya ini harus positif, dan kolom ini hanya dapat ditetapkan jika softStartTime telah ditetapkan. |
costPerHourAfterSoftEndTime |
Biaya per jam yang ditambahkan ke biaya lain dalam model jika peristiwa terjadi setelah
Biaya ini harus bernilai positif, dan kolom ini hanya dapat ditetapkan jika |
Kendaraan
Membuat model kendaraan dalam masalah pengiriman. Menyelesaikan 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 | |
---|---|
displayName |
Nama tampilan kendaraan yang ditetapkan pengguna. Panjang maksimal 63 karakter dan dapat menggunakan karakter UTF-8. |
travelMode |
Mode perjalanan yang memengaruhi jalan yang dapat digunakan oleh kendaraan dan kecepatannya. Lihat juga |
startLocation |
Lokasi geografis tempat kendaraan memulai sebelum mengambil kiriman. Jika tidak ditentukan, kendaraan akan dimulai saat penjemputan pertamanya. Jika model pengiriman memiliki matriks durasi dan jarak, |
startWaypoint |
Titik jalan yang mewakili lokasi geografis tempat kendaraan dimulai sebelum mengambil pengiriman. Jika |
endLocation |
Lokasi geografis tempat kendaraan berakhir setelah menyelesaikan |
endWaypoint |
Titik jalan yang mewakili lokasi geografis tempat kendaraan berakhir setelah menyelesaikan |
startTags[] |
Menentukan tag yang disertakan pada awal rute kendaraan. String kosong atau duplikat tidak diizinkan. |
endTags[] |
Menentukan tag yang disertakan di akhir rute kendaraan. String kosong atau duplikat tidak diizinkan. |
startTimeWindows[] |
Periode waktu saat kendaraan dapat meninggalkan lokasi awal. Batas waktu tersebut harus berada dalam batas waktu global (lihat kolom Periode waktu milik kolom berulang yang sama harus dipisahkan, yaitu tidak ada periode waktu yang dapat tumpang-tindih atau berdekatan dengan kolom lain, dan periode tersebut harus dalam urutan kronologis.
|
endTimeWindows[] |
Periode waktu saat kendaraan mungkin tiba di lokasi akhir. Batas waktu tersebut harus berada dalam batas waktu global (lihat kolom Periode waktu milik kolom berulang yang sama harus dipisahkan, yaitu tidak ada periode waktu yang dapat tumpang-tindih atau berdekatan dengan kolom lain, dan periode tersebut harus dalam urutan kronologis.
|
unloadingPolicy |
Kebijakan bongkar muat diterapkan di kendaraan. |
loadLimits |
Kapasitas kendaraan (misalnya berat, volume, # palet). Kunci dalam peta adalah ID jenis beban, sesuai dengan kunci kolom Objek yang berisi daftar pasangan |
costPerHour |
Biaya kendaraan: semua biaya dijumlahkan dan harus dalam unit yang sama dengan Biaya per jam untuk rute kendaraan. Biaya ini berlaku untuk total waktu yang dibutuhkan oleh rute, dan mencakup waktu perjalanan, waktu tunggu, dan waktu kunjungan. Menggunakan |
costPerTraveledHour |
Biaya per jam perjalanan dari rute kendaraan. Biaya ini hanya berlaku untuk waktu perjalanan yang ditempuh rute (yaitu yang dilaporkan dalam |
costPerKilometer |
Biaya per kilometer rute kendaraan. Biaya ini diterapkan ke jarak yang dilaporkan di |
fixedCost |
Biaya tetap berlaku jika kendaraan ini digunakan untuk menangani pengiriman. |
usedIfRouteIsEmpty |
Kolom ini hanya berlaku untuk kendaraan yang rutenya tidak melayani pengiriman apa pun. Ini menunjukkan apakah kendaraan harus dianggap sebagai digunakan atau tidak dalam kasus ini. Jika benar, kendaraan akan bergerak dari awal ke lokasi akhirnya meskipun tidak melayani pengiriman, serta biaya waktu dan jarak yang dihasilkan dari startnya --> akhir perjalanan akan diperhitungkan. Jika tidak, kendaraan tidak akan melakukan perjalanan dari awal ke lokasi akhirnya, dan tidak ada |
routeDurationLimit |
Batas diterapkan ke total durasi rute kendaraan. Dalam |
travelDurationLimit |
Batas diterapkan pada durasi perjalanan rute kendaraan. Dalam |
routeDistanceLimit |
Batas diterapkan ke total jarak rute kendaraan. Dalam |
extraVisitDurationForVisitType |
Menentukan peta dari string visitType ke durasi. Durasinya adalah waktu, selain Jika permintaan kunjungan memiliki beberapa jenis, durasi akan ditambahkan untuk setiap jenis dalam peta. Objek yang berisi daftar pasangan |
breakRule |
Menjelaskan jadwal jeda yang akan diterapkan pada kendaraan ini. Jika kosong, tidak ada waktu istirahat yang akan dijadwalkan untuk kendaraan ini. |
label |
Menentukan label untuk kendaraan ini. Label ini dilaporkan dalam respons sebagai |
ignore |
Jika true (benar), Jika pengiriman dilakukan oleh kendaraan yang diabaikan di Jika pengiriman dilakukan oleh kendaraan yang diabaikan di |
travelDurationMultiple |
Menentukan faktor perkalian yang dapat digunakan untuk menambah atau mengurangi waktu perjalanan kendaraan ini. Misalnya, menyetel ini ke 2.0 berarti kendaraan ini lebih lambat dan memiliki waktu perjalanan dua kali lipat dari yang sebelumnya untuk kendaraan standar. Beberapa hal ini tidak memengaruhi durasi kunjungan. Hal ini memengaruhi biaya jika PERINGATAN: Waktu tempuh 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.
Ini harus merupakan bagian dari mode perjalanan Routes Preferred API Google Maps Platform. Lihat: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/Shared.Types/RouteTravelMode.
Enum | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
Mode perjalanan belum ditetapkan, setara dengan DRIVING . |
DRIVING |
Mode perjalanan yang sesuai dengan rute mobil (mobil, ...). |
WALKING |
Mode perjalanan yang sesuai dengan rute jalan kaki. |
UnloadingPolicy
Kebijakan tentang cara bongkar muat kendaraan. Hanya berlaku untuk pengiriman yang memiliki opsi ambil dan antar.
Pengiriman lainnya dapat terjadi di mana saja pada rute yang tidak bergantung pada unloadingPolicy
.
Enum | |
---|---|
UNLOADING_POLICY_UNSPECIFIED |
Kebijakan bongkar muat tidak ditentukan; pengiriman harus dilakukan setelah pengambilan yang sesuai. |
LAST_IN_FIRST_OUT |
Pengiriman harus dilakukan dengan urutan terbalik |
FIRST_IN_FIRST_OUT |
Pengiriman harus dilakukan dengan urutan yang sama dengan pengambilan |
LoadLimit
Menentukan batas beban yang berlaku untuk kendaraan, misalnya, "truk ini mungkin hanya bisa mengangkut hingga 3.500 kg". Lihat loadLimits
.
Representasi JSON |
---|
{ "softMaxLoad": string, "costPerUnitAboveSoftMax": number, "startLoadInterval": { object ( |
Kolom | |
---|---|
softMaxLoad |
Batas ringan dari beban. Lihat |
costPerUnitAboveSoftMax |
Jika beban melebihi |
startLoadInterval |
Interval beban kendaraan yang dapat diterima di awal rute. |
endLoadInterval |
Interval pemuatan kendaraan yang dapat diterima di akhir rute. |
maxLoad |
Jumlah beban maksimum yang dapat diterima. |
Interval
Interval jumlah pemuatan yang dapat diterima.
Representasi JSON |
---|
{ "min": string, "max": string } |
Kolom | |
---|---|
min |
Beban minimum yang dapat diterima. Harus ≥ 0. Jika keduanya ditentukan, |
max |
Beban maksimum yang dapat diterima. Harus ≥ 0. Jika tidak ditentukan, beban maksimum tidak akan dibatasi oleh pesan ini. Jika keduanya ditentukan, |
DurationLimit
Batas yang menentukan durasi maksimum rute kendaraan. Bisa keras atau lembut.
Jika kolom batas terbatas ditentukan, nilai minimum minimum dan biaya terkait harus ditentukan bersama.
Representasi JSON |
---|
{ "maxDuration": string, "softMaxDuration": string, "quadraticSoftMaxDuration": string, "costPerHourAfterSoftMax": number, "costPerSquareHourAfterQuadraticSoftMax": number } |
Kolom | |
---|---|
maxDuration |
Batas ketat yang membatasi durasi agar mencapai maksimum maxDuration. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
softMaxDuration |
Batas sementara tidak menerapkan batas durasi maksimum, tetapi jika dilanggar, rute akan dikenai biaya. Biaya ini menambah biaya lain yang ditentukan dalam model, dengan unit yang sama. Jika ditentukan, Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
quadraticSoftMaxDuration |
Batas sementara tidak menerapkan batas durasi maksimum, tetapi jika dilanggar akan membuat rute dikenai biaya, kuadrat dalam durasinya. Biaya ini menambah biaya lain yang ditentukan dalam model, dengan unit yang sama. Jika ditentukan,
Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
costPerHourAfterSoftMax |
Biaya per jam yang timbul jika nilai minimum
Biaya harus bilangan positif. |
costPerSquareHourAfterQuadraticSoftMax |
Biaya per jam persegi yang timbul jika nilai minimum Biaya tambahannya adalah 0 jika durasi tidak melebihi nilai minimum. Jika tidak, biaya bergantung pada durasi sebagai berikut:
Biaya harus bilangan positif. |
DistanceLimit
Batas yang menentukan jarak maksimum yang dapat ditempuh. Bisa keras atau lembut.
Jika batas lunak ditentukan, softMaxMeters
dan costPerKilometerAboveSoftMax
harus ditentukan dan tidak negatif.
Representasi JSON |
---|
{ "maxMeters": string, "softMaxMeters": string, "costPerKilometerAboveSoftMax": number } |
Kolom | |
---|---|
maxMeters |
Batas ketat yang membatasi jarak untuk mencapai maksimal maxMeters. Batasnya tidak boleh negatif. |
softMaxMeters |
Batas awal tidak menerapkan batas jarak maksimum, tetapi jika dilanggar akan mengakibatkan biaya yang menambah biaya lain yang ditentukan dalam model, dengan unit yang sama. Jika ditentukan, softMaxMeters harus kurang dari maxMeters dan harus positif. |
costPerKilometerAboveSoftMax |
Biaya per kilometer yang timbul jika jarak di atas batas
Biaya harus bilangan positif. |
BreakRule
Aturan untuk menghasilkan waktu istirahat untuk kendaraan (misalnya istirahat makan siang). Waktu istirahat adalah periode waktu berurutan saat kendaraan tetap tidak ada aktivitas pada posisi saat ini dan tidak dapat melakukan kunjungan apa pun. Gangguan dapat terjadi:
- selama perjalanan antara dua kunjungan (yang mencakup waktu tepat sebelum atau tepat setelah kunjungan, tetapi tidak di tengah-tengah kunjungan), dalam hal ini penambahan waktu transit yang sesuai di antara kunjungan tersebut,
- atau sebelum kendaraan dimulai (kendaraan mungkin tidak menyala di tengah waktu istirahat), sehingga tidak memengaruhi waktu mulai kendaraan.
- atau setelah akhir kendaraan (sama dengan, dengan waktu berakhir kendaraan).
Representasi JSON |
---|
{ "breakRequests": [ { object ( |
Kolom | |
---|---|
breakRequests[] |
Urutan jeda. Lihat pesan |
frequencyConstraints[] |
Beberapa |
BreakRequest
Urutan jeda (yaitu nomor dan urutannya) yang berlaku untuk setiap kendaraan harus diketahui sebelumnya. BreakRequest
yang berulang menentukan urutan tersebut, sesuai urutan kemunculannya. Periode waktunya (earliestStartTime
/ latestStartTime
) mungkin tumpang-tindih, tetapi harus kompatibel dengan pesanan (ini dicentang).
Representasi JSON |
---|
{ "earliestStartTime": string, "latestStartTime": string, "minDuration": string } |
Kolom | |
---|---|
earliestStartTime |
Wajib. Batas bawah (inklusif) pada awal jeda. Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
latestStartTime |
Wajib. Batas atas (inklusif) pada awal jeda. Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
minDuration |
Wajib. Durasi minimum istirahat. 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 waktu istirahat minimal 1 jam setiap 12 jam". Dengan asumsi bahwa hal ini dapat ditafsirkan sebagai "Dalam jangka waktu geser apa pun selama 12 jam, harus ada setidaknya satu jeda setidaknya satu jam", contoh tersebut akan diterjemahkan menjadi FrequencyConstraint
berikut:
{
minBreakDuration { seconds: 3600 } # 1 hour.
maxInterBreakDuration { seconds: 39600 } # 11 hours (12 - 1 = 11).
}
Pengaturan waktu dan durasi jeda dalam solusi akan mengikuti semua batasan tersebut, selain jangka waktu dan durasi minimum yang sudah ditentukan dalam BreakRequest
.
Dalam praktiknya, FrequencyConstraint
mungkin berlaku untuk jeda yang tidak berurutan. Misalnya, jadwal berikut mengikuti "1h setiap 12 jam" contoh:
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 | |
---|---|
minBreakDuration |
Wajib. Durasi jeda minimum untuk batasan ini. Non-negatif. Lihat deskripsi Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
maxInterBreakDuration |
Wajib. Rentang waktu maksimum yang diizinkan dari setiap interval waktu di rute yang tidak menyertakan setidaknya jeda Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
DurationDistanceMatrix
Menentukan matriks durasi dan jarak dari lokasi kunjungan dan awal kendaraan yang akan dikunjungi dan lokasi akhir kendaraan.
Representasi JSON |
---|
{
"rows": [
{
object ( |
Kolom | |
---|---|
rows[] |
Menentukan baris matriks durasi dan jarak. Jumlah elemennya harus sebanyak |
vehicleStartTag |
Tag yang menentukan kendaraan mana yang menggunakan matriks durasi dan jarak ini. Jika kosong, ini berlaku untuk semua kendaraan, dan hanya boleh ada satu matriks. Setiap start kendaraan harus sama persis dengan satu matriks, yaitu tepat 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. Jumlah elemennya harus sebanyak 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, jumlah elemen harus sebanyak |
TransitionAttributes
Menentukan atribut transisi antara dua kunjungan berturut-turut pada rute. Beberapa TransitionAttributes
mungkin berlaku untuk transisi yang sama: dalam hal ini, semua biaya tambahan akan bertambah dan batasan atau batas yang paling ketat berlaku (mengikuti semantik "AND" alami).
Representasi JSON |
---|
{
"srcTag": string,
"excludedSrcTag": string,
"dstTag": string,
"excludedDstTag": string,
"cost": number,
"costPerKilometer": number,
"distanceLimit": {
object ( |
Kolom | |
---|---|
srcTag |
Tag yang menentukan kumpulan transisi (src->dst) yang akan diterapkan atribut ini. Kunjungan sumber atau awal kendaraan cocok jika |
excludedSrcTag |
Lihat |
dstTag |
Kunjungan tujuan atau akhir kendaraan cocok jika |
excludedDstTag |
Lihat |
cost |
Menentukan biaya untuk melakukan transisi ini. Biaya ini berada dalam unit yang sama dengan semua biaya lain dalam model dan tidak boleh negatif. Tarif ini berlaku di atas semua biaya lain yang ada. |
costPerKilometer |
Menentukan biaya per kilometer yang diterapkan ke jarak yang ditempuh saat melakukan transisi ini. Total ini menambahkan hingga |
distanceLimit |
Menentukan batas jarak yang ditempuh saat melakukan transisi ini. Mulai 2021/06, hanya batas sementara yang didukung. |
delay |
Menentukan penundaan yang terjadi saat melakukan transisi ini. Keterlambatan 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 ketidaksesuaian antar-pengiriman bergantung pada deliveryType-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 |
incompatibilityMode |
Mode diterapkan pada inkompatibilitas. |
IncompatibilityMode
Mode yang menentukan bagaimana tampilan pengiriman yang tidak kompatibel dibatasi 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 dapat menggunakan kendaraan yang sama. |
NOT_IN_SAME_VEHICLE_SIMULTANEOUSLY |
Untuk dua pengiriman dengan jenis yang tidak kompatibel dengan mode inkompatibilitas
|
ShipmentTypeRequirement
Menentukan persyaratan antar-pengiriman berdasarkan jenis pengirimannya. Detail persyaratan ditentukan oleh mode persyaratan.
Representasi JSON |
---|
{
"requiredShipmentTypeAlternatives": [
string
],
"dependentShipmentTypes": [
string
],
"requirementMode": enum ( |
Kolom | |
---|---|
requiredShipmentTypeAlternatives[] |
Daftar jenis pengiriman alternatif yang diwajibkan oleh |
dependentShipmentTypes[] |
Semua pengiriman dengan jenis di kolom CATATAN: Rantai persyaratan sehingga |
requirementMode |
Mode 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 "dependen" pengiriman harus memiliki kendaraan yang sama dengan minimal salah satu dari yang "wajib" pengiriman. |
IN_SAME_VEHICLE_AT_PICKUP_TIME |
Dengan mode "dependen" pengambilan pengiriman harus memiliki:
|
IN_SAME_VEHICLE_AT_DELIVERY_TIME |
Sama seperti sebelumnya, kecuali "dependen" pengiriman harus memiliki “wajib” pengiriman di kendaraan mereka pada saat pengiriman. |
PrecedenceRule
Aturan prioritas antara dua peristiwa (setiap peristiwa adalah pengambilan atau pengantaran pengiriman): "kedua" peristiwa harus dimulai minimal offsetDuration
setelah "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.
Representasi JSON |
---|
{ "firstIsDelivery": boolean, "secondIsDelivery": boolean, "offsetDuration": string, "firstIndex": integer, "secondIndex": integer } |
Kolom | |
---|---|
firstIsDelivery |
Menunjukkan jika "pertama" adalah pengiriman. |
secondIsDelivery |
Menunjukkan jika "detik" adalah pengiriman. |
offsetDuration |
Offset antara "pertama" dan "kedua" peristiwa. Bisa jadi negatif. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
firstIndex |
Indeks pengiriman "pertama" peristiwa. Kolom ini harus ditentukan. |
secondIndex |
Indeks pengiriman "kedua" peristiwa. Kolom ini harus ditentukan. |