Membandingkan OptimizeTours dan BatchOptimizeTours

Route Optimization API menampilkan dua metode:

  • OptimizeTours adalah metode sinkron yang menampilkan rute yang dioptimalkan dalam respons terhadap OptimizeToursRequest. Klien harus menjaga agar koneksi ke Route Optimization API hingga permintaan diproses dan OptimizeToursResponse atau error ditampilkan.
  • BatchOptimizeTours adalah metode asinkron yang menerima URI untuk satu atau lebih OptimizeToursRequest dan OptimizeToursResponse yang sesuai pesan, yang menampilkan nama resource Long Running Operation (LRO) (REST, gRPC) yang digunakan untuk memeriksa penyelesaian batch. OptimizeToursRequest diproses di latar belakang, sehingga klien dapat mempertahankan koneksi terbuka ke Route Optimization API hanya cukup lama untuk mengirimkan BatchOptimizeToursRequest atau hubungi GetOperation untuk memeriksa LRO . BatchOptimizeTours membaca permintaan dari dan menulis respons ke Google Cloud Storage.

Kasus Penggunaan

OptimizeTours cocok untuk menyelesaikan permintaan kecil dan sederhana, atau untuk permintaan dengan waktu penyelesaian beberapa menit atau kurang. Mempertahankan umur panjang koneksi ke Route Optimization API meningkatkan risiko gangguan sebelum solusi dapat dikembalikan.

BatchOptimizeTours dapat menangani permintaan dan permintaan yang lebih besar dengan penyelesaian yang lebih lama waktu lama karena tidak memerlukan koneksi berjangka panjang ke Rute Optimization API.

Operasi yang Berjalan Lama

LLO dibaca dari Route Optimization API menggunakan metode GetOperation untuk memeriksa status penyelesaian batch. LLO menyertakan properti done yang menunjukkan apakah pemrosesan seluruh batch telah selesai dan error yang melaporkan error yang ditemukan selama pemrosesan. Jika done benar dan tidak ada error, artinya batch berhasil diselesaikan. Adanya error menunjukkan bahwa beberapa atau semua batch gagal diproses.

Siklus proses umum permintaan BatchOptimizeTours adalah sebagai berikut:

  1. Kirimkan BatchOptimizeToursRequest ke Route Optimization API, yang mengembalikan nama resource LRO.
  2. Polling GetOperation dengan nama resource LRO yang ditampilkan hingga done atau Properti error akan muncul dalam respons LRO.
  3. Jika done benar dan tidak ada error, baca OptimizeToursResponses dari URI Google Cloud Storage yang ditentukan dalam BatchOptimizeTours permintaan. Jika error ada, periksa error, perbarui OptimizeToursRequest sesuai kebutuhan di Google Cloud Storage, dan coba lagi saat sesuai tergantung pada error yang diamati.

Anda dapat mengirim permintaan OptimizeTours dan BatchOptimizeTours dalam berbagai baik dari baris perintah atau menggunakan pustaka klien.

Berikutnya: Membuat Permintaan API