ফেরত পাঠানোর জন্য ফিল্ড বেছে নিন

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 দেখুন।