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