Method: projects.locations.optimizeTours

এটি একটি ShipmentModel সম্বলিত একটি OptimizeToursRequest পাঠায় এবং একটি OptimizeToursResponse ফেরত দেয়, যাতে ShipmentRoute গুলো হলো যানবাহন দ্বারা সম্পাদিতব্য রুটগুলোর একটি সেট যা সামগ্রিক খরচ সর্বনিম্ন করে।

একটি ShipmentModel মডেল মূলত সম্পন্ন করার জন্য প্রয়োজনীয় Shipment এবং সেই Shipment পরিবহনের জন্য ব্যবহৃত হতে পারে এমন Vehicle নিয়ে গঠিত। ShipmentRoute Vehicle সাথে Shipment সংযুক্ত করে। আরও নির্দিষ্টভাবে বললে, এগুলো প্রতিটি যানবাহনের সাথে একাধিক Visit সংযুক্ত করে, যেখানে একটি Visit একটি VisitRequest সাথে সঙ্গতিপূর্ণ, যা হলো একটি Shipment জন্য পিকআপ বা ডেলিভারি।

লক্ষ্য হলো Vehicle ShipmentRoute ) বরাদ্দ করা, যা মোট খরচ সর্বনিম্ন করে, যেখানে খরচের বিভিন্ন উপাদান ShipmentModel মডেলে (ShipmentModel) সংজ্ঞায়িত থাকে।

HTTP অনুরোধ

POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}:optimizeTours

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
parent

string

প্রয়োজনীয়। কল করার জন্য নির্দিষ্ট প্রকল্প বা স্থান।

বিন্যাস:

  • projects/{project-id}
  • projects/{project-id}/locations/{location-id}

অবস্থান নির্দিষ্ট না করা হলে, একটি অঞ্চল স্বয়ংক্রিয়ভাবে নির্বাচিত হবে।

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "timeout": string,
  "model": {
    object (ShipmentModel)
  },
  "solvingMode": enum (SolvingMode),
  "searchMode": enum (SearchMode),
  "injectedFirstSolutionRoutes": [
    {
      object (ShipmentRoute)
    }
  ],
  "injectedSolutionConstraint": {
    object (InjectedSolutionConstraint)
  },
  "refreshDetailsRoutes": [
    {
      object (ShipmentRoute)
    }
  ],
  "interpretInjectedSolutionsUsingLabels": boolean,
  "considerRoadTraffic": boolean,
  "populatePolylines": boolean,
  "populateTransitionPolylines": boolean,
  "allowLargeDeadlineDespiteInterruptionRisk": boolean,
  "useGeodesicDistances": boolean,
  "label": string,
  "geodesicMetersPerSecond": number,
  "maxValidationErrors": integer
}
ক্ষেত্র
timeout

string ( Duration format)

যদি এই টাইমআউট সেট করা থাকে, তাহলে সার্ভার টাইমআউটের সময়সীমা শেষ হওয়ার আগেই অথবা সিনক্রোনাস অনুরোধের জন্য সার্ভারের নির্ধারিত সময়সীমা শেষ হওয়ার আগেই একটি প্রতিক্রিয়া ফেরত দেয়, দুটির মধ্যে যেটি আগে ঘটে।

অ্যাসিঙ্ক্রোনাস অনুরোধের ক্ষেত্রে, সার্ভার টাইমআউট শেষ হওয়ার আগেই (সম্ভব হলে) একটি সমাধান তৈরি করবে।

model

object ( ShipmentModel )

চালান মডেল সমাধান করতে হবে।

solvingMode

enum ( SolvingMode )

ডিফল্টরূপে, সমাধানের মোড হল DEFAULT_SOLVE (0)।

searchMode

enum ( SearchMode )

অনুরোধটি সমাধান করতে সার্চ মোড ব্যবহার করা হয়েছে।

injectedFirstSolutionRoutes[]

object ( ShipmentRoute )

পূর্ববর্তী কোনো সমাধানের অনুরূপ একটি প্রথম সমাধান খুঁজে বের করতে অপ্টিমাইজেশন অ্যালগরিদমকে নির্দেশনা দিন।

প্রথম সমাধানটি তৈরি করার সময় মডেলটি সীমাবদ্ধ থাকে। কোনো রুটে সম্পাদিত না হওয়া চালানগুলো প্রথম সমাধানে অন্তর্নিহিতভাবে বাদ পড়ে যায়, কিন্তু সেগুলো পরবর্তী সমাধানগুলোতে সম্পাদিত হতে পারে।

সমাধানটিকে অবশ্যই বৈধতার কিছু মৌলিক পূর্বশর্ত পূরণ করতে হবে:

  • সকল রুটের জন্য, vehicleIndex অবশ্যই সীমার মধ্যে থাকতে হবে এবং এর পুনরাবৃত্তি হওয়া চলবে না।
  • সকল ভিজিটের জন্য, shipmentIndex এবং visitRequestIndex অবশ্যই সীমার মধ্যে থাকতে হবে।
  • একটি চালান শুধুমাত্র একটি রুটে উল্লেখ করা যেতে পারে।
  • পিকআপ-ডেলিভারি চালানের ক্ষেত্রে, ডেলিভারির আগেই পণ্য সংগ্রহ করতে হবে।
  • একটি চালানের জন্য সর্বাধিক একটি পিকআপ বিকল্প বা ডেলিভারি বিকল্প সম্পাদন করা যাবে।
  • সমস্ত রুটের জন্য, সময় বাড়ছে (অর্থাৎ, vehicleStartTime <= visits[0].start_time <= visits[1].start_time ... <= vehicleEndTime )।
  • শুধুমাত্র অনুমোদিত যানবাহনের মাধ্যমেই চালান পাঠানো যেতে পারে। একটি যানবাহন অনুমোদিত হয় যদি Shipment.allowed_vehicle_indices খালি থাকে অথবা এর vehicleIndex Shipment.allowed_vehicle_indices এর অন্তর্ভুক্ত থাকে।

যদি প্রবেশ করানো সমাধানটি বাস্তবসম্মত না হয়, তবে আবশ্যিকভাবে কোনো যাচাইকরণ ত্রুটি ফেরত দেওয়া হয় না এবং এর পরিবর্তে অবাস্তবতা নির্দেশক একটি ত্রুটি ফেরত দেওয়া হতে পারে।

injectedSolutionConstraint

object ( InjectedSolutionConstraint )

অপ্টিমাইজেশন অ্যালগরিদমকে এমন একটি চূড়ান্ত সমাধান খুঁজে বের করতে বাধ্য করুন যা পূর্ববর্তী কোনো সমাধানের অনুরূপ। উদাহরণস্বরূপ, এটি রুটের সেই অংশগুলিকে স্থির করতে ব্যবহার করা যেতে পারে যেগুলি ইতিমধ্যে সম্পন্ন হয়েছে অথবা যেগুলি সম্পন্ন করা হবে কিন্তু কোনোভাবেই পরিবর্তন করা যাবে না।

যদি প্রবেশ করানো সমাধানটি বাস্তবসম্মত না হয়, তবে আবশ্যিকভাবে কোনো যাচাইকরণ ত্রুটি ফেরত দেওয়া হয় না এবং এর পরিবর্তে অবাস্তবতা নির্দেশক একটি ত্রুটি ফেরত দেওয়া হতে পারে।

refreshDetailsRoutes[]

object ( ShipmentRoute )

যদি খালি না থাকে, তবে প্রদত্ত রুটগুলো রিফ্রেশ করা হবে, কিন্তু সেগুলোর পরিদর্শনের ক্রম বা ভ্রমণের সময় অপরিবর্তিত থাকবে; শুধু অন্যান্য বিবরণ আপডেট করা হবে। এটি মডেলটির সমাধান করে না।

২০২০ সালের নভেম্বর মাস থেকে, এটি শুধুমাত্র অ-খালি রুটগুলির পলিলাইনগুলিকে পূরণ করে এবং এর জন্য populatePolylines মান true হওয়া আবশ্যক।

প্রদত্ত রুটগুলির routePolyline ফিল্ডগুলি রুট transitions সাথে অসামঞ্জস্যপূর্ণ হতে পারে।

এই ফিল্ডটি injectedFirstSolutionRoutes বা injectedSolutionConstraint সাথে একত্রে ব্যবহার করা যাবে না।

Shipment.ignore এবং Vehicle.ignore আচরণের উপর কোনো প্রভাব ফেলে না। সংশ্লিষ্ট চালান বা যানবাহন উপেক্ষা করা হোক বা না হোক, সমস্ত অ-খালি রুটে প্রতিটি পরিদর্শনের মধ্যে পলিলাইনগুলি ঠিকই পূর্ণ হয়।

interpretInjectedSolutionsUsingLabels

boolean

যদি সত্য হয়:

  • ইনজেক্টেড সলিউশনের রুটগুলোকে রিকোয়েস্টের যানবাহনগুলোর সাথে মেলানোর জন্য vehicleIndex এর পরিবর্তে ShipmentRoute.vehicle_label ব্যবহার করে; যদি ConstraintRelaxation.vehicle_indices খালি না থাকে, তবে তা আপডেট করার জন্য আসল ShipmentRoute.vehicle_index থেকে নতুন ShipmentRoute.vehicle_index এর ম্যাপিংটি পুনরায় ব্যবহার করে, কিন্তু ম্যাপিংটি অবশ্যই দ্ব্যর্থহীন হতে হবে (অর্থাৎ, একাধিক ShipmentRoute এর একই আসল vehicleIndex থাকতে পারবে না)।
  • ইনজেক্টেড সলিউশনের ভিজিটগুলোর সাথে রিকোয়েস্টের শিপমেন্টগুলো মেলানোর জন্য shipmentIndex এর পরিবর্তে ShipmentRoute.Visit.shipment_label ব্যবহার করে;
  • ইনজেক্টেড সলিউশনে বাদ পড়া শিপমেন্টগুলোকে অনুরোধ করা শিপমেন্টের সাথে মেলানোর জন্য SkippedShipment.label এর পরিবর্তে SkippedShipment.index ব্যবহার করে।

এই ব্যাখ্যাটি injectedFirstSolutionRoutes , injectedSolutionConstraint , এবং refreshDetailsRoutes ফিল্ডগুলোর ক্ষেত্রে প্রযোজ্য। সলিউশনটি তৈরি হওয়ার পর থেকে রিকোয়েস্টের শিপমেন্ট বা ভেহিকেল ইনডেক্স পরিবর্তিত হলে এটি ব্যবহার করা যেতে পারে, যেমন—রিকোয়েস্ট থেকে শিপমেন্ট বা ভেহিকেল সরানো বা যোগ করার কারণে।

যদি সত্য হয়, তাহলে নিম্নলিখিত বিভাগগুলির লেবেলগুলি তাদের নিজ নিজ বিভাগে সর্বাধিক একবার উপস্থিত থাকতে হবে:

ইনজেক্টেড সলিউশনে থাকা কোনো vehicleLabel যদি অনুরোধকৃত কোনো গাড়ির সাথে না মেলে, তাহলে সংশ্লিষ্ট রুটটি তার ভিজিটগুলোসহ সলিউশন থেকে সরিয়ে দেওয়া হয়। ইনজেক্টেড সলিউশনে থাকা কোনো shipmentLabel যদি অনুরোধকৃত কোনো চালানের সাথে না মেলে, তাহলে সংশ্লিষ্ট ভিজিটটি সলিউশন থেকে সরিয়ে দেওয়া হয়। ইনজেক্টেড সলিউশনে থাকা কোনো SkippedShipment.label যদি অনুরোধকৃত চালানের সাথে না মেলে, তাহলে SkippedShipment টি সলিউশন থেকে সরিয়ে দেওয়া হয়।

ইনজেক্ট করা সলিউশন থেকে রুট ভিজিট বা সম্পূর্ণ রুট অপসারণ করলে অন্তর্নিহিত সীমাবদ্ধতাগুলোর উপর প্রভাব পড়তে পারে, যার ফলে সলিউশনে পরিবর্তন, ভ্যালিডেশন ত্রুটি বা অসাধ্যতা দেখা দিতে পারে।

দ্রষ্টব্য: কলারকে অবশ্যই নিশ্চিত করতে হবে যে প্রতিটি Vehicle.label (বা Shipment.label ) দুটি প্রাসঙ্গিক অনুরোধ জুড়ে ব্যবহৃত একটি যানবাহন (বা চালান) সত্তাকে অনন্যভাবে শনাক্ত করে: একটি হলো পূর্ববর্তী অনুরোধ যা ইনজেক্টেড সলিউশনে ব্যবহৃত OptimizeToursResponse তৈরি করেছে এবং অন্যটি হলো বর্তমান অনুরোধ যা ইনজেক্টেড সলিউশনটি অন্তর্ভুক্ত করেছে। উপরে বর্ণিত অনন্যতা যাচাইগুলো এই প্রয়োজনীয়তা নিশ্চিত করার জন্য যথেষ্ট নয়।

considerRoadTraffic

boolean

ShipmentRoute Transition.travel_duration , Visit.start_time , এবং vehicleEndTime ফিল্ডগুলো গণনা করার সময়; ShipmentRoute.has_traffic_infeasibilities ফিল্ডটি সেট করার সময়, এবং OptimizeToursResponse.total_cost ফিল্ডটি গণনা করার সময় ট্র্যাফিক অনুমান বিবেচনা করুন।

populatePolylines

boolean

যদি সত্য হয়, তাহলে রেসপন্স ShipmentRoute গুলোতে পলিলাইনগুলো যুক্ত করা হবে।

populateTransitionPolylines

boolean

যদি সত্য হয়, তাহলে রেসপন্স ShipmentRoute.transitions এ পলিলাইন এবং রুট টোকেনগুলো যুক্ত করা হবে।

allowLargeDeadlineDespiteInterruptionRisk

boolean

এটি সেট করা থাকলে, অনুরোধটির সর্বোচ্চ ৬০ মিনিটের একটি ডেডলাইন থাকতে পারে (দেখুন https://grpc.io/blog/deadlines )। অন্যথায়, সর্বোচ্চ ডেডলাইন মাত্র ৩০ মিনিট। মনে রাখবেন যে, দীর্ঘস্থায়ী অনুরোধগুলির বাধাগ্রস্ত হওয়ার ঝুঁকি উল্লেখযোগ্যভাবে বেশি (তবে এখনও সামান্য)।

useGeodesicDistances

boolean

যদি সত্য হয়, তাহলে গুগল ম্যাপসের দূরত্বের পরিবর্তে জিওডেসিক দূরত্ব ব্যবহার করে ভ্রমণের দূরত্ব গণনা করা হবে, এবং geodesicMetersPerSecond দ্বারা নির্ধারিত গতিসহ জিওডেসিক দূরত্ব ব্যবহার করে ভ্রমণের সময় গণনা করা হবে।

label

string

এই অনুরোধটি শনাক্ত করতে ব্যবহৃত হতে পারে এমন লেবেল, যা OptimizeToursResponse.request_label এ রিপোর্ট করা হয়।

geodesicMetersPerSecond

number

যখন useGeodesicDistances মান true হয়, তখন এই ফিল্ডটি অবশ্যই সেট করতে হবে এবং এটি ভ্রমণের সময় গণনার জন্য ব্যবহৃত গতি নির্ধারণ করে। এর মান অবশ্যই কমপক্ষে ১.০ মিটার/সেকেন্ড হতে হবে।

maxValidationErrors

integer

ফেরত আসা ভ্যালিডেশন ত্রুটির সংখ্যা সীমিত করে। এই ত্রুটিগুলি সাধারণত একটি INVALID_ARGUMENT ত্রুটি পেলোডের সাথে BadRequest ত্রুটির বিবরণ হিসাবে সংযুক্ত থাকে ( https://cloud.google.com/apis/design/errors#error_details) , যদি না solvingMode=VALIDATE_ONLY হয়: OptimizeToursResponse.validation_errors ফিল্ডটি দেখুন। এর ডিফল্ট মান ১০০ এবং সর্বোচ্চ সীমা ১০,০০০।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে OptimizeToursResponse এর একটি ইনস্ট্যান্স থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/cloud-platform

আইএএম অনুমতি

parent রিসোর্সে নিম্নলিখিত IAM পারমিশন প্রয়োজন:

  • routeoptimization.locations.use

আরও তথ্যের জন্য, IAM ডকুমেন্টেশন দেখুন।