একক নন-ব্লকিং অপ্টিমাইজেশান API পদ্ধতি

এই নির্দেশিকাটি OptimizeToursLongRunning এবং OptimizeToursUri API মেথডগুলোর পরীক্ষামূলক সূচনা তুলে ধরে, যা ব্যবহারকারীদের একক নন-ব্লকিং অপটিমাইজেশন অনুরোধ করার সুযোগ দেয়। একটি নন-ব্লকিং অপটিমাইজেশনে, ব্যবহারকারী মেথডটি থেকে দ্রুত একটি Operation প্রোটো পেয়ে যান, যা GetOperation কল করে অপটিমাইজেশনের অবস্থা জানতে ব্যবহার করা যেতে পারে। আরও বিস্তারিত জানতে Long Running Operations দেখুন।

এই নন-ব্লকিং পদ্ধতিগুলো ব্লকিং OptimizeTours পদ্ধতির তুলনায় নির্ভরযোগ্যতার সুবিধা প্রদান করে, কারণ অপটিমাইজেশন চলাকালীন ক্লায়েন্টকে সার্ভারের সাথে সংযোগ বজায় রাখতে হয় না। এছাড়াও, BatchOptimizeTours এর তুলনায় এই নতুন পদ্ধতিগুলো ব্যর্থতা ডিবাগ করা সহজ করে তোলে, যেহেতু প্রতিটি অপটিমাইজেশন একটি একক Long-Running Operation (LRO)-এর সাথে যুক্ত থাকে।

যেসব ব্যবহারকারী অপটিমাইজেশন অনুরোধটি ইনলাইন করতে পছন্দ করেন, তারা OptimizeToursLongRunning পদ্ধতিটি ব্যবহার করতে পারেন, অন্যদিকে যেসব ব্যবহারকারী গুগল ক্লাউড স্টোরেজ ব্যবহার করে অনুরোধ এবং পঠিত প্রতিক্রিয়া আপলোড করতে পছন্দ করেন, তারা OptimizeToursUri পদ্ধতিটি ব্যবহার করতে পারেন।

OptimizeToursLongRunning

উদাহরণ: একটি OptimizeToursLongRunning অনুরোধ করুন

অনুরোধ করার আগে, নিম্নলিখিত প্যারামিটারগুলো আপনার পরিবেশের জন্য উপযুক্ত মান দিয়ে প্রতিস্থাপন করুন:

  • OAuth ব্যবহার অংশে বর্ণিত পদ্ধতি অনুযায়ী আপনার অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল কনফিগার করা আছে কিনা, তা নিশ্চিত করুন।

  • PROJECT_NUMBER_OR_ID আপনার ক্লাউড প্রজেক্ট নম্বর বা আইডিতে সেট করুন।

    নিম্নলিখিত কমান্ডটি রাউট অপটিমাইজেশন এপিআই-তে একটি OptimizeToursLongRunning রিকোয়েস্ট পাঠায় এবং এর সাথে যুক্ত একটি অপারেশন আইডি গ্রহণ করে। অপারেশনটির স্ট্যাটাস জানতে GetOperation মেথডটি ব্যবহার করা যেতে পারে। অপারেশনটি সম্পন্ন হলে, মেটাডেটাতে চূড়ান্ত OptimizeToursResponse অন্তর্ভুক্ত থাকে।

    curl -X POST 'https://routeoptimization.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID:optimizeToursLongRunning' \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
--data @- <<EOM
{
  "model": {
    "shipments": [
      {
        "pickups": [
          {
            "arrivalLocation": {
              "latitude": 37.42506261000996,
              "longitude": -122.09535511930135
            }
          }
        ],
        "deliveries": [
          {
            "arrivalLocation": {
              "latitude": 37.42421503206021,
              "longitude": -122.09526063135228
            }
          }
        ]
      }
    ],
    "vehicles": [
      {
        "travelMode": "DRIVING",
        "costPerKilometer": 1.0
      }
    ],
  }
}
EOM

OptimizeToursUri

BatchOptimizeTours মতোই, আপনি আপনার অপটিমাইজেশন অনুরোধ এবং প্রতিক্রিয়া Google Cloud Storage-এ সংরক্ষণ করা চালিয়ে যেতে OptimizeToursUri ব্যবহার করতে পারেন। OptimizeToursUri অনুরোধ বার্তায় ক্লাউড স্টোরেজ URI অবশ্যই উল্লেখ করতে হবে। ফেরত আসা Operation স্ট্যাটাসটি শুধুমাত্র জমা দেওয়া একক OptimizeToursRequest সাথেই সম্পর্কিত থাকে।

উদাহরণ: একটি OptimizeToursUri অনুরোধ করুন

অনুরোধ করার আগে, নিম্নলিখিত প্যারামিটারগুলো আপনার পরিবেশের জন্য উপযুক্ত মান দিয়ে প্রতিস্থাপন করুন:

  • OAuth ব্যবহার অংশে বর্ণিত পদ্ধতি অনুযায়ী আপনার অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল কনফিগার করা আছে কিনা, তা নিশ্চিত করুন।

  • PROJECT_NUMBER_OR_ID আপনার ক্লাউড প্রজেক্ট নম্বর বা আইডিতে সেট করুন।

    নিম্নলিখিত কমান্ডটি রাউট অপটিমাইজেশন এপিআই-তে একটি OptimizeToursUri অনুরোধ পাঠায় এবং এর সাথে যুক্ত একটি অপারেশন আইডি গ্রহণ করে। অপারেশনটির অবস্থা জানতে GetOperation মেথডটি ব্যবহার করুন। অপারেশনটি সম্পন্ন হলে, অনুরোধে প্রদত্ত আউটপুট ইউআরআই পাথে OptimizeToursResponse টি দূরবর্তীভাবে সংরক্ষণ করা হয়।

    curl -X POST 'https://routeoptimization.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID:optimizeToursUri' \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
--data @- <<EOM
{
  "input": {
    "uri": "gs://bucket/path/input/object.json"
  },
  "output": {
    "uri": "gs://bucket/path/output/object.json"
  }
}
EOM