আপনি যখন একটি জিওকোডিং অনুরোধ করেন, আপনি প্রতিক্রিয়াতে ফিরে আসার জন্য ক্ষেত্রগুলির তালিকা নির্দিষ্ট করতে একটি ফিল্ড মাস্ক ব্যবহার করতে পারেন। জিওকোড একটি ঠিকানা , একটি অবস্থান জিওকোড , এবং স্থান জিওকোডিং এন্ডপয়েন্টের জন্য, প্রতিক্রিয়া অবজেক্টের সমস্ত ক্ষেত্র ডিফল্টরূপে ফেরত দেওয়া হয়৷ গন্তব্য এন্ডপয়েন্টের জন্য অনুসন্ধানের জন্য, আপনাকে API অনুরোধে একটি ফিল্ড মাস্ক নির্দিষ্ট করতে হবে।
আপনি অপ্রয়োজনীয় ডেটার অনুরোধ করবেন না তা নিশ্চিত করতে একটি ফিল্ড মাস্ক ব্যবহার করুন, যা ফলস্বরূপ প্রতিক্রিয়া লেটেন্সিতে সহায়তা করে।
একটি প্রতিক্রিয়া ক্ষেত্রের মুখোশ সংজ্ঞায়িত করুন
রেসপন্স ফিল্ড মাস্ক হল কোনো স্পেস ছাড়া পাথের একটি কমা-বিভক্ত তালিকা, যেখানে প্রতিটি পাথ রেসপন্স অবজেক্টে একটি অনন্য ক্ষেত্র নির্দিষ্ট করে। পথটি শীর্ষ-স্তরের প্রতিক্রিয়া ক্ষেত্র থেকে শুরু হয় এবং একটি নির্দিষ্ট ক্ষেত্রের জন্য একটি বিন্দু-বিচ্ছিন্ন পথ ব্যবহার করে।
URL প্যারামিটার $fields বা fields ব্যবহার করে বা HTTP বা gRPC হেডার X-Goog-FieldMask ব্যবহার করে একটি অনুরোধে প্রতিক্রিয়া ক্ষেত্র মাস্ক পাস করুন।
ফিল্ড মাস্কের উদাহরণ
একটি ফরওয়ার্ড জিওকোডিং অনুরোধ থেকে সম্পূর্ণ প্রতিক্রিয়া নীচে দেখানো হয়েছে:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJF4Yf2Ry7j4AR__1AkytDyAE", "placeId": "ChIJF4Yf2Ry7j4AR__1AkytDyAE", "location": { "latitude": 37.422010799999995, "longitude": -122.08474779999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.420656719708511, "longitude": -122.08547523029148 }, "high": { "latitude": 37.4233546802915, "longitude": -122.0827772697085 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", ... }
প্রতিক্রিয়া ক্ষেত্রগুলির শ্রেণিবিন্যাস ব্যবহার করে আপনার ফিল্ড মাস্কগুলি ফর্মটিতে তৈরি করুন:
topLevelField[.secondLevelField][.thirdLevelField][...]
উদাহরণস্বরূপ, প্রতিক্রিয়াতে শুধুমাত্র placeId ক্ষেত্রটি ফেরত দিতে, এর একটি ক্ষেত্র মাস্ক ব্যবহার করুন:
curl -X GET -H 'Content-Type: application/json' \ -H 'X-Goog-FieldMask: results.placeId' \ -H "X-Goog-Api-Key: API_KEY" \ "https://"geocode.googleapis.com/v4beta/"geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
প্রতিক্রিয়া এখন হল:
{ "results": [ { "placeId": "ChIJF4Yf2Ry7j4AR__1AkytDyAE" } ] }
viewport ফিল্ড ফেরত দিতে, আপনার ফিল্ড মাস্ক হল:
-H 'X-Goog-FieldMask: results.viewport'
প্রতিক্রিয়া এখন হল:
{ "results": [ { "viewport": { "low": { "latitude": 37.420654569708496, "longitude": -122.08547618029148 }, "high": { "latitude": 37.423352530291496, "longitude": -122.0827782197085 } } } ] }
উভয় ফেরত দিতে:
-H 'X-Goog-FieldMask: results.placeId,results.viewport'
প্রতিক্রিয়া এখন হল:
{ "results": [ { "placeId": "ChIJF4Yf2Ry7j4AR__1AkytDyAE", "viewport": { "low": { "latitude": 37.420654569708496, "longitude": -122.08547618029148 }, "high": { "latitude": 37.423352530291496, "longitude": -122.0827782197085 } } } ] }
জিআরপিসি ফিল্ড মাস্ক
gRPC-এর জন্য, প্রতিক্রিয়া ক্ষেত্র মাস্ক ধারণকারী একটি পরিবর্তনশীল সেট করুন। আপনি তারপর অনুরোধ যে পরিবর্তনশীল পাস করতে পারেন.
const ( fieldMask = "results.placeId,results.viewport" )
ক্ষেত্র পাথ বিবেচনা
শুধুমাত্র আপনার প্রয়োজনীয় ক্ষেত্রগুলি ফেরত দেওয়ার জন্য প্রতিক্রিয়াতে আপনার প্রয়োজনীয় ক্ষেত্রগুলি অন্তর্ভুক্ত করুন:
- প্রক্রিয়াকরণের সময় হ্রাস করে , তাই আপনার ফলাফলগুলি কম বিলম্বে ফেরত দেওয়া হয়।
- স্থিতিশীল লেটেন্সি কর্মক্ষমতা নিশ্চিত করে । আপনি যদি সমস্ত ক্ষেত্র নির্বাচন করেন, বা আপনি যদি শীর্ষ স্তরে সমস্ত ক্ষেত্র নির্বাচন করেন, নতুন ক্ষেত্রগুলি যোগ করা হলে এবং তারপরে স্বয়ংক্রিয়ভাবে আপনার প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হলে আপনি কর্মক্ষমতা হ্রাস পেতে পারেন।
- একটি ছোট প্রতিক্রিয়া আকারে ফলাফল , যা উচ্চতর নেটওয়ার্ক থ্রুপুটে অনুবাদ করে।
ফিল্ড মাস্ক তৈরির বিষয়ে আরও বিস্তারিত জানার জন্য, field_mask.proto দেখুন।