যখন আপনি ComputeRoutes() মেথডটি কল করেন, তখন আপনাকে অবশ্যই নির্দিষ্ট করে দিতে হবে যে রেসপন্সে আপনি কোন ফিল্ডগুলো ফেরত পেতে চান। এটি করার জন্য আপনি একটি রেসপন্স ফিল্ড মাস্ক ব্যবহার করতে পারেন, যা আপনি $fields বা fields ইউআরএল প্যারামিটারের মাধ্যমে প্রদান করেন, অথবা HTTP/gRPC হেডার X-Goog-FieldMask ব্যবহার করতে পারেন। আরও তথ্যের জন্য, সিস্টেম প্যারামিটারস দেখুন।
ফিল্ড মাস্ক
ফিল্ড মাস্ক ভ্যালুটি হলো ফিল্ড পাথগুলোর একটি কমা-দ্বারা-বিভক্ত তালিকা। প্রতিটি ফিল্ড পাথ হলো ফিল্ডের নামগুলোর একটি ডট-দ্বারা-বিভক্ত তালিকা, যা মেসেজের স্তরক্রমকে উপস্থাপন করে। একটি ফিল্ডের নাম হয় JSON অবজেক্টের কী (key), অথবা প্রোটোবাফ ফিল্ড ট্যাগের নাম। ফিল্ড পাথটি সর্বোচ্চ স্তরের রেসপন্স মেসেজ টাইপ থেকে শুরু হয় এবং এর পরে ঐচ্ছিকভাবে এক বা একাধিক ডট এবং তারপর পরবর্তী স্তরের ফিল্ডের নাম থাকে। সাধারণত, ফিল্ড পাথগুলো নিম্নলিখিত উপায়ে গঠিত হয়:
topLevelField[.secondLevelField][.thirdLevelField][...]
একটি বিশেষ ক্ষেত্রের ফিল্ড মাস্ক হলো একটি ওয়াইল্ডকার্ড “*”, যা সমস্ত রুট-লেভেলের ফিল্ড নির্বাচন করে।
উদাহরণ
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে ComputeRoutes() পদ্ধতির জন্য ফিল্ড মাস্ক সেট করতে হয়।
উদাহরণ ১
উপলব্ধ সকল ফিল্ডের ফিল্ড মাস্ক (ম্যানুয়াল পরিদর্শনের জন্য)।
X-Goog-FieldMask: *
উদাহরণ ২
রুট-স্তরের সময়কাল, দূরত্ব এবং পলিলাইনের ফিল্ড মাস্ক (একটি উদাহরণ উৎপাদন সেটআপ)।
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
প্রোডাকশনে ওয়াইল্ডকার্ড (*) রেসপন্স ফিল্ড মাস্ক ব্যবহার করা, অথবা টপ লেভেলে (রাউটে) ফিল্ড মাস্ক নির্দিষ্ট করাকে আমরা নিরুৎসাহিত করি। শুধু আপনার প্রয়োজনীয় ফিল্ডগুলো নির্বাচন করুন:
এটি আমাদের সার্ভারকে প্রসেসিং সাইকেল বাঁচাতে সাহায্য করে, যার ফলে আমরা কম ল্যাটেন্সিতে আপনাকে ফলাফল ফেরত দিতে পারি।
স্থিতিশীল লেটেন্সি পারফরম্যান্স নিশ্চিত করে। ভবিষ্যতে আমরা আরও রেসপন্স ফিল্ড যোগ করতে পারি, এবং সেই নতুন ফিল্ডগুলোর জন্য অতিরিক্ত কম্পিউটেশন সময়ের প্রয়োজন হতে পারে। আপনি যদি সমস্ত ফিল্ড নির্বাচন করেন, অথবা যদি আপনি টপ লেভেলে সমস্ত ফিল্ড নির্বাচন করেন, তাহলে আপনি পারফরম্যান্সের অবনতি অনুভব করতে পারেন, কারণ আমাদের যোগ করা যেকোনো নতুন ফিল্ড স্বয়ংক্রিয়ভাবে আপনার রেসপন্সে অন্তর্ভুক্ত হয়ে যাবে।
এর ফলে প্রতিক্রিয়ার আকার ছোট হয়, যা নেটওয়ার্ক থ্রুপুট বাড়িয়ে দেয়।
ফিল্ড পাথ কীভাবে তৈরি করতে হয় সে সম্পর্কে আরও তথ্যের জন্য field_mask.proto দেখুন।