একটি রুট ম্যাট্রিক্স অনুরোধ ইনপুট হিসেবে অরিজিন এবং ডেস্টিনেশন ওয়েপয়েন্টের একটি অ্যারে নেয়। এরপর রুটস API প্রতিটি অরিজিন ওয়েপয়েন্ট থেকে প্রতিটি ডেস্টিনেশন ওয়েপয়েন্টে যাওয়ার রুট গণনা করে। উদাহরণস্বরূপ, যদি আপনি দুটি অরিজিন ওয়েপয়েন্ট এবং দুটি ডেস্টিনেশন ওয়েপয়েন্ট নির্দিষ্ট করেন, তাহলে API চারটি পৃথক রুট গণনা করে।
API রেসপন্সে একটি অ্যারে থাকে, যেখানে প্রতিটি অ্যারে উপাদান একটি অরিজিন ওয়েপয়েন্ট থেকে একটি গন্তব্য ওয়েপয়েন্টে যাওয়ার রুটের সাথে সম্পর্কিত। অতএব, যদি আপনি দুটি অরিজিন ওয়েপয়েন্ট এবং দুটি গন্তব্য ওয়েপয়েন্ট নির্দিষ্ট করেন, তাহলে রেসপন্স অ্যারেতে চারটি উপাদান থাকে, প্রতিটি গণনা করা রুটের জন্য একটি।
প্রতিক্রিয়া ব্যবহার করে, আপনি আপনার গ্রাহকদের বিভিন্ন রুট বিকল্প প্রদান করতে পারেন এবং তারপর ব্যবহারকারীকে তাদের প্রয়োজনীয়তার জন্য উপযুক্ত রুট নির্বাচন করতে দিতে পারেন।
ফিল্ড মাস্ক সম্পর্কে
যখন আপনি একটি রুট গণনা করার জন্য একটি পদ্ধতি কল করেন, তখন আপনাকে একটি ফিল্ড মাস্ক নির্দিষ্ট করতে হবে যা নির্ধারণ করে যে আপনি প্রতিক্রিয়ায় কোন ক্ষেত্রগুলি ফেরত চান। ফেরত ক্ষেত্রগুলির কোনও ডিফল্ট তালিকা নেই। যদি আপনি এই তালিকাটি বাদ দেন, তাহলে পদ্ধতিগুলি একটি ত্রুটি ফেরত পাঠাবে।
এই ডকুমেন্টের উদাহরণগুলিতে ফিল্ড মাস্ক বিবেচনা না করেই সম্পূর্ণ রেসপন্স অবজেক্ট দেখানো হয়েছে। একটি প্রোডাকশন পরিবেশে, আপনার রেসপন্সে কেবলমাত্র সেই ক্ষেত্রগুলি অন্তর্ভুক্ত থাকবে যা আপনি ফিল্ড মাস্কে স্পষ্টভাবে উল্লেখ করেছেন।
আরও তথ্যের জন্য, কোন তথ্য ফেরত দেবেন তা চয়ন করুন দেখুন।
কপিরাইট প্রদর্শন সম্পর্কে
আপনার ব্যবহারকারীদের কাছে ফলাফল প্রদর্শন করার সময় আপনাকে নিম্নলিখিত কপিরাইট বিবৃতিটি অন্তর্ভুক্ত করতে হবে:
Powered by Google, © YEAR Google
উদাহরণস্বরূপ:
Powered by Google, ©2023 Google
উত্তরে রুটটি চিহ্নিত করুন
প্রতিক্রিয়ার প্রতিটি রুট সনাক্ত করতে originIndex এবং destinationIndex প্রতিক্রিয়া বৈশিষ্ট্য ব্যবহার করুন। এই বৈশিষ্ট্যগুলিতে রুট গণনা করার জন্য ব্যবহৃত ইনপুট অরিজিন এবং ইনপুট গন্তব্য ওয়েপয়েন্টের শূন্য-ভিত্তিক সূচক থাকে। এর অর্থ হল অনুরোধের প্রথম অরিজিন ওয়েপয়েন্ট এবং প্রথম গন্তব্য ওয়েপয়েন্ট অ্যারে সূচক 0 এ রয়েছে।
উদাহরণস্বরূপ, প্রতিক্রিয়ার একটি রুটে রয়েছে:
"originIndex": 1, "destinationIndex": 0
এই বৈশিষ্ট্যগুলি নির্দেশ করে যে রুটটি ইনপুট অ্যারের সূচক 1-এ উৎপত্তিস্থলের ওয়েপয়েন্ট থেকে এবং সূচক 0-এ গন্তব্যস্থলের ওয়েপয়েন্ট থেকে গণনা করা হয়েছিল।
পরবর্তী রুটের জন্য:
"originIndex": 4, "destinationIndex": 1
ইনপুট অ্যারের সূচক ৪-এ উৎপত্তিস্থলের ওয়েপয়েন্ট থেকে এবং ইনপুট অ্যারের সূচক ১-এ গন্তব্যস্থলের ওয়েপয়েন্ট থেকে রুটটি গণনা করা হয়েছিল।
প্রতিক্রিয়া সম্পর্কে
API প্রতিক্রিয়া প্রতিনিধিত্বকারী JSON অবজেক্টটিতে একটি অ্যারে থাকে, যেখানে প্রতিটি অ্যারে উপাদান একটি অরিজিন ওয়েপয়েন্ট থেকে একটি গন্তব্য ওয়েপয়েন্টে যাওয়ার রুট নির্ধারণ করে।
originIndex এবং destinationIndex বৈশিষ্ট্যের পাশাপাশি, প্রতিটি রুটে সেই রুটের জন্য নির্দিষ্ট তথ্য থাকে, যেমন distanceMeters , duration , এবং travelAdvisory ।
প্রতিক্রিয়াটির রূপ হল:
[ // 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) } } … ]