Package google.maps.routeoptimization.v1

int32

Jumlah pengiriman yang dilakukan. Perhatikan bahwa pasangan pengambilan dan pengiriman hanya dihitung satu kali.

Duration

Total durasi perjalanan untuk rute atau solusi.

Duration

Total durasi menunggu untuk rute atau solusi.

Duration

Total durasi penundaan untuk rute atau solusi.

Duration

Total durasi istirahat untuk rute atau solusi.

Duration

Total durasi kunjungan untuk rute atau solusi.

Duration

Total durasi harus sama dengan jumlah semua durasi di atas. Untuk rute, hal ini juga sesuai dengan:

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

double

Total jarak perjalanan untuk rute atau solusi.

map<string, VehicleLoad>

Beban maksimum yang dicapai di seluruh rute (atau solusi), untuk setiap kuantitas di rute (atau solusi) ini, dihitung sebagai maksimum di semua Transition.vehicle_loads (atau ShipmentRoute.metrics.max_loads.

int32

Jumlah pengiriman wajib yang dilakukan.

Eksperimental: Perilaku atau keberadaan kolom ini dapat berubah di masa mendatang.

double

Jumlah Shipment.penalty_cost pengiriman yang dilakukan.

Eksperimental: Perilaku atau keberadaan kolom ini dapat berubah di masa mendatang.

string

Wajib. Project target dan lokasi untuk melakukan panggilan.

Format:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

Jika tidak ada lokasi yang ditentukan, region akan dipilih secara otomatis.

AsyncModelConfig

Wajib. Informasi Input/Output setiap model pembelian, seperti jalur file dan format data.

string

Opsional. Nama model yang ditentukan pengguna, dapat digunakan sebagai alias oleh pengguna untuk melacak model.

InputConfig

Wajib. Informasi tentang model input.

OutputConfig

Wajib. Informasi lokasi output yang diinginkan.

BreakRequest

Urutan jeda. Lihat pesan BreakRequest.

FrequencyConstraint

Beberapa FrequencyConstraint mungkin berlaku. Semuanya harus dipenuhi pada BreakRequest BreakRule ini. Lihat FrequencyConstraint.

Timestamp

Wajib. Batas bawah (inklusif) pada awal jeda.

Timestamp

Wajib. Batas atas (inklusif) pada awal jeda.

Duration

Wajib. Durasi minimum jeda. Harus positif.

Duration

Wajib. Durasi jeda minimum untuk batasan ini. Non-negatif. Lihat deskripsi FrequencyConstraint.

Duration

Wajib. Rentang waktu maksimum yang diizinkan untuk setiap interval waktu dalam rute yang tidak menyertakan istirahat duration >= min_break_duration, setidaknya sebagian. Harus positif.

int64

Batas ketat yang membatasi jarak menjadi paling banyak max_meter. Batas harus non-negatif.

int64

Batas lunak 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, soft_max_meter harus kurang dari max_meter dan tidak boleh negatif.

double

Biaya per kilometer yang dikeluarkan, meningkat hingga soft_max_meters, dengan formula:

  min(distance_meters, soft_max_meters) / 1000.0 *
  cost_per_kilometer_below_soft_max.

Biaya ini tidak didukung di route_distance_limit.

double

Biaya per kilometer yang dikeluarkan jika jarak di atas batas soft_max_meters. Biaya tambahan adalah 0 jika jaraknya di bawah batas, jika tidak, formula yang digunakan untuk menghitung biaya adalah sebagai berikut:

  (distance_meters - soft_max_meters) / 1000.0 *
  cost_per_kilometer_above_soft_max.

Biaya tidak boleh negatif.

string

Wajib. URI Google Cloud Storage.

string

Wajib. URI objek Google Cloud Storage dengan format gs://bucket/path/to/object.

ShipmentRoute

Rute solusi yang akan disuntikkan. Beberapa rute mungkin dihilangkan dari solusi asli. Rute dan pengiriman yang dilewati harus memenuhi asumsi validitas dasar yang tercantum untuk injected_first_solution_routes.

SkippedShipment

Pengiriman solusi yang dilewati untuk disisipkan. Beberapa mungkin tidak ada dalam solusi asli. Lihat kolom routes.

ConstraintRelaxation

Untuk nol atau lebih grup kendaraan, menentukan kapan dan seberapa besar batasan akan dilonggarkan. Jika kolom ini kosong, semua rute kendaraan yang tidak kosong akan sepenuhnya dibatasi.

Relaxation

Semua pelonggaran batasan kunjungan yang akan berlaku untuk kunjungan di rute dengan kendaraan di vehicle_indices.

int32

Menentukan indeks kendaraan yang menerapkan batasan kunjungan relaxations. Jika kosong, ini dianggap sebagai default dan relaxations berlaku untuk semua kendaraan yang tidak ditentukan dalam constraint_relaxations lainnya. Maksimal ada satu default, yaitu, maksimal satu kolom pelonggaran batasan yang dibiarkan kosong vehicle_indices. Indeks kendaraan hanya dapat dicantumkan satu kali, bahkan dalam beberapa constraint_relaxations.

Indeks kendaraan dipetakan sama seperti ShipmentRoute.vehicle_index, jika interpret_injected_solutions_using_labels benar (lihat komentar fields).

Level

Tingkat pelonggaran batasan yang berlaku saat kondisi pada atau setelah threshold_time DAN setidaknya threshold_visit_count terpenuhi.

Timestamp

Waktu saat atau setelah pelonggaran level dapat diterapkan.

int32

Jumlah kunjungan saat atau setelah relaksasi level dapat diterapkan. Jika threshold_visit_count adalah 0 (atau tidak disetel), level dapat diterapkan langsung saat kendaraan dinyalakan.

Jika route.visits_size() + 1, level hanya dapat diterapkan pada ujung kendaraan. Jika lebih dari route.visits_size() + 1, level tidak diterapkan sama sekali untuk rute tersebut.

DataFormat

Wajib. Format data input.

GcsSource

Lokasi Google Cloud Storage. Ini harus berupa satu objek (file).

LatLng

Koordinat geografis titik jalan.

int32

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 berupa 0 hingga 360, dengan 0 menentukan arah Utara, 90 menentukan arah Timur, dll.

string

Wajib. Project atau lokasi target untuk melakukan panggilan.

Format:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

Jika tidak ada lokasi yang ditentukan, region akan dipilih secara otomatis.

Duration

Jika waktu tunggu ini ditetapkan, server akan menampilkan respons sebelum periode waktu tunggu berlalu atau batas waktu server untuk permintaan sinkronis tercapai, mana saja yang lebih dulu.

Untuk permintaan asinkron, server akan membuat solusi (jika memungkinkan) sebelum waktu tunggu berakhir.

ShipmentModel

Model pengiriman yang akan diselesaikan.

SolvingMode

Secara default, mode penyelesaiannya adalah DEFAULT_SOLVE (0).

SearchMode

Mode penelusuran yang digunakan untuk menyelesaikan permintaan.

ShipmentRoute

Mengarahkan algoritma pengoptimalan dalam menemukan solusi pertama yang mirip dengan solusi sebelumnya.

Model dibatasi saat solusi pertama dibuat. Setiap pengiriman yang tidak dilakukan di rute akan dilewati secara implisit dalam solusi pertama, tetapi dapat dilakukan dalam solusi berikutnya.

Solusi harus memenuhi beberapa asumsi validitas dasar:

• untuk semua rute, vehicle_index harus berada dalam rentang dan tidak boleh diduplikasi.
• untuk semua kunjungan, shipment_index dan visit_request_index harus berada dalam rentang.
• pengiriman hanya dapat dirujuk pada satu rute.
• penjemputan pengiriman dengan opsi ambil di lokasi harus dilakukan sebelum pengiriman.
• tidak lebih dari satu alternatif pengambilan atau alternatif pengiriman untuk pengiriman dapat dilakukan.
• untuk semua rute, waktu perjalanan meningkat (yaitu, vehicle_start_time <= visits[0].start_time <= visits[1].start_time ... <= vehicle_end_time).
• pengiriman hanya dapat dilakukan pada kendaraan yang diizinkan. Kendaraan diizinkan jika Shipment.allowed_vehicle_indices kosong atau vehicle_index-nya disertakan dalam Shipment.allowed_vehicle_indices.

Jika solusi yang disuntikkan tidak layak, error validasi tidak selalu ditampilkan dan error yang menunjukkan ketidaklayakan dapat ditampilkan sebagai gantinya.

InjectedSolutionConstraint

Membatasi algoritma pengoptimalan untuk menemukan solusi akhir yang mirip dengan solusi sebelumnya. Misalnya, hal ini dapat digunakan untuk membekukan bagian rute yang telah diselesaikan atau yang akan diselesaikan, tetapi tidak boleh diubah.

Jika solusi yang disuntikkan tidak layak, error validasi tidak selalu ditampilkan dan error yang menunjukkan ketidaklayakan dapat ditampilkan sebagai gantinya.

ShipmentRoute

Jika tidak kosong, rute yang diberikan akan diperbarui, tanpa mengubah urutan kunjungan atau waktu perjalanan yang mendasarinya: hanya detail lainnya yang akan diperbarui. Hal ini tidak menyelesaikan model.

Mulai 2020/11, ini hanya mengisi polyline rute yang tidak kosong dan mewajibkan populate_polylines bernilai benar (true).

Kolom route_polyline dari rute yang diteruskan mungkin tidak konsisten dengan rute transitions.

Kolom ini tidak boleh digunakan bersama dengan injected_first_solution_routes atau injected_solution_constraint.

Shipment.ignore dan Vehicle.ignore tidak berpengaruh pada perilaku. Polyline tetap diisi di antara semua kunjungan di semua rute yang tidak kosong, terlepas dari apakah pengiriman atau kendaraan terkait diabaikan atau tidak.

bool

Jika benar:

• menggunakan ShipmentRoute.vehicle_label, bukan vehicle_index, untuk mencocokkan rute dalam solusi yang disuntikkan dengan kendaraan dalam permintaan; menggunakan kembali pemetaan ShipmentRoute.vehicle_index asli ke ShipmentRoute.vehicle_index baru untuk memperbarui ConstraintRelaxation.vehicle_indices jika tidak kosong, tetapi pemetaan harus tidak ambigu (yaitu, beberapa ShipmentRoute tidak boleh berbagi vehicle_index asli yang sama).
• menggunakan ShipmentRoute.Visit.shipment_label, bukan shipment_index, untuk mencocokkan kunjungan dalam solusi yang disisipkan dengan pengiriman dalam permintaan;
• menggunakan SkippedShipment.label, bukan SkippedShipment.index, untuk mencocokkan pengiriman yang dilewati dalam solusi yang disuntikkan dengan pengiriman permintaan.

Interpretasi ini berlaku untuk kolom injected_first_solution_routes, injected_solution_constraint, dan refresh_details_routes. API ini dapat digunakan saat indeks pengiriman atau kendaraan dalam permintaan telah berubah sejak solusi dibuat, mungkin karena pengiriman atau kendaraan telah dihapus dari atau ditambahkan ke permintaan.

Jika benar, label dalam kategori berikut hanya boleh muncul paling banyak satu kali dalam kategorinya:

• Vehicle.label dalam permintaan;
• Shipment.label dalam permintaan;
• ShipmentRoute.vehicle_label dalam larutan yang disuntikkan;
• SkippedShipment.label dan ShipmentRoute.Visit.shipment_label dalam solusi yang disisipkan (kecuali pasangan kunjungan pengambilan/pengiriman, yang shipment_label-nya harus muncul dua kali).

Jika vehicle_label dalam solusi yang disisipkan tidak sesuai dengan kendaraan permintaan, rute yang sesuai akan dihapus dari solusi beserta kunjungan rutenya. Jika shipment_label dalam solusi yang disuntikkan tidak sesuai dengan pengiriman permintaan, kunjungan yang sesuai akan dihapus dari solusi. Jika SkippedShipment.label dalam solusi yang disuntikkan tidak sesuai dengan pengiriman permintaan, SkippedShipment akan dihapus dari solusi.

Menghapus kunjungan rute atau seluruh rute dari solusi yang disisipkan dapat memengaruhi batasan tersirat, yang dapat menyebabkan perubahan solusi, error validasi, atau tidak dapat diterapkan.

CATATAN: Pemanggil harus memastikan bahwa setiap Vehicle.label (resp. Shipment.label) secara unik mengidentifikasi entitas kendaraan (atau pengiriman) yang digunakan di dua permintaan yang relevan: permintaan sebelumnya yang menghasilkan OptimizeToursResponse yang digunakan dalam solusi yang disisipkan dan permintaan saat ini yang mencakup solusi yang disisipkan. Pemeriksaan keunikan yang dijelaskan di atas tidak cukup untuk menjamin persyaratan ini.

bool

Pertimbangkan estimasi traffic dalam menghitung kolom ShipmentRoute Transition.travel_duration, Visit.start_time, dan vehicle_end_time; dalam menetapkan kolom ShipmentRoute.has_traffic_infeasibilities, dan dalam menghitung kolom OptimizeToursResponse.total_cost.

bool

Jika benar (true), polyline akan diisi dalam respons ShipmentRoute.

bool

Jika benar (true), polyline dan token rute akan diisi dalam respons ShipmentRoute.transitions.

bool

Jika disetel, permintaan dapat memiliki batas waktu (lihat https://grpc.io/blog/deadlines) hingga 60 menit. Jika tidak, batas waktu maksimumnya hanya 30 menit. Perhatikan bahwa permintaan yang berjalan lama memiliki risiko gangguan yang jauh lebih besar (tetapi tetap kecil).

bool

Jika benar (true), jarak perjalanan akan dihitung menggunakan jarak geodetik, bukan jarak Google Maps, dan waktu tempuh akan dihitung menggunakan jarak geodetik dengan kecepatan yang ditentukan oleh geodesic_meters_per_second.

string

Label yang dapat digunakan untuk mengidentifikasi permintaan ini, dilaporkan kembali di OptimizeToursResponse.request_label.

double

Jika use_geodesic_distances bernilai benar (true), kolom ini harus ditetapkan dan menentukan kecepatan yang diterapkan untuk menghitung waktu perjalanan. Nilainya harus minimal 1,0 meter/detik.

int32

Memangkas jumlah error validasi yang ditampilkan. Error ini biasanya dilampirkan ke payload error INVALID_ARGUMENT sebagai detail error BadRequest (https://cloud.google.com/apis/design/errors#error_details), kecuali jika solving_mode=VALIDATE_ONLY: lihat kolom OptimizeToursResponse.validation_errors. Nilai defaultnya adalah 100 dan dibatasi hingga 10.000.

ShipmentRoute

Rute dihitung untuk setiap kendaraan; rute ke-i sesuai dengan kendaraan ke-i dalam model.

string

Salinan OptimizeToursRequest.label, jika label ditentukan dalam permintaan.

SkippedShipment

Daftar semua pengiriman yang dilewati.

OptimizeToursValidationError

Daftar semua error validasi yang dapat kami deteksi secara independen. Lihat penjelasan "BEBERAPA ERROR" untuk pesan OptimizeToursValidationError. Alih-alih error, hal ini akan mencakup peringatan jika solving_mode adalah DEFAULT_SOLVE.

OptimizeToursRequest

Dalam beberapa kasus, kami mengubah permintaan yang masuk sebelum menyelesaikannya, yaitu menambahkan biaya. Jika solving_mode == TRANSFORM_AND_RETURN_REQUEST, permintaan yang diubah akan ditampilkan di sini.

Eksperimental: Lihat https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request untuk mengetahui detail selengkapnya.

Metrics

Metrik durasi, jarak, dan penggunaan untuk solusi ini.

AggregatedMetrics

Digabungkan di seluruh rute. Setiap metrik adalah jumlah (atau maksimum, untuk pemuatan) di semua kolom ShipmentRoute.metrics dengan nama yang sama.

int32

Jumlah pengiriman wajib yang dilewati.

int32

Jumlah kendaraan yang digunakan. Catatan: jika rute kendaraan kosong dan Vehicle.used_if_route_is_empty benar (true), kendaraan dianggap sudah digunakan.

Timestamp

Waktu mulai paling awal untuk kendaraan bekas, dihitung sebagai minimum dari semua kendaraan bekas ShipmentRoute.vehicle_start_time.

Timestamp

Waktu berakhir terbaru untuk kendaraan bekas, dihitung sebagai maksimum dari semua kendaraan bekas ShipmentRoute.vehicle_end_time.

map<string, double>

Biaya solusi, yang dikelompokkan berdasarkan kolom permintaan terkait biaya. Kuncinya adalah jalur proto, relatif terhadap input OptimizeToursRequest, misalnya "model.shipments.pickups.cost", dan nilainya adalah total biaya yang dihasilkan oleh kolom biaya yang sesuai, yang digabungkan di seluruh solusi. Dengan kata lain, costs["model.shipments.pickups.cost"] adalah jumlah semua biaya pengambilan selama solusi. Semua biaya yang ditentukan dalam model dilaporkan secara mendetail di sini, kecuali biaya yang terkait dengan TransitionAttributes yang hanya dilaporkan secara gabungan mulai 01/2022.

double

Total biaya solusi. Jumlah semua nilai dalam peta biaya.

string

Wajib. Project atau lokasi target untuk melakukan panggilan.

Format:

• projects/{project-id}
• projects/{project-id}/locations/{location-id}

Jika tidak ada lokasi yang ditentukan, region akan dipilih secara otomatis.

Uri

Wajib. URI objek Cloud Storage yang berisi OptimizeToursRequest.

Uri

Wajib. URI objek Cloud Storage yang akan berisi OptimizeToursResponse.

Uri

Opsional. URI objek Cloud Storage yang berisi OptimizeToursResponse yang dienkode sebagai JSON atau textproto. Jika objek dienkode sebagai JSON, ekstensi nama objek akan menjadi .json. Jika objek dienkode sebagai textproto, ekstensi nama objek akan menjadi .txtpb.

crc32_checksum resource dapat digunakan untuk memverifikasi bahwa konten resource belum dimodifikasi.

int32

Error validasi ditentukan oleh pasangan (code, display_name) yang selalu ada.

Kolom setelah bagian ini memberikan konteks selengkapnya tentang error.

BEBERAPA ERROR: Jika ada beberapa error, proses validasi akan mencoba menampilkan beberapa error tersebut. Seperti compiler, ini adalah proses yang tidak sempurna. Beberapa error validasi akan bersifat "fatal", yang berarti error tersebut menghentikan seluruh proses validasi. Hal ini berlaku untuk error display_name="UNSPECIFIED", dan lain-lain. Beberapa error dapat menyebabkan proses validasi melewati error lainnya.

STABILITAS: code dan display_name harus sangat stabil. Namun, kode dan nama tampilan baru dapat muncul seiring waktu, yang dapat menyebabkan permintaan (tidak valid) tertentu menghasilkan pasangan (code, display_name) yang berbeda karena error baru menyembunyikan error lama. Misalnya, lihat "BEBERAPA KESALAHAN".

string

Nama tampilan error.

FieldReference

Konteks error dapat melibatkan 0, 1 (sebagian besar waktu) atau lebih banyak kolom. Misalnya, pengambilan pertama kendaraan #4 dan pengiriman #2 dapat dilakukan sebagai berikut:

fields { name: "vehicles" index: 4}
fields { name: "shipments" index: 2 sub_field {name: "pickups" index: 0} }

Namun, perhatikan bahwa kardinalitas fields tidak boleh berubah untuk kode error tertentu.

string

String yang menjelaskan error dan dapat dibaca manusia. Terdapat pemetaan 1:1 antara code dan error_message (jika code != "UNSPECIFIED").

STABILITAS: Tidak stabil: pesan error yang terkait dengan code tertentu dapat berubah (semoga menjadi lebih jelas) dari waktu ke waktu. Sebagai gantinya, gunakan display_name dan code.

string

Dapat berisi nilai kolom. Fitur ini tidak selalu tersedia. Anda sama sekali tidak boleh mengandalkannya dan hanya menggunakannya untuk proses debug model manual.

string

Nama kolom, misalnya, "vehicles".

FieldReference

Sub-field yang disusun secara rekursif, jika diperlukan.

int32

Indeks kolom jika berulang.

string

Kunci jika kolom adalah peta.

DataFormat

Wajib. Format data output.

GcsDestination

Lokasi Google Cloud Storage yang menjadi tujuan penulisan output.

bool

Menentukan apakah akan menghindari jalan tol jika memungkinkan. Rute yang tidak berisi jalan tol akan diprioritaskan. Hanya berlaku untuk mode perjalanan bermotor.

bool

Menentukan apakah akan menghindari jalan tol jika memungkinkan. Rute yang tidak berisi jalan raya akan diprioritaskan. Hanya berlaku untuk mode perjalanan bermotor.

bool

Menentukan apakah akan menghindari feri jika memungkinkan. Rute yang tidak mencakup perjalanan dengan feri akan diprioritaskan. Hanya berlaku untuk mode perjalanan bermotor.

bool

Opsional. Menentukan apakah akan menghindari navigasi di dalam ruangan jika memungkinkan. Rute yang tidak berisi navigasi dalam ruangan akan diprioritaskan. Hanya berlaku untuk mode perjalanan WALKING.

string

Nama tampilan pengiriman yang ditentukan pengguna. Panjangnya bisa mencapai 63 karakter dan dapat menggunakan karakter UTF-8.

VisitRequest

Kumpulan alternatif pengambilan yang terkait dengan pengiriman. Jika tidak ditentukan, kendaraan hanya perlu mengunjungi lokasi yang sesuai dengan pengiriman.

VisitRequest

Kumpulan alternatif pengiriman yang terkait dengan pengiriman. Jika tidak ditentukan, kendaraan hanya perlu mengunjungi lokasi yang sesuai dengan pengambilan.

map<string, Load>

Permintaan muatan pengiriman (misalnya, berat, volume, jumlah palet, dll.). Kunci dalam peta harus berupa ID yang menjelaskan jenis beban yang sesuai, idealnya juga mencakup unit. Misalnya: "weight_kg", "volume_gallons", "pallet_count", dll. Jika kunci tertentu tidak muncul dalam peta, muatan yang sesuai dianggap sebagai null.

int32

Kumpulan kendaraan yang dapat melakukan pengiriman ini. Jika kosong, semua kendaraan dapat melakukannya. Kendaraan diberikan berdasarkan indeksnya dalam daftar ShipmentModel's vehicles.

double

Menentukan biaya yang dikeluarkan saat pengiriman ini dilakukan oleh setiap kendaraan. Jika ditentukan, harus memiliki SALAH SATU:

• jumlah elemen yang sama dengan costs_per_vehicle_indices. costs_per_vehicle[i] sesuai dengan kendaraan costs_per_vehicle_indices[i] dari model tersebut.
• jumlah elemen yang sama dengan jumlah kendaraan dalam model. Elemen ke-i sesuai dengan kendaraan #i dari model.

Biaya ini harus dalam unit yang sama dengan penalty_cost dan tidak boleh negatif. Kosongkan kolom ini jika tidak ada biaya tersebut.

int32

Indeks kendaraan yang menerapkan costs_per_vehicle. Jika tidak kosong, jumlah elemennya harus sama dengan costs_per_vehicle. Indeks kendaraan tidak boleh ditentukan lebih dari sekali. Jika kendaraan dikecualikan dari costs_per_vehicle_indices, biayanya adalah nol.

Duration

Menentukan waktu perjalanan memutar absolut maksimum dibandingkan dengan jalur terpendek dari penjemputan hingga pengiriman. Jika ditentukan, nilainya harus non-negatif, dan pengiriman harus berisi setidaknya pengambilan dan pengiriman.

Misalnya, misalkan t adalah waktu tersingkat yang diperlukan untuk beralih dari alternatif pengambilan yang dipilih langsung ke alternatif pengiriman yang dipilih. Kemudian, setelan pickup_to_delivery_absolute_detour_limit akan diterapkan:

start_time(delivery) - start_time(pickup) <=
t + pickup_to_delivery_absolute_detour_limit

Jika batas relatif dan absolut ditentukan pada pengiriman yang sama, batas yang lebih ketat akan digunakan untuk setiap kemungkinan pasangan pengambilan/pengiriman. Mulai 10/2017, rute alternatif hanya didukung jika durasi perjalanan tidak bergantung pada kendaraan.

Duration

Menentukan durasi maksimum dari awal pengambilan hingga awal pengiriman kiriman. Jika ditentukan, nilainya harus non-negatif, dan pengiriman harus berisi setidaknya pengambilan dan pengiriman. Hal ini tidak bergantung pada alternatif mana yang dipilih untuk pengambilan dan pengiriman, atau kecepatan kendaraan. Hal ini dapat ditentukan bersama dengan batasan perutean maksimum: solusi akan mematuhi kedua spesifikasi.

string

String tidak kosong yang menentukan "jenis" untuk pengiriman ini. Fitur ini dapat digunakan untuk menentukan inkompatibilitas atau persyaratan antara shipment_types (lihat shipment_type_incompatibilities dan shipment_type_requirements di ShipmentModel).

Berbeda dengan visit_types yang ditentukan untuk satu kunjungan: Semua pengambilan/pengiriman yang termasuk dalam pengiriman yang sama memiliki shipment_type yang sama.

string

Menentukan label untuk pengiriman ini. Label ini dilaporkan dalam respons di shipment_label dari ShipmentRoute.Visit yang sesuai.

bool

Jika benar, lewati pengiriman ini, tetapi jangan terapkan penalty_cost.

Mengabaikan pengiriman akan menyebabkan error validasi jika ada shipment_type_requirements dalam model.

Mengabaikan pengiriman yang dilakukan di injected_first_solution_routes atau injected_solution_constraint diizinkan; pemecah masalah akan menghapus kunjungan pengambilan/pengiriman terkait dari rute yang dilakukan. precedence_rules yang mereferensikan pengiriman yang diabaikan juga akan diabaikan.

double

Jika pengiriman tidak selesai, penalti ini akan ditambahkan ke keseluruhan biaya rute. Pengiriman dianggap selesai jika salah satu alternatif pengambilan dan pengirimannya dikunjungi. Biaya dapat dinyatakan dalam unit yang sama dengan yang digunakan untuk semua kolom terkait biaya lainnya dalam model dan harus positif.

PENTING: Jika penalti ini tidak ditentukan, penalti dianggap tidak terbatas, yaitu pengiriman harus diselesaikan.

double

Menentukan waktu perjalanan memutar relatif maksimum dibandingkan dengan jalur terpendek dari lokasi penjemputan ke pengantaran. Jika ditentukan, nilainya harus non-negatif, dan pengiriman harus berisi setidaknya pengambilan dan pengiriman.

Misalnya, misalkan t adalah waktu tersingkat yang diperlukan untuk beralih dari alternatif pengambilan yang dipilih langsung ke alternatif pengiriman yang dipilih. Kemudian, setelan pickup_to_delivery_relative_detour_limit akan diterapkan:

start_time(delivery) - start_time(pickup) <=
std::ceil(t * (1.0 + pickup_to_delivery_relative_detour_limit))

Jika batas relatif dan absolut ditentukan pada pengiriman yang sama, batas yang lebih ketat akan digunakan untuk setiap kemungkinan pasangan pengambilan/pengiriman. Mulai 10/2017, rute alternatif hanya didukung jika durasi perjalanan tidak bergantung pada kendaraan.

int64

Jumlah muatan kendaraan yang melakukan kunjungan terkait akan bervariasi. Karena merupakan bilangan bulat, pengguna disarankan untuk memilih satuan yang sesuai agar tidak kehilangan presisi. Harus ≥ 0.

LatLng

Geo-lokasi tempat kendaraan tiba saat melakukan VisitRequest ini. Jika model pengiriman memiliki matriks jarak durasi, arrival_location tidak boleh ditentukan.

Waypoint

Titik jalan tempat kendaraan tiba saat melakukan VisitRequest ini. Jika model pengiriman memiliki matriks jarak durasi, arrival_waypoint tidak boleh ditentukan.

LatLng

Geo-lokasi tempat kendaraan berangkat setelah menyelesaikan VisitRequest ini. Dapat dihilangkan jika sama dengan arrival_location. Jika model pengiriman memiliki matriks jarak durasi, departure_location tidak boleh ditentukan.

Waypoint

Titik jalan tempat kendaraan berangkat setelah menyelesaikan VisitRequest ini. Dapat dihilangkan jika sama dengan arrival_waypoint. Jika model pengiriman memiliki matriks jarak durasi, departure_waypoint tidak boleh ditentukan.

string

Menentukan tag yang dilampirkan ke permintaan kunjungan. String kosong atau duplikat tidak diizinkan.

TimeWindow

Periode waktu yang membatasi waktu kedatangan pada kunjungan. Perhatikan bahwa kendaraan dapat berangkat di luar jangka waktu kedatangan, yaitu waktu kedatangan + durasi tidak harus berada dalam jangka waktu. Hal ini dapat menyebabkan waktu tunggu jika kendaraan tiba sebelum TimeWindow.start_time.

Tidak adanya TimeWindow berarti kendaraan dapat melakukan kunjungan ini kapan saja.

Periode waktu harus terpisah, yaitu tidak boleh tumpang-tindih atau berdekatan dengan periode waktu lain, dan harus dalam urutan menaik.

cost_per_hour_after_soft_end_time dan soft_end_time hanya dapat disetel jika ada satu jangka waktu.

Duration

Durasi kunjungan, yaitu waktu yang dihabiskan oleh kendaraan antara kedatangan dan keberangkatan (untuk ditambahkan ke kemungkinan waktu tunggu; lihat time_windows).

double

Biaya untuk melayani permintaan kunjungan ini di rute kendaraan. Hal ini dapat digunakan untuk membayar biaya yang berbeda untuk setiap pengambilan atau pengiriman alternatif kiriman. Biaya ini harus dalam unit yang sama dengan Shipment.penalty_cost dan tidak boleh negatif.

map<string, Load>

Memuat permintaan kunjungan ini. Kolom ini sama seperti kolom Shipment.load_demands, tetapi hanya berlaku untuk VisitRequest ini, bukan seluruh Shipment. Permintaan yang tercantum di sini ditambahkan ke permintaan yang tercantum di Shipment.load_demands.

string

Menentukan jenis kunjungan. Hal ini dapat digunakan untuk mengalokasikan waktu tambahan yang diperlukan kendaraan untuk menyelesaikan kunjungan ini (lihat Vehicle.extra_visit_duration_for_visit_type).

Jenis hanya dapat muncul satu kali.

string

Menentukan label untuk VisitRequest ini. Label ini dilaporkan dalam respons sebagai visit_label dalam ShipmentRoute.Visit yang sesuai.

bool

Menentukan apakah putar balik harus dihindari dalam rute mengemudi di lokasi ini. Penghindaran belokan U adalah upaya terbaik dan penghindaran lengkap tidak dijamin. Fitur ini bersifat eksperimental dan perilakunya dapat berubah.

Eksperimental: Lihat https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request untuk mengetahui detail selengkapnya.

Shipment

Kumpulan pengiriman yang harus dilakukan dalam model.

Vehicle

Kumpulan kendaraan yang dapat digunakan untuk melakukan kunjungan.

Objective

Kumpulan tujuan untuk model ini, yang akan kita ubah menjadi biaya. Jika tidak kosong, model input harus bebas biaya. Untuk mendapatkan permintaan yang diubah, gunakan solving_mode = TRANSFORM_AND_RETURN_REQUEST. Perhatikan bahwa permintaan tidak akan diselesaikan dalam kasus ini. Lihat dokumentasi yang sesuai.

Eksperimental: Lihat https://developers.google.com/maps/tt/route-optimization/experimental/objectives/make-request untuk mengetahui detail selengkapnya.

Timestamp

Waktu mulai dan berakhir global model: tidak ada waktu di luar rentang ini yang dapat dianggap valid.

Rentang waktu model harus kurang dari satu tahun, yaitu global_end_time dan global_start_time harus berjarak kurang dari 31536000 detik.

Saat menggunakan kolom cost_per_*hour, Anda mungkin ingin menyetel jangka waktu ini ke interval yang lebih kecil untuk meningkatkan performa (misalnya, jika Anda memodelkan satu hari, Anda harus menyetel batas waktu global ke hari tersebut). Jika tidak disetel, 00:00:00 UTC, 1 Januari 1970 (yaitu detik: 0, nanos: 0) akan digunakan sebagai default.

Timestamp

Jika tidak disetel, 00:00:00 UTC, 1 Januari 1971 (yaitu detik: 31536000, nanos: 0) akan digunakan sebagai default.

double

"Durasi global" keseluruhan paket adalah selisih antara waktu mulai berlaku paling awal dan waktu akhir berlaku paling akhir dari semua kendaraan. Pengguna dapat menetapkan biaya per jam untuk jumlah tersebut guna mencoba dan mengoptimalkan penyelesaian tugas paling awal, misalnya. Biaya ini harus dalam satuan yang sama dengan Shipment.penalty_cost.

DurationDistanceMatrix

Menentukan matriks durasi dan jarak yang digunakan dalam model. Jika kolom ini kosong, Google Maps atau jarak geodesi akan digunakan, bergantung pada nilai kolom use_geodesic_distances. Jika tidak kosong, use_geodesic_distances tidak boleh benar (true) dan duration_distance_matrix_src_tags maupun duration_distance_matrix_dst_tags tidak boleh kosong.

Contoh penggunaan:

• Ada dua lokasi: locA dan locB.
• 1 kendaraan memulai rutenya di locA dan mengakhirinya di locA.
• 1 permintaan kunjungan pengambilan di locB.

model {
  vehicles { start_tags: "locA"  end_tags: "locA" }
  shipments { pickups { tags: "locB" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_dst_tags: "locA"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrices {
    rows {  # from: locA
      durations { seconds: 0 }   meters: 0    # to: locA
      durations { seconds: 100 } meters: 1000 # to: locB
    }
    rows {  # from: locB
      durations { seconds: 102 } meters: 990 # to: locA
      durations { seconds: 0 }   meters: 0   # to: locB
    }
  }
}

• Ada tiga lokasi: locA, locB, dan locC.
• 1 kendaraan memulai rutenya di locA dan mengakhirinya di locB, menggunakan matriks "cepat".
• 1 kendaraan memulai rutenya di locB dan mengakhirinya di locB, menggunakan matriks "slow".
• 1 kendaraan memulai rutenya di locB dan mengakhirinya di locB, menggunakan matriks "fast".
• 1 permintaan kunjungan pengambilan di locC.

model {
  vehicles { start_tags: "locA" end_tags: "locB" start_tags: "fast" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "slow" }
  vehicles { start_tags: "locB" end_tags: "locB" start_tags: "fast" }
  shipments { pickups { tags: "locC" } }
  duration_distance_matrix_src_tags: "locA"
  duration_distance_matrix_src_tags: "locB"
  duration_distance_matrix_src_tags: "locC"
  duration_distance_matrix_dst_tags: "locB"
  duration_distance_matrix_dst_tags: "locC"
  duration_distance_matrices {
    vehicle_start_tag: "fast"
    rows {  # from: locA
      durations { seconds: 1000 } meters: 2000 # to: locB
      durations { seconds: 600 }  meters: 1000 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }   meters: 0    # to: locB
      durations { seconds: 700 } meters: 1200 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 702 } meters: 1190 # to: locB
      durations { seconds: 0 }   meters: 0    # to: locC
    }
  }
  duration_distance_matrices {
    vehicle_start_tag: "slow"
    rows {  # from: locA
      durations { seconds: 1800 } meters: 2001 # to: locB
      durations { seconds: 900 }  meters: 1002 # to: locC
    }
    rows {  # from: locB
      durations { seconds: 0 }    meters: 0    # to: locB
      durations { seconds: 1000 } meters: 1202 # to: locC
    }
    rows {  # from: locC
      durations { seconds: 1001 } meters: 1195 # to: locB
      durations { seconds: 0 }    meters: 0    # to: locC
    }
  }
}

string

Tag yang menentukan sumber matriks durasi dan jarak; duration_distance_matrices(i).rows(j) menentukan durasi dan jarak dari kunjungan dengan tag duration_distance_matrix_src_tags(j) ke kunjungan lain dalam matriks i.

Tag sesuai dengan VisitRequest.tags atau Vehicle.start_tags. VisitRequest atau Vehicle tertentu harus cocok dengan tepat satu tag di kolom ini. Perhatikan bahwa tag sumber, tujuan, dan matriks Vehicle dapat sama; demikian pula tag sumber dan tujuan VisitRequest dapat sama. Semua tag harus berbeda dan tidak boleh berupa string kosong. Jika kolom ini tidak kosong, duration_distance_matrices tidak boleh kosong.

string

Tag yang menentukan tujuan matriks durasi dan jarak; duration_distance_matrices(i).rows(j).durations(k) (masing-masing duration_distance_matrices(i).rows(j).meters(k)) menentukan durasi (atau jarak) perjalanan dari kunjungan dengan tag duration_distance_matrix_src_tags(j) ke kunjungan dengan tag duration_distance_matrix_dst_tags(k) dalam matriks i.

Tag sesuai dengan VisitRequest.tags atau Vehicle.start_tags. VisitRequest atau Vehicle tertentu harus cocok dengan tepat satu tag di kolom ini. Perhatikan bahwa tag sumber, tujuan, dan matriks Vehicle dapat sama; demikian pula tag sumber dan tujuan VisitRequest dapat sama. Semua tag harus berbeda dan tidak boleh berupa string kosong. Jika kolom ini tidak kosong, duration_distance_matrices tidak boleh kosong.

TransitionAttributes

Atribut transisi ditambahkan ke model.

ShipmentTypeIncompatibility

Kumpulan shipment_type yang tidak kompatibel (lihat ShipmentTypeIncompatibility).

ShipmentTypeRequirement

Kumpulan persyaratan shipment_type (lihat ShipmentTypeRequirement).

PrecedenceRule

Kumpulan aturan prioritas yang harus diterapkan dalam model.

PENTING: Penggunaan aturan prioritas membatasi ukuran masalah yang dapat dioptimalkan. Permintaan menggunakan aturan prioritas yang mencakup banyak pengiriman dapat ditolak.

int32

Membatasi jumlah maksimum kendaraan aktif. Kendaraan aktif jika rutenya melakukan minimal 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 subkumpulan kendaraan terbaik untuk digunakan. Harus benar-benar positif.

Row

Menentukan baris matriks durasi dan jarak. Jumlah elemennya harus sama dengan ShipmentModel.duration_distance_matrix_src_tags.

string

Tag yang menentukan kendaraan yang menerapkan matriks durasi dan jarak ini. Jika kosong, ini berlaku untuk semua kendaraan, dan hanya boleh ada satu matriks.

Setiap start kendaraan harus cocok dengan tepat satu matriks, yaitu tepat satu kolom start_tags harus cocok dengan vehicle_start_tag matriks (dan hanya matriks tersebut).

Semua matriks harus memiliki vehicle_start_tag yang berbeda.

Duration

Nilai durasi untuk baris tertentu. Jumlah elemennya harus sama dengan ShipmentModel.duration_distance_matrix_dst_tags.

double

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 durations.

Type

Jenis tujuan.

double

Seberapa besar bobot tujuan ini dibandingkan dengan tujuan lainnya. Nilai ini dapat berupa bilangan non-negatif apa pun, bobot tidak harus berjumlah 1. Bobot defaultnya adalah 1.0.

bool

Menunjukkan apakah peristiwa "pertama" adalah pengiriman.

bool

Menunjukkan apakah peristiwa "kedua" adalah pengiriman.

Duration

Selisih antara peristiwa "pertama" dan "kedua". Nilainya bisa negatif.

int32

Indeks pengiriman peristiwa "pertama". Kolom ini harus ditentukan.

int32

Indeks pengiriman peristiwa "kedua". Kolom ini harus ditentukan.

int32

Kendaraan yang melakukan rute, diidentifikasi berdasarkan indeksnya dalam ShipmentModel sumber.

string

Label kendaraan yang melakukan rute ini, sama dengan ShipmentModel.vehicles(vehicle_index).label, jika ditentukan.

Timestamp

Waktu saat kendaraan memulai rutenya.

Timestamp

Waktu saat kendaraan menyelesaikan rutenya.

Visit

Urutan kunjungan yang diurutkan yang merepresentasikan rute. visits[i] adalah kunjungan ke-i dalam rute. Jika kolom ini kosong, kendaraan dianggap tidak digunakan.

Transition

Daftar transisi yang diurutkan untuk rute.

bool

Jika OptimizeToursRequest.consider_road_traffic disetel ke benar (true), kolom ini menunjukkan bahwa inkonsistensi dalam waktu tempuh rute diprediksi menggunakan perkiraan durasi perjalanan berbasis lalu lintas. Mungkin tidak ada cukup waktu untuk menyelesaikan perjalanan yang disesuaikan dengan lalu lintas, keterlambatan, dan jeda di antara kunjungan, sebelum kunjungan pertama, atau setelah kunjungan terakhir, sambil tetap memenuhi jendela waktu kunjungan dan kendaraan. Misalnya,

  start_time(previous_visit) + duration(previous_visit) +
  travel_duration(previous_visit, next_visit) > start_time(next_visit)

Kedatangan di next_visit kemungkinan akan terjadi lebih lambat dari rentang waktu saat ini karena perkiraan waktu perjalanan yang meningkat travel_duration(previous_visit, next_visit) karena lalu lintas. Selain itu, istirahat dapat dipaksa tumpang-tindih dengan kunjungan karena peningkatan perkiraan waktu perjalanan dan batasan periode waktu istirahat atau kunjungan.

EncodedPolyline

Representasi polyline yang dienkode dari rute. Kolom ini hanya diisi jika OptimizeToursRequest.populate_polylines ditetapkan ke benar (true).

Break

Istirahat terjadwal untuk kendaraan yang melakukan rute ini. Urutan breaks mewakili interval waktu, yang masing-masing dimulai pada start_time yang sesuai dan berlangsung selama duration detik.

AggregatedMetrics

Metrik durasi, jarak, dan pemuatan untuk rute ini. Kolom AggregatedMetrics dijumlahkan di semua ShipmentRoute.transitions atau ShipmentRoute.visits, bergantung pada konteksnya.

VehicleFullness

Kolom VehicleFullness untuk menghitung seberapa dekat metrik yang dibatasi dengan batas kendaraan masing-masing. Kolomnya adalah rasio antara kolom metrik yang dibatasi (mis. AggregatedMetrics.travel_distance_meters) dan batas kendaraan terkait (mis. Vehicle.route_distance_limit).

Eksperimental: Perilaku atau keberadaan kolom ini dapat berubah di masa mendatang.

map<string, double>

Biaya rute, yang dikelompokkan berdasarkan kolom permintaan terkait biaya. Kuncinya adalah jalur proto, relatif terhadap input OptimizeToursRequest, misalnya "model.shipments.pickups.cost", dan nilainya adalah total biaya yang dihasilkan oleh kolom biaya yang sesuai, yang digabungkan di seluruh rute. Dengan kata lain, costs["model.shipments.pickups.cost"] adalah jumlah semua biaya pengambilan di rute tersebut. Semua biaya yang ditentukan dalam model dilaporkan secara mendetail di sini, kecuali biaya yang terkait dengan TransitionAttributes yang hanya dilaporkan secara gabungan mulai 01/2022.

double

Total biaya rute. Jumlah semua biaya dalam peta biaya.

Timestamp

Waktu mulai istirahat.

Duration

Durasi istirahat.

string

String yang merepresentasikan titik-titik polyline yang dienkode.

Duration

Durasi perjalanan selama transisi ini.

double

Jarak yang ditempuh selama transisi.

bool

Jika traffic diminta melalui OptimizeToursRequest.consider_road_traffic, dan info traffic tidak dapat diambil untuk Transition, boolean ini akan disetel ke benar (true). Hal ini mungkin bersifat sementara (gangguan langka di server lalu lintas real-time) atau permanen (tidak ada data untuk lokasi ini).

Duration

Jumlah durasi penundaan yang diterapkan pada transisi ini. Jika ada, penundaan dimulai tepat delay_duration detik sebelum peristiwa berikutnya (akhir kunjungan atau akhir perjalanan). Lihat TransitionAttributes.delay.

Duration

Jumlah durasi jeda yang terjadi selama transisi ini, jika ada. Detail tentang waktu mulai dan durasi setiap istirahat disimpan di ShipmentRoute.breaks.

Duration

Waktu yang dihabiskan untuk menunggu selama transisi ini. Durasi menunggu sesuai dengan waktu tidak ada aktivitas dan tidak termasuk waktu istirahat. Perhatikan juga bahwa waktu tunggu ini dapat dibagi menjadi beberapa interval yang tidak berdekatan.

Duration

Total durasi transisi, disediakan untuk kemudahan. Nilainya sama dengan:

• kunjungan berikutnya start_time (atau vehicle_end_time jika ini adalah transisi terakhir) - start_time transisi ini;
• Jika ShipmentRoute.has_traffic_infeasibilities salah (false), maka berlaku juga hal berikut: `total_duration = travel_duration + delay_duration
• break_duration + wait_duration`.

Timestamp

Waktu mulai transisi ini.

EncodedPolyline

Representasi polyline yang dienkode dari rute yang diikuti selama transisi. Kolom ini hanya diisi jika populate_transition_polylines ditetapkan ke benar (true).

string

Hanya output. Token buram yang dapat diteruskan ke Navigation SDK untuk merekonstruksi rute selama navigasi, dan, jika terjadi pengalihan rute, menghormati niat awal saat rute dibuat. Perlakukan token ini sebagai blob buram. Jangan bandingkan nilainya di seluruh permintaan karena nilainya dapat berubah meskipun layanan menampilkan rute yang sama persis. Kolom ini hanya diisi jika populate_transition_polylines ditetapkan ke benar (true).

map<string, VehicleLoad>

Muatan kendaraan selama transisi ini, untuk setiap jenis yang muncul di Vehicle.load_limits kendaraan ini, atau yang memiliki Shipment.load_demands tidak nol pada beberapa pengiriman yang dilakukan di rute ini.

Muatan selama transisi pertama adalah muatan awal rute kendaraan. Kemudian, setelah setiap kunjungan, load_demands kunjungan ditambahkan atau dikurangi untuk mendapatkan pemuatan transisi berikutnya, bergantung pada apakah kunjungan tersebut berupa pengambilan atau pengiriman.

int64

Jumlah beban pada kendaraan, untuk jenis tertentu. Unit beban biasanya ditunjukkan oleh jenisnya. Lihat Transition.vehicle_loads.

int32

Indeks kolom shipments di ShipmentModel sumber.

bool

Jika benar (true), kunjungan sesuai dengan pengambilan Shipment. Jika tidak, nilai ini sesuai dengan pengiriman.

int32

Indeks VisitRequest di kolom pengambilan atau pengiriman Shipment (lihat is_pickup).

Timestamp

Waktu saat kunjungan dimulai. Perhatikan bahwa kendaraan dapat tiba lebih awal dari waktu ini di lokasi kunjungan. Waktu konsisten dengan ShipmentModel.

map<string, Load>

Total permintaan pemuatan kunjungan sebagai jumlah pengiriman dan permintaan kunjungan load_demands. Nilainya negatif jika kunjungan adalah pengiriman. Permintaan dilaporkan untuk jenis yang sama dengan Transition.loads (lihat kolom ini).

Duration

Waktu perjalanan tambahan karena pengiriman yang dikunjungi di rute sebelum kunjungan dan potensi waktu tunggu yang disebabkan oleh rentang waktu. Jika kunjungan adalah pengiriman, pengalihan rute dihitung dari kunjungan pengambilan yang sesuai dan sama dengan:

start_time(delivery) - start_time(pickup)
- (duration(pickup) + travel duration from the pickup location
to the delivery location).

Jika tidak, nilai ini dihitung dari start_location kendaraan dan sama dengan:

start_time - vehicle_start_time - travel duration from
the vehicle's `start_location` to the visit.

string

Salinan Shipment.label yang sesuai, jika ditentukan dalam Shipment.

string

Salinan VisitRequest.label yang sesuai, jika ditentukan dalam VisitRequest.

int32

Token buram yang merepresentasikan informasi tentang lokasi kunjungan.

Kolom ini dapat diisi dalam kunjungan rute hasil jika VisitRequest.avoid_u_turns disetel ke benar untuk kunjungan ini atau jika ShipmentModel.avoid_u_turns disetel ke benar dalam OptimizeToursRequest permintaan.

Eksperimental: Lihat https://developers.google.com/maps/tt/route-optimization/experimental/u-turn-avoidance/make-request untuk mengetahui detail selengkapnya.

string

Daftar jenis yang tidak kompatibel. Dua pengiriman yang memiliki shipment_types berbeda di antara yang tercantum adalah "tidak kompatibel".

IncompatibilityMode

Mode yang diterapkan pada inkompatibilitas.

string

Daftar jenis pengiriman alternatif yang diperlukan oleh dependent_shipment_types.

string

Semua pengiriman dengan jenis di kolom dependent_shipment_types memerlukan setidaknya satu pengiriman jenis required_shipment_type_alternatives untuk dikunjungi di rute yang sama.

CATATAN: Rantai persyaratan yang membuat shipment_type bergantung pada dirinya sendiri tidak diizinkan.

RequirementMode

Mode yang diterapkan pada persyaratan.

int32

Indeks sesuai dengan indeks pengiriman dalam ShipmentModel sumber.

string

Salinan Shipment.label yang sesuai, jika ditentukan dalam Shipment.

Reason

Daftar alasan yang menjelaskan mengapa pengiriman dilewati. Lihat komentar di atas Reason. Jika kami tidak dapat memahami alasan pengiriman dilewati, alasan tidak akan ditetapkan.

double

Ini adalah salinan Shipment.penalty_cost, yang disertakan di sini untuk mempermudah melihat tingkat keparahan pengiriman yang dilewati.

Eksperimental: Perilaku atau keberadaan kolom ini dapat berubah di masa mendatang.

double

Perkiraan rasio kendaraan yang tidak dapat melakukan pengiriman ini karena setidaknya salah satu alasan di bawah. Catatan: kolom ini hanya diisi jika alasannya melibatkan kendaraan.

Eksperimental: Perilaku atau keberadaan kolom ini dapat berubah di masa mendatang.

Code

Lihat komentar Kode.

int32

Sama seperti example_vehicle_index, kecuali kami memberikan daftar beberapa kendaraan yang teridentifikasi. Daftar ini tidak selalu lengkap. Kolom ini hanya diisi jika [fill_example_vehicle_indices_in_skipped_reasons][] benar (true).

Eksperimental: Perilaku atau keberadaan kolom ini dapat berubah di masa mendatang.

string

Jika kode alasan adalah DEMAND_EXCEEDS_VEHICLE_CAPACITY, dokumen satu jenis kapasitas yang terlampaui.

int32

Jika alasannya terkait dengan ketidakcocokan kendaraan pengiriman, kolom ini memberikan indeks salah satu kendaraan yang relevan.

Timestamp

Waktu mulai periode waktu tetap. Jika tidak ditentukan, nilainya akan ditetapkan ke ShipmentModel.global_start_time.

Timestamp

Waktu berakhir periode waktu tetap. Jika tidak ditentukan, nilainya akan ditetapkan ke ShipmentModel.global_end_time.

Timestamp

Waktu mulai lembut periode waktu.

Timestamp

Waktu berakhir sementara periode waktu.

double

Biaya per jam ditambahkan ke biaya lain dalam model jika peristiwa terjadi sebelum soft_start_time, dihitung sebagai:

   max(0, soft_start_time - t.seconds)
                          * cost_per_hour_before_soft_start_time / 3600,
t being the time of the event.

Biaya ini harus positif, dan kolom hanya dapat ditetapkan jika soft_start_time telah ditetapkan.

double

Biaya per jam ditambahkan ke biaya lain dalam model jika peristiwa terjadi setelah soft_end_time, yang dihitung sebagai:

   max(0, t.seconds - soft_end_time.seconds)
                    * cost_per_hour_after_soft_end_time / 3600,
t being the time of the event.

Biaya ini harus positif, dan kolom hanya dapat ditetapkan jika soft_end_time telah ditetapkan.

string

Tag yang menentukan kumpulan transisi (src->dst) yang berlaku untuk atribut ini.

Kunjungan sumber atau awal kendaraan cocok jika VisitRequest.tags atau Vehicle.start_tags berisi src_tag atau tidak berisi excluded_src_tag (bergantung pada kolom mana yang tidak kosong).

string

Lihat src_tag. Tepat satu dari src_tag dan excluded_src_tag tidak boleh kosong.

string

Kunjungan tujuan atau akhir kendaraan cocok jika VisitRequest.tags atau Vehicle.end_tags berisi dst_tag atau tidak berisi excluded_dst_tag (bergantung pada kolom mana dari kedua kolom ini yang tidak kosong).

string

Lihat dst_tag. Tepat satu dari dst_tag dan excluded_dst_tag tidak boleh kosong.

double

Menentukan biaya untuk melakukan transisi ini. Nilai ini berada dalam unit yang sama dengan semua biaya lainnya dalam model dan tidak boleh negatif. Biaya ini diterapkan di atas semua biaya yang ada.

double

Menentukan biaya per kilometer yang diterapkan pada jarak yang ditempuh saat melakukan transisi ini. Nilai ini ditambahkan ke Vehicle.cost_per_kilometer yang ditentukan pada kendaraan.

DistanceLimit

Menentukan batas jarak yang ditempuh saat melakukan transisi ini.

Mulai 2021/06, hanya batas lunak yang didukung.

Duration

Menentukan penundaan yang terjadi saat melakukan transisi ini.

Penundaan ini selalu terjadi setelah menyelesaikan kunjungan sumber dan sebelum memulai kunjungan tujuan.

string

URI resource. Resource mungkin belum ada.

Konten resource dienkode sebagai JSON atau textproto. Hanya resource Google Cloud Storage yang didukung. Jika resource dienkode sebagai JSON, nama resource harus diberi akhiran .json. Jika resource dienkode sebagai textproto, nama resource harus memiliki akhiran .txtpb. Misalnya, URI Google Cloud Storage ke file yang dienkode JSON mungkin terlihat seperti: gs://bucket/path/input/object.json.

string

Nama tampilan kendaraan yang ditentukan pengguna. Panjangnya bisa mencapai 63 karakter dan dapat menggunakan karakter UTF-8.

TravelMode

Mode perjalanan yang memengaruhi jalan yang dapat digunakan oleh kendaraan dan kecepatannya. Lihat juga travel_duration_multiple.

RouteModifiers

Kumpulan kondisi yang harus dipenuhi yang memengaruhi cara penghitungan rute untuk kendaraan tertentu.

LatLng

Lokasi geografis tempat kendaraan memulai perjalanan sebelum mengambil kiriman. Jika tidak ditentukan, kendaraan akan memulai perjalanan dari lokasi penjemputan pertamanya. Jika model pengiriman memiliki matriks durasi dan jarak, start_location tidak boleh ditentukan.

Waypoint

Titik jalan yang merepresentasikan lokasi geografis tempat kendaraan memulai perjalanan sebelum mengambil pengiriman. Jika start_waypoint maupun start_location tidak ditentukan, kendaraan akan memulai perjalanan di lokasi penjemputan pertamanya. Jika model pengiriman memiliki matriks durasi dan jarak, start_waypoint tidak boleh ditentukan.

LatLng

Lokasi geografis tempat kendaraan berakhir setelah menyelesaikan VisitRequest terakhirnya. Jika tidak ditentukan, ShipmentRoute kendaraan akan segera berakhir saat menyelesaikan VisitRequest terakhirnya. Jika model pengiriman memiliki matriks durasi dan jarak, end_location tidak boleh ditentukan.

Waypoint

Titik jalan yang merepresentasikan lokasi geografis tempat kendaraan berakhir setelah menyelesaikan VisitRequest terakhirnya. Jika end_waypoint maupun end_location tidak ditentukan, ShipmentRoute kendaraan akan segera berakhir saat kendaraan menyelesaikan VisitRequest terakhirnya. Jika model pengiriman memiliki matriks durasi dan jarak, end_waypoint tidak boleh ditentukan.

string

Menentukan tag yang dilampirkan ke awal rute kendaraan.

String kosong atau duplikat tidak diizinkan.

string

Menentukan tag yang dilampirkan di akhir rute kendaraan.

String kosong atau duplikat tidak diizinkan.

TimeWindow

Periode waktu saat kendaraan dapat berangkat dari lokasi awalnya. Nilai harus berada dalam batas waktu global (lihat kolom ShipmentModel.global_*). Jika tidak ditentukan, tidak ada batasan selain batas waktu global tersebut.

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 harus dalam urutan kronologis.

cost_per_hour_after_soft_end_time dan soft_end_time hanya dapat disetel jika ada satu jangka waktu.

TimeWindow

Rentang waktu saat kendaraan dapat tiba di lokasi akhir. Nilai harus berada dalam batas waktu global (lihat kolom ShipmentModel.global_*). Jika tidak ditentukan, tidak ada batasan selain batas waktu global tersebut.

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 harus dalam urutan kronologis.

cost_per_hour_after_soft_end_time dan soft_end_time hanya dapat disetel jika ada satu jangka waktu.

UnloadingPolicy

Kebijakan pembongkaran diterapkan pada kendaraan.

map<string, LoadLimit>

Kapasitas kendaraan (berat, volume, jumlah palet, misalnya). Kunci dalam peta adalah ID jenis beban, yang konsisten dengan kunci kolom Shipment.load_demands. Jika kunci tertentu tidak ada dalam peta ini, kapasitas yang sesuai dianggap tidak terbatas.

double

Biaya kendaraan: semua biaya dijumlahkan dan harus dalam unit yang sama dengan Shipment.penalty_cost.

Biaya per jam rute kendaraan. Biaya ini diterapkan pada total waktu yang dibutuhkan oleh rute, dan mencakup waktu perjalanan, waktu tunggu, dan waktu kunjungan. Menggunakan cost_per_hour, bukan hanya cost_per_traveled_hour, dapat menyebabkan latensi tambahan.

double

Biaya per jam perjalanan rute kendaraan. Biaya ini hanya berlaku untuk waktu tempuh yang diperlukan oleh rute (yaitu, yang dilaporkan dalam ShipmentRoute.transitions), dan tidak termasuk waktu tunggu dan waktu kunjungan.

double

Biaya per kilometer rute kendaraan. Biaya ini diterapkan pada jarak yang dilaporkan di ShipmentRoute.transitions dan tidak berlaku untuk jarak yang ditempuh secara implisit dari arrival_location ke departure_location dari satu VisitRequest.

double

Biaya tetap diterapkan jika kendaraan ini digunakan untuk menangani pengiriman.

bool

Kolom ini hanya berlaku untuk kendaraan yang rutenya tidak melayani pengiriman apa pun. Hal ini menunjukkan apakah kendaraan harus dianggap sebagai bekas atau tidak dalam kasus ini.

Jika benar, kendaraan akan bergerak dari lokasi awal ke lokasi akhir meskipun tidak melayani pengiriman apa pun, dan biaya waktu serta jarak yang dihasilkan dari perjalanan awal --> akhir akan diperhitungkan.

Jika tidak, kendaraan tidak melakukan perjalanan dari lokasi awal ke lokasi akhir, dan tidak ada break_rule atau keterlambatan (dari TransitionAttributes) yang dijadwalkan untuk kendaraan ini. Dalam hal ini, ShipmentRoute kendaraan tidak berisi informasi apa pun kecuali indeks dan label kendaraan.

DurationLimit

Batas diterapkan pada total durasi rute kendaraan. Dalam OptimizeToursResponse tertentu, durasi rute kendaraan adalah selisih antara vehicle_end_time dan vehicle_start_time.

DurationLimit

Batas yang diterapkan pada durasi perjalanan rute kendaraan. Dalam OptimizeToursResponse tertentu, durasi perjalanan rute adalah jumlah semua transitions.travel_duration-nya.

DistanceLimit

Batas diterapkan pada total jarak rute kendaraan. Dalam OptimizeToursResponse tertentu, jarak rute adalah jumlah semua transitions.travel_distance_meters-nya.

map<string, Duration>

Menentukan peta dari string visit_types ke durasi. Durasi adalah waktu selain VisitRequest.duration yang harus diambil saat kunjungan dengan visit_types yang ditentukan. Durasi kunjungan tambahan ini akan menambah biaya jika cost_per_hour ditentukan. Kunci (yaitu visit_types) tidak boleh berupa string kosong.

Jika permintaan kunjungan memiliki beberapa jenis, durasi akan ditambahkan untuk setiap jenis di peta.

BreakRule

Mendeskripsikan jadwal istirahat yang akan diterapkan pada kendaraan ini. Jika kosong, tidak ada istirahat yang akan dijadwalkan untuk kendaraan ini.

string

Menentukan label untuk kendaraan ini. Label ini dilaporkan dalam respons sebagai vehicle_label dari ShipmentRoute yang sesuai.

bool

Jika benar, used_if_route_is_empty harus salah, dan kendaraan ini akan tetap tidak digunakan.

Jika pengiriman dilakukan oleh kendaraan yang diabaikan di injected_first_solution_routes, pengiriman tersebut akan dilewati dalam solusi pertama, tetapi dapat dilakukan dalam respons.

Jika pengiriman dilakukan oleh kendaraan yang diabaikan di injected_solution_constraint dan pengambilan/pengiriman terkait dibatasi untuk tetap berada di kendaraan (yaitu, tidak dilonggarkan ke level RELAX_ALL_AFTER_THRESHOLD), pengiriman tersebut akan dilewati dalam respons. Jika pengiriman memiliki kolom allowed_vehicle_indices yang tidak kosong dan semua kendaraan yang diizinkan diabaikan, pengiriman tersebut akan dilewati dalam respons.

double

Menentukan faktor perkalian yang dapat digunakan untuk menambah atau mengurangi waktu perjalanan kendaraan ini. Misalnya, menyetelnya ke 2,0 berarti kendaraan ini lebih lambat dan memiliki waktu perjalanan dua kali lebih lama dibandingkan kendaraan standar. Pengganda ini tidak memengaruhi durasi kunjungan. Hal ini memengaruhi biaya jika cost_per_hour atau cost_per_traveled_hour ditentukan. Nilai ini harus dalam rentang [0.001, 1000.0]. Jika tidak disetel, kendaraan adalah standar, dan kelipatan ini dianggap 1,0.

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 extra_visit_duration_for_visit_type di bawah.

Duration

Batas ketat yang membatasi durasi menjadi paling lama max_duration.

Duration

Batas lunak yang tidak menerapkan batas durasi maksimum, tetapi jika dilanggar, rute akan dikenai biaya. Biaya ini ditambahkan ke biaya lain yang ditentukan dalam model, dengan unit yang sama.

Jika ditentukan, soft_max_duration tidak boleh negatif. Jika max_duration juga ditentukan, soft_max_duration harus kurang dari max_duration.

Duration

Batas lunak tidak memberlakukan batas durasi maksimum, tetapi jika dilanggar, rute akan dikenai biaya, kuadrat dalam durasi. Biaya ini ditambahkan ke biaya lain yang ditentukan dalam model, dengan unit yang sama.

Jika ditentukan, quadratic_soft_max_duration tidak boleh negatif. Jika max_duration juga ditentukan, quadratic_soft_max_duration harus kurang dari max_duration, dan perbedaannya tidak boleh lebih besar dari satu hari:

max_duration - quadratic_soft_max_duration <= 86400 seconds

double

Biaya per jam yang dikenakan jika batas soft_max_duration dilanggar. Biaya tambahan adalah 0 jika durasinya di bawah nilai minimum, jika tidak, biaya bergantung pada durasi sebagai berikut:

  cost_per_hour_after_soft_max * (duration - soft_max_duration)

Biaya tidak boleh negatif.

double

Biaya per jam persegi yang dikenakan jika batas quadratic_soft_max_duration dilanggar.

Biaya tambahan adalah 0 jika durasinya di bawah nilai minimum, jika tidak, biaya bergantung pada durasi sebagai berikut:

  cost_per_square_hour_after_quadratic_soft_max *
  (duration - quadratic_soft_max_duration)^2

Biaya tidak boleh negatif.

int64

Batas lunak beban. Lihat cost_per_unit_above_soft_max.

double

Jika beban pernah melebihi soft_max_load di sepanjang rute kendaraan ini, penalti biaya berikut akan berlaku (hanya sekali per kendaraan): (beban - soft_max_load) * cost_per_unit_above_soft_max. Semua biaya dijumlahkan dan harus dalam satuan yang sama dengan Shipment.penalty_cost. Batas lunak hanya dapat ditentukan pada jenis yang berlaku untuk pengambilan saja atau pengiriman saja di seluruh model.

Interval

Interval muatan yang dapat diterima dari kendaraan di awal rute.

Interval

Interval muatan yang dapat diterima dari kendaraan di akhir rute.

int64

Jumlah beban maksimum yang dapat diterima.

LoadCost

Biaya memindahkan satu unit muatan sejauh satu kilometer untuk kendaraan ini. Hal ini dapat digunakan sebagai pengganti konsumsi bahan bakar: jika beban adalah berat (dalam Newton), maka beban*kilometer memiliki dimensi energi.

Eksperimental: Lihat https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request untuk mengetahui detail selengkapnya.

LoadCost

Biaya perjalanan dengan satu unit muatan selama satu jam untuk kendaraan ini.

Eksperimental: Lihat https://developers.google.com/maps/tt/route-optimization/experimental/load-cost/make-request untuk mengetahui detail selengkapnya.

int64

Beban minimum yang dapat diterima. Harus ≥ 0. Jika keduanya ditentukan, min harus ≤ max.

int64

Beban maksimum yang dapat diterima. Harus ≥ 0. Jika tidak ditentukan, beban maksimum tidak dibatasi oleh pesan ini. Jika keduanya ditentukan, min harus ≤ max.

int64

Jumlah muatan di atasnya biaya pemindahan satu unit muatan berubah dari cost_per_unit_below_threshold menjadi cost_per_unit_above_threshold. Harus >= 0.

double

Biaya pemindahan unit beban, untuk setiap unit antara 0 dan nilai minimum. Harus berupa nilai terbatas, dan >= 0.

double

Biaya pemindahan satu unit beban, untuk setiap unit di atas nilai minimum. Dalam kasus khusus dengan nilai minimum = 0, ini adalah biaya tetap per unit. Harus berupa nilai terbatas, dan >= 0.

double

Maksimum semua kolom lainnya dalam pesan ini.

double

Rasio antara AggregatedMetrics.travel_distance_meters dan Vehicle.route_distance_limit. Jika Vehicle.route_distance_limit tidak ditetapkan, kolom ini juga tidak akan ditetapkan.

double

Rasio antara [AggregatedMetrics.travel_duration_seconds][] dan Vehicle.travel_duration_limit. Jika Vehicle.travel_duration_limit tidak ditetapkan, kolom ini juga tidak akan ditetapkan.

double

Rasio antara [AggregatedMetrics.total_duration_seconds][] dan Vehicle.route_duration_limit. Jika Vehicle.route_duration_limit tidak ditetapkan, kolom ini juga tidak akan ditetapkan.

double

Rasio maksimum di antara semua jenis [AggregatedMetrics.max_load][] dan Vehicle.load_limits masing-masing. Jika semua kolom Vehicle.load_limits tidak ditetapkan, kolom ini juga tidak akan ditetapkan.

double

Rasio (vehicle_end_time - vehicle_start_time) / (latest_vehicle_end_time - earliest_vehicle_start_time) untuk kendaraan tertentu. Jika penyebut tidak ada, (ShipmentModel.global_end_time - ShipmentModel.global_start_time) akan digunakan sebagai gantinya.

bool

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 cenderung mengarah ke lokasi dari tengah jalan. Opsi ini tidak berfungsi untuk mode perjalanan 'BERJALAN KAKI'.

bool

Menunjukkan bahwa titik jalan ditujukan agar kendaraan berhenti di sana, dengan maksud untuk menjemput atau mengantar. Opsi ini hanya berfungsi untuk mode perjalanan 'DRIVING', dan saat 'location_type' adalah 'location'.

Eksperimental: Perilaku atau keberadaan kolom ini dapat berubah di masa mendatang.

Location

Titik yang ditentukan menggunakan koordinat geografis, termasuk arah opsional.

string

ID tempat POI yang terkait dengan titik jalan.

Saat menggunakan ID tempat untuk menentukan lokasi kedatangan atau keberangkatan VisitRequest, gunakan ID tempat yang cukup spesifik untuk menentukan lokasi LatLng untuk navigasi ke tempat tersebut. Misalnya, ID tempat yang merepresentasikan bangunan cocok, tetapi ID tempat yang merepresentasikan jalan tidak disarankan.