রুট ম্যাট্রিক্সের অনুরোধে ইনপুট হিসেবে অরিজিন ও গন্তব্যের একটি অ্যারে ওয়েপয়েন্ট নেওয়া হয়। 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-এর উত্তরে একটি অ্যারে থাকে, যেখানে প্রতিটি অ্যারে এলিমেন্ট একটি অরিজিন ওয়েপপয়েন্ট থেকে একটি ডেস্টিনেশন ওয়েপপয়েন্ট পর্যন্ত
রুটকে সংজ্ঞায়িত করে। এইসব এলিমেন্ট
RouteMatrixElements
gRPC পদ্ধতিতে অথবা
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) } } … ]