আপনি যখন একটি রুট গণনা করার জন্য একটি পদ্ধতি কল করেন বা একটি রুট ম্যাট্রিক্স গণনা করেন, তখন আপনাকে অবশ্যই নির্দিষ্ট করতে হবে যে প্রতিক্রিয়াতে আপনি কোন ক্ষেত্রগুলি ফিরিয়ে দিতে চান। প্রত্যাবর্তিত ক্ষেত্রের কোনো ডিফল্ট তালিকা নেই। আপনি যদি এই তালিকাটি বাদ দেন, পদ্ধতিগুলি একটি ত্রুটি ফেরত দেয়।
একটি প্রতিক্রিয়া ক্ষেত্র মাস্ক তৈরি করে ক্ষেত্রের তালিকা নির্দিষ্ট করুন। তারপরে আপনি URL প্যারামিটার $fields বা fields ব্যবহার করে বা HTTP/gRPC হেডার X-Goog-FieldMask ব্যবহার করে প্রতিটি পদ্ধতিতে প্রতিক্রিয়া ক্ষেত্র মাস্ক পাস করুন।
আপনি অপ্রয়োজনীয় ডেটার অনুরোধ করবেন না তা নিশ্চিত করার জন্য ফিল্ড মাস্কিং একটি ভাল ডিজাইন অনুশীলন, যা অপ্রয়োজনীয় প্রক্রিয়াকরণের সময় এবং বিলিং চার্জ এড়াতে সহায়তা করে।
URL প্যারামিটার সম্পর্কে আরও তথ্যের জন্য, সিস্টেম প্যারামিটার দেখুন।
একটি প্রতিক্রিয়া ক্ষেত্রের মুখোশ সংজ্ঞায়িত করুন
রেসপন্স ফিল্ড মাস্ক হল পাথের একটি কমা-বিভক্ত তালিকা, যেখানে প্রতিটি পাথ প্রতিক্রিয়া বার্তায় একটি অনন্য ক্ষেত্র নির্দিষ্ট করে। পথটি শীর্ষ-স্তরের প্রতিক্রিয়া বার্তা থেকে শুরু হয় এবং নির্দিষ্ট ক্ষেত্রের জন্য একটি বিন্দু-বিচ্ছিন্ন পথ ব্যবহার করে।
ক্ষেত্র পাথ নিম্নলিখিত উপায়ে নির্মিত হয়:
topLevelField[.secondLevelField][.thirdLevelField][...]
গণনা রুট পদ্ধতির জন্য, ক্ষেত্রের পাথগুলি নির্দিষ্ট করে:
গণনা রুট ম্যাট্রিক্স পদ্ধতির জন্য, ফিল্ড পাথগুলি এর ক্ষেত্রগুলি নির্দিষ্ট করে:
- REST: প্রতিক্রিয়া শরীরের ক্ষেত্র ফিরে.
- gRPC: ফিরে আসার প্রতিক্রিয়াতে RouteMatrixElement অবজেক্টের ক্ষেত্র।
ফিল্ড পাথ কিভাবে নির্মাণ করতে হয় সে সম্পর্কে আরও তথ্যের জন্য, field_mask.proto দেখুন।
একটি ক্ষেত্রের পথ নির্দিষ্ট করুন
এই বিভাগে একটি প্রতিক্রিয়া ফিল্ড মাস্কের অংশ হিসাবে একটি ফিল্ড পাথ কীভাবে নির্দিষ্ট করতে হয় তার উদাহরণ রয়েছে।
computeRoutes কল করুন
প্রথম উদাহরণে, আপনি একটি রুট গণনা করতে computeRoutes পদ্ধতিতে একটি REST কল ব্যবহার করেন। এই উদাহরণে, আপনি উত্তরে Route.distanceMeters এবং Route.duration ক্ষেত্রগুলি ফেরত দেওয়ার জন্য নির্দিষ্ট করেছেন। " routes.
X-Goog-FieldMask: routes.distanceMeters,routes.duration
computeRouteMatrix এ REST কল করুন
একটি রুট ম্যাট্রিক্স গণনা করতে ব্যবহৃত REST computeRouteMatrix পদ্ধতির জন্য, মূল এবং গন্তব্যের প্রতিটি সংমিশ্রণের জন্য originIndex , destinationIndex এবং duration ফেরত দিতে নির্দিষ্ট করুন:
X-Goog-FieldMask: originIndex,destinationIndex,duration
gRPC কল
gRPC-এর জন্য, প্রতিক্রিয়া ক্ষেত্র মাস্ক ধারণকারী একটি পরিবর্তনশীল সেট করুন। আপনি তারপর অনুরোধ যে পরিবর্তনশীল পাস করতে পারেন.
const ( fieldMask = "routes.distanceMeters,routes.duration,routes.polyline.encodedPolyline" )
ক্ষেত্র পাথ বিবেচনা
আপনার প্রতিক্রিয়ার জন্য প্রয়োজনীয় ক্ষেত্রগুলি অন্তর্ভুক্ত করুন। আপনার প্রয়োজনীয় ক্ষেত্রগুলি ফিরিয়ে দেওয়া হচ্ছে:
আমাদের সার্ভারকে প্রক্রিয়াকরণ চক্র সংরক্ষণ করার অনুমতি দেয়, যা আমাদেরকে কম বিলম্বে আপনার ফলাফল ফেরত দিতে দেয়।
স্থিতিশীল লেটেন্সি কর্মক্ষমতা নিশ্চিত করে। আমরা ভবিষ্যতে আরও প্রতিক্রিয়া ক্ষেত্র যোগ করতে পারি, এবং সেই নতুন ক্ষেত্রগুলির জন্য অতিরিক্ত গণনা সময় প্রয়োজন হতে পারে। আপনি যদি সমস্ত ক্ষেত্র নির্বাচন করেন, বা আপনি যদি শীর্ষ স্তরে সমস্ত ক্ষেত্র নির্বাচন করেন, তাহলে আপনি কর্মক্ষমতা হ্রাস পেতে পারেন কারণ আমরা যে নতুন ক্ষেত্র যোগ করি তা স্বয়ংক্রিয়ভাবে আপনার প্রতিক্রিয়াতে অন্তর্ভুক্ত হবে।
একটি ছোট প্রতিক্রিয়া আকারে ফলাফল, যা উচ্চতর নেটওয়ার্ক থ্রুপুটে অনুবাদ করে।
নিশ্চিত করে যে আপনি অপ্রয়োজনীয় ডেটার অনুরোধ করবেন না, যা অপ্রয়োজনীয় প্রক্রিয়াকরণের সময় এবং বিলিং চার্জ এড়াতে সহায়তা করে।