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