Method: projects.locations.optimizeTours

string (Duration format)

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.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

object (ShipmentModel)

Model pengiriman yang akan diselesaikan.

enum (SolvingMode)

Secara default, mode penyelesaiannya adalah DEFAULT_SOLVE (0).

enum (SearchMode)

Mode penelusuran yang digunakan untuk menyelesaikan permintaan.

object (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, vehicleIndex harus berada dalam rentang dan tidak boleh diduplikasi.
• untuk semua kunjungan, shipmentIndex dan visitRequestIndex 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, vehicleStartTime <= visits[0].start_time <= visits[1].start_time ... <= vehicleEndTime).
• pengiriman hanya dapat dilakukan pada kendaraan yang diizinkan. Kendaraan diizinkan jika Shipment.allowed_vehicle_indices kosong atau vehicleIndex-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.

object (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.

object (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 populatePolylines bernilai benar (true).

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

Kolom ini tidak boleh digunakan bersama dengan injectedFirstSolutionRoutes atau injectedSolutionConstraint.

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.

boolean

Jika benar:

• menggunakan ShipmentRoute.vehicle_label, bukan vehicleIndex, 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 vehicleIndex asli yang sama).
• menggunakan ShipmentRoute.Visit.shipment_label, bukan shipmentIndex, 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 injectedFirstSolutionRoutes, injectedSolutionConstraint, dan refreshDetailsRoutes. 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 shipmentLabel-nya harus muncul dua kali).

Jika vehicleLabel dalam solusi yang disisipkan tidak sesuai dengan kendaraan permintaan, rute yang sesuai akan dihapus dari solusi beserta kunjungan rutenya. Jika shipmentLabel 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.

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

string

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

number

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

integer

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 solvingMode=VALIDATE_ONLY: lihat kolom OptimizeToursResponse.validation_errors. Nilai defaultnya adalah 100 dan dibatasi hingga 10.000.