আপনি ComputeRoutes() মেথড কল করলে, উত্তরে কোন কোন ফিল্ড ফেরত পেতে চান তা আপনাকে
অবশ্যই নির্দিষ্ট করতে হবে। আপনি এটি একটি রেসপন্স ফিল্ড মাস্ক ব্যবহার করে করেন, যা
আপনি URL প্যারামিটার $fields বা fields-এর সাথে প্রদান করেন অথবা
HTTP/gRPC হেডার X-Goog-FieldMask ব্যবহার করে করেন। আরও তথ্যের জন্য, সিস্টেম প্যারামিটার দেখুন।
ফিল্ড মাস্ক
ফিল্ড মাস্ক ভ্যালু হল ফিল্ড পাথের কমা-সেপারেটেড তালিকা। প্রতিটি ফিল্ড পাথ হল ফিল্ড নামের ডট-সেপারেটেড তালিকা যা মেসেজ হায়ারার্কি দেখায়। কোনও ফিল্ডের নাম হয় JSON অবজেক্ট কী অথবা protobuf ফিল্ড ট্যাগ নাম হয়। The field path starts from the top level response message type, and is optionally followed by one or more dots, and then the next level of field name. সাধারণত, ফিল্ড পাথ নিম্নলিখিত উপায়ে তৈরি করা হয়:
topLevelField[.secondLevelField][.thirdLevelField][...]
বিশেষ ফিল্ড মাস্ক হল ওয়াইল্ডকার্ড “*”, যা সব রুট-লেভেল ফিল্ড বেছে নেয়।
উদাহরণ
নিচের উদাহরণে দেখানো হয়েছে যে কীভাবে
ComputeRoutes() পদ্ধতির জন্য ফিল্ড মাস্ক সেট করতে হয়।
নমুনা ১
উপলভ্য সব ফিল্ডের ফিল্ড মাস্ক (ম্যানুয়াল পরিদর্শনের জন্য)।
X-Goog-FieldMask: *
নমুনা ২
রুট-লেভেল সময়সীমা, দূরত্ব ও পলিলাইনের ফিল্ড মাস্ক (একটি প্রোডাকশন সেট-আপের উদাহরণ)।
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
আমরা ওয়াইল্ডকার্ড (*) রেসপন্স ফিল্ড মাস্ক ব্যবহার করতে বা প্রোডাকশনে টপ লেভেলে (রুট) ফিল্ড মাস্ক নির্দিষ্ট করতে নিরুৎসাহিত করি। আপনার প্রয়োজনীয় ফিল্ডগুলি বেছে নেওয়া:
আমাদের সার্ভারকে প্রসেসিং সাইকেল সেভ করার অনুমতি দেয়, যা আমাদের আপনার ফলাফল কম লেটেন্সির সাথে ফেরত দিতে দেয়।
লেটেন্সি পারফর্ম্যান্স স্থিতিশীল থাকে। আমরা ভবিষ্যতে আরও রেসপন্স ফিল্ড যোগ করতে পারি এবং সেইসব নতুন ফিল্ডের জন্য অতিরিক্ত কম্পিউটেশন সময়ের প্রয়োজন হতে পারে। আপনি সব ফিল্ড বেছে নিলে অথবা টপ লেভেলে সব ফিল্ড বেছে নিলে, পারফর্ম্যান্সের অবনতি হতে পারে কারণ আমরা যে নতুন ফিল্ড যোগ করব তা অটোমেটিক আপনার উত্তরে অন্তর্ভুক্ত হয়ে যাবে।
এর ফলে ছোট আকারের উত্তর পাওয়া যায়, যার অর্থ হল নেটওয়ার্কের থ্রুপুট বেশি।
ফিল্ড পাথ কীভাবে তৈরি করতে হয় সেই সম্পর্কে আরও জানতে, field_mask.proto দেখুন।