Route Optimization API menetapkan tugas dan rute ke armada kendaraan, dengan mengoptimalkan tujuan dan batasan yang Anda berikan, seperti rentang waktu, kapasitas kendaraan, jam kerja pengemudi, dan biaya. Anda memanggilnya melalui REST, gRPC, atau library klien, dan API ini akan menampilkan urutan kunjungan, penetapan pengiriman, perkiraan waktu, dan metrik rute.
Route Optimization API: fakta penting
- Produk: Route Optimization API
- Juga dikenal sebagai: GMPRO
- Kategori: Rute
- Platform: Layanan web (REST)
- Berjalan di: Server (kode backend)
- Tahap peluncuran: GA
- Siklus proses: Aktif
- Ringkasan: Ringkasan Route Optimization API
Route Optimization API: kapan harus menggunakannya
Gunakan Route Optimization API jika:
- Anda perlu menetapkan pengiriman atau tugas ke beberapa kendaraan dengan mempertimbangkan rentang waktu, kapasitas kendaraan, jam kerja pengemudi, dan biaya.
- Anda memerlukan urutan perhentian terbaik untuk satu kendaraan dengan beberapa penjemputan, pengiriman, atau janji temu.
- Anda perlu mengoptimalkan ulang rute aktif untuk pesanan baru (seperti pengiriman on-demand) menggunakan
injectedFirstSolutionRoutesatauinjectedSolutionConstraint. - Anda memerlukan token rute untuk setiap segmen rencana yang dioptimalkan untuk diteruskan ke Navigation SDK.
Jangan gunakan Route Optimization API jika:
- Anda memerlukan pelacakan langsung tentang cara pengemudi menjalankan rencana; API menampilkan polyline yang direncanakan, bukan rute kendaraan real-time. Gunakan Fleet Engine Service sebagai gantinya.
- Anda memerlukan panduan belokan demi belokan dalam aplikasi untuk pengemudi di sepanjang rute yang dioptimalkan. Gunakan Navigation SDK for Android.
- Anda memerlukan panduan belokan demi belokan dalam aplikasi untuk pengemudi di iOS di sepanjang rute yang dioptimalkan. Gunakan Navigation SDK for iOS.
Route Optimization API: penyiapan
- Layanan yang akan diaktifkan:
routeoptimization.googleapis.com - Autentikasi: OAuth 2.0, Akun layanan
- Memulai: Menyiapkan Route Optimization API
- Referensi: Referensi Route Optimization API
- Harga: Penggunaan dan penagihan Route Optimization API
- Kebijakan: Kebijakan Route Optimization API
- Catatan rilis: Catatan rilis Route Optimization API
Paket Route Optimization API resmi:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
Route Optimization API: produk terkait
- Sering digunakan dengan: Navigation SDK for Android, Navigation SDK for iOS, Fleet Engine Service, Maps JavaScript API
Route Optimization API: kesalahan umum
- Masalah: Untuk panggilan REST ke endpoint
OptimizeTourspemblokiran, batas waktu default 60 detik akan menggantikantimeoutisi permintaan yang lebih besar dari 60 detik. Perbaikan: Tetapkan headerX-Server-Timeout(detik, tanpa akhiran "s") untuk memperpanjang batas waktu. Library klien dan gRPC ditetapkan secara default ke 3.600 detik. Lihat /maps/documentation/route-optimization/timeouts. - Masalah: Nilai
timeoutdan batas waktu dibatasi hingga 1.800 detik. Perbaikan: TetapkanallowLargeDeadlineDespiteInterruptionRiskketrueuntuk mengizinkan hingga 3.600 detik, dengan menerima risiko error gangguan yang lebih tinggi. Lihat /maps/documentation/route-optimization/timeouts. - Masalah: Tanpa parameter biaya (misalnya
costPerHourataucostPerKilometer), pengoptimal akan memperlakukan semua solusi sebagai sama. Perbaikan: Tentukan parameter biaya pada kendaraan yang mencerminkan biaya bisnis Anda. Lihat /maps/documentation/route-optimization/make-first-request. - Masalah: Permintaan yang diautentikasi dengan kunci API gagal; setiap permintaan memerlukan token OAuth. Perbaikan: Gunakan token OAuth dengan cakupan
https://www.googleapis.com/auth/cloud-platform, misalnya melalui Kredensial Default Aplikasi atau akun layanan. Lihat /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token.
Yang dapat Anda lakukan dengan Route Optimization API
Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.
- Menampilkan rencana pengiriman multi-pemberhentian, yang dioptimalkan berdasarkan batasan rute, biaya, pengiriman, dan kendaraan yang ditentukan.
- Menampilkan waktu mulai dan berakhir untuk setiap perhentian pada rencana pengiriman yang dioptimalkan.
- Menampilkan durasi perjalanan, penundaan, istirahat, dan tunggu di antara setiap perhentian pada rencana pengiriman yang dioptimalkan.
- Menampilkan informasi muatan kendaraan di setiap perhentian pada rencana pengiriman yang dioptimalkan.
- Menampilkan informasi biaya untuk setiap pengiriman dalam rencana pengiriman yang dioptimalkan.
- Menampilkan polyline yang dienkode untuk rute di antara setiap perhentian pada rencana pengiriman yang dioptimalkan.
- Menampilkan token rute navigasi untuk rute di antara setiap perhentian pada rencana pengiriman yang dioptimalkan.
- Menampilkan metrik pengiriman, kendaraan, dan biaya gabungan untuk rencana pengiriman yang dioptimalkan.
- Tentukan rentang waktu mulai dan berakhir untuk rencana pengiriman multi-pemberhentian.
- Tentukan ketersediaan waktu mulai dan berakhir serta lokasi untuk setiap kendaraan dalam rencana pengiriman multi-perhentian.
- Tentukan biaya waktu kendaraan untuk setiap kendaraan dalam rencana pengiriman multi-perhentian.
- Menentukan parameter model biaya untuk rencana pengiriman multi-pemberhentian.
- Tentukan batasan waktu pengambilan dan pengiriman untuk setiap pengiriman dalam rencana pengiriman multi-pemberhentian.
- Menentukan penetapan kendaraan untuk rencana pengiriman multi-perhentian.
- Tentukan batas muatan untuk setiap kendaraan dalam rencana pengiriman multi-perhentian.
- Tentukan apakah akan mempertimbangkan informasi lalu lintas langsung untuk rencana pengiriman multi-perhentian.
- Memproses permintaan pengoptimalan rencana pengiriman multi-pemberhentian secara batch dan menulis respons ke Google Cloud Storage.
- Sediakan waktu untuk parkir sebelum melakukan pengiriman.
- Prioritaskan kunjungan ke lokasi yang berdekatan untuk dilakukan secara berurutan.
- Menghindari putar balik di rute kendaraan dengan beberapa perhentian. Eksperimental Catatan: Fitur eksperimental; tunduk pada persyaratan dan batasan pra-GA.
- Optimalkan untuk tujuan yang telah ditentukan. Eksperimental Catatan: Fitur eksperimental; tunduk pada persyaratan dan batasan pra-GA.
- Kirim pengiriman yang lebih berat terlebih dahulu. Eksperimental Catatan: Fitur eksperimental; tunduk pada persyaratan dan batasan pra-GA.