সিঙ্ক্রোনাস এবং অ্যাসিঙ্ক্রোনাস এন্ডপয়েন্ট

রুট অপ্টিমাইজেশান API দুটি পদ্ধতি প্রকাশ করে:

• OptimizeTours হল একটি সিঙ্ক্রোনাস পদ্ধতি যা একটি OptimizeToursRequest এর প্রতিক্রিয়া হিসাবে একটি অপ্টিমাইজ করা রুট প্রদান করে। ক্লায়েন্টদের অবশ্যই রুট অপ্টিমাইজেশান API এর সাথে একটি খোলা সংযোগ বজায় রাখতে হবে যতক্ষণ না অনুরোধটি প্রক্রিয়া করা হয় এবং একটি OptimizeToursResponse বা ত্রুটি ফিরে না আসে।
• BatchOptimizeTours হল একটি অ্যাসিঙ্ক্রোনাস পদ্ধতি যা এক বা একাধিক OptimizeToursRequest এবং সংশ্লিষ্ট OptimizeToursResponse বার্তাগুলির জন্য URI গ্রহণ করে, একটি লং রানিং অপারেশন (LRO) ( REST , gRPC ) এর রিসোর্স নাম ফেরত দেয় যা ব্যাচের সমাপ্তি পরীক্ষা করতে ব্যবহৃত হয়। OptimizeToursRequest গুলি ব্যাকগ্রাউন্ডে প্রক্রিয়া করা হয়, তাই ক্লায়েন্টরা রুট অপ্টিমাইজেশান API-এর সাথে একটি খোলা সংযোগ বজায় রাখে শুধুমাত্র BatchOptimizeToursRequest জমা দেওয়ার জন্য বা LRO স্থিতি পরীক্ষা করতে GetOperation কল করার জন্য। BatchOptimizeTours Google ক্লাউড স্টোরেজ থেকে অনুরোধ পড়ে এবং প্রতিক্রিয়া লেখে।

কেস ব্যবহার করুন

OptimizeTours ছোট এবং সাধারণ অনুরোধগুলি সমাধান করার জন্য বা কয়েক মিনিট বা তার কম সময়ের সমাধানের অনুরোধগুলির জন্য সুবিধাজনক৷ রুট অপ্টিমাইজেশান এপিআই-এর সাথে দীর্ঘস্থায়ী সংযোগ বজায় রাখা একটি সমাধান ফেরত দেওয়ার আগে বাধার ঝুঁকি বাড়ায়।

BatchOptimizeTours বৃহত্তর অনুরোধ এবং অনুরোধগুলি দীর্ঘ সমাধানের সময় সহ পরিচালনা করতে পারে কারণ এটির জন্য রুট অপ্টিমাইজেশান API-এর সাথে দীর্ঘস্থায়ী সংযোগের প্রয়োজন হয় না।

দীর্ঘ চলমান অপারেশন

একটি ব্যাচের সমাপ্তির স্থিতি পরীক্ষা করার জন্য GetOperation পদ্ধতি ব্যবহার করে রুট অপ্টিমাইজেশান API থেকে LROগুলি পড়া হয়৷ LROs-এর মধ্যে একটি done সম্পত্তি রয়েছে যা নির্দেশ করে যে পুরো ব্যাচের প্রক্রিয়াকরণ সম্পূর্ণ হয়েছে কিনা এবং একটি error ক্ষেত্র যা প্রক্রিয়াকরণের সময় ত্রুটিগুলি রিপোর্ট করে। যদি done সত্য হয় এবং কোন error উপস্থিত না থাকে, ব্যাচটি সফলভাবে সম্পন্ন হয়। একটি error উপস্থিতি নির্দেশ করে যে ব্যাচের কিছু বা সমস্ত প্রক্রিয়াকরণ ব্যর্থ হয়েছে৷

একটি BatchOptimizeTours অনুরোধের সাধারণ জীবনচক্র নিম্নরূপ:

1. রুট অপ্টিমাইজেশান এপিআইতে একটি BatchOptimizeToursRequest জমা দিন, যা একটি LRO-এর রিসোর্স নাম প্রদান করে।
2. প্রত্যাবর্তিত এলআরও রিসোর্স নামের সাথে পোল GetOperation যতক্ষণ না LRO প্রতিক্রিয়াতে done বা error বৈশিষ্ট্যগুলি উপস্থিত হয়।
3. যদি done সত্য হয় এবং কোনো ত্রুটি উপস্থিত না থাকে, তাহলে BatchOptimizeTours অনুরোধে উল্লেখ করা Google ক্লাউড স্টোরেজ URI থেকে OptimizeToursResponses পড়ুন। error উপস্থিত থাকলে, ত্রুটিটি পরিদর্শন করুন, Google ক্লাউড স্টোরেজে সেই অনুযায়ী OptimizeToursRequest গুলি আপডেট করুন এবং পর্যবেক্ষণ করা ত্রুটির উপর নির্ভর করে যথাযথভাবে পুনরায় চেষ্টা করুন৷

আপনি কমান্ড লাইন থেকে বা ক্লায়েন্ট লাইব্রেরি ব্যবহার করে বিভিন্ন উপায়ে OptimizeTours এবং BatchOptimizeTours অনুরোধ পাঠাতে পারেন।

পরবর্তী: একটি API অনুরোধ করুন