রুট ম্যাট্রিক্স রেসপন্স পর্যালোচনা করুন

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর ডেভেলপার

রুট ম্যাট্রিক্স অনুরোধ, ইনপুট হিসেবে উৎস ও গন্তব্যের ওয়েপয়েন্টের অ্যারে নেয়। তারপর Routes API প্রতিটি শুরুর ওয়েপয়েন্ট থেকে প্রতিটি গন্তব্যের ওয়েপয়েন্ট পর্যন্ত রুট গণনা করে। যেমন, আপনি যদি দুটি সোর্স ওয়েপয়েন্ট এবং দুটি গন্তব্য ওয়েপয়েন্ট নির্দিষ্ট করেন, তাহলে API চারটি আলাদা রুট গণনা করে।

API রেসপন্সে একটি অ্যারে থাকে, যেখানে প্রতিটি অ্যারে এলিমেন্ট একটি অরিজিন ওয়েপয়েন্ট থেকে একটি ডেস্টিনেশন ওয়েপয়েন্টের রুটের সাথে সম্পর্কিত। তাই, আপনি যদি দুটি সোর্স ওয়েপয়েন্ট এবং দুটি ডেস্টিনেশন ওয়েপয়েন্ট উল্লেখ করেন, তাহলে রেসপন্স অ্যারেতে চারটি এলিমেন্ট থাকে, প্রতিটি গণনা করা রুটের জন্য একটি করে।

রেসপন্স ব্যবহার করে, আপনি গ্রাহকদের বিভিন্ন রুটের বিকল্প প্রদান করতে পারবেন এবং তারপর ব্যবহারকারীকে তার প্রয়োজন অনুযায়ী উপযুক্ত রুট বেছে নিতে দিতে পারবেন।

ফিল্ড মাস্ক সম্পর্কে

কোনও রুট গণনা করার জন্য কোনও পদ্ধতি কল করার সময়, আপনাকে অবশ্যই একটি ফিল্ড মাস্ক নির্দিষ্ট করতে হবে যা সংজ্ঞায়িত করে যে আপনি উত্তরে কোন ফিল্ডগুলি ফেরত চান। ফেরত পাঠানো ফিল্ডের কোনও ডিফল্ট তালিকা নেই। আপনি এই তালিকা বাদ দিলে, পদ্ধতিগুলি একটি ত্রুটি দেখায়।

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

আরও তথ্যের জন্য, কোন তথ্য ফেরত দিতে হবে তা বেছে নিন দেখুন।

কপিরাইট দেখানো সম্পর্কে

আপনার ব্যবহারকারীদের ফলাফল দেখানোর সময় আপনাকে অবশ্যই নিম্নলিখিত কপিরাইট বিবৃতি অন্তর্ভুক্ত করতে হবে:

Powered by Google, ©YEAR Google

যেমন:

Powered by Google, ©2023 Google

উত্তরে রুট শনাক্ত করুন

উত্তরে প্রতিটি রুট শনাক্ত করতে originIndex এবং destinationIndex রেসপন্স প্রপার্টি ব্যবহার করুন। এইসব প্রপার্টিতে ইনপুট উৎসের জিরো-বেসড ইন্ডেক্স এবং রুট গণনা করার জন্য ব্যবহৃত ইনপুট গন্তব্যের ওয়েপয়েন্ট থাকে। এর অর্থ হল, অনুরোধে প্রথম উৎস ওয়েপয়েন্ট এবং প্রথম গন্তব্য ওয়েপয়েন্ট অ্যারে ইন্ডেক্স ০-তে আছে।

যেমন, উত্তরে কোনও রুটে এগুলি থাকে:

"originIndex": 1,
"destinationIndex": 0

এইসব প্রপার্টি থেকে বোঝা যায় যে ইনপুট অ্যারের ইন্ডেক্স ১-এ থাকা সোর্স ওয়েপয়েন্ট এবং ইন্ডেক্স ০-তে থাকা গন্তব্য ওয়েপয়েন্ট থেকে রুট হিসেব করা হয়েছে।

পরবর্তী রুটের জন্য:

"originIndex": 4,
"destinationIndex": 1

ইনপুট অ্যারের ইন্ডেক্স ৪-এ থাকা শুরুর ওয়েপয়েন্ট এবং ইনপুট অ্যারের ইন্ডেক্স ১-এ থাকা গন্তব্যের ওয়েপয়েন্ট থেকে রুটটি গণনা করা হয়েছে।

উত্তরে দেওয়া রুট সংক্রান্ত তথ্য সম্পর্কে

API রেসপন্সে একটি অ্যারে থাকে, যেখানে প্রতিটি অ্যারে এলিমেন্ট একটি অরিজিন ওয়েপয়েন্ট থেকে একটি ডেস্টিনেশন ওয়েপয়েন্ট পর্যন্ত রুট নির্ধারণ করে। এইসব এলিমেন্ট gRPC পদ্ধতিতে RouteMatrixElements অথবা HTTP রেসপন্সে রেসপন্স বডি হিসেবে থাকে।

originIndex এবং destinationIndex প্রপার্টির সাথে, প্রতিটি এলিমেন্টে শুধুমাত্র সেই রুটের জন্য নির্দিষ্ট প্রাথমিক তথ্য থাকে, যেমন distanceMeters, duration এবং travelAdvisory। কোনও রুটের ব্যাপারে আরও বিস্তারিত তথ্য পেতে, যেমন পলিলাইন, computeRoutes ব্যবহার করুন।

উত্তরে এই ফর্মটি আছে:

[
  // One array element for each combination of origin and destination waypoints.
  {
    // The route for source waypoint 0 and destination waypoint 0.
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  {
    // The route for source waypoint 0 and destination waypoint 1.
    "originIndex": 0,
    "destinationIndex": 1,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  …
]