যখন আপনি একটি জিওকোডিং অনুরোধ করেন, তখন আপনি প্রতিক্রিয়াতে ফিরে আসার জন্য ক্ষেত্রগুলির তালিকা নির্দিষ্ট করতে একটি ফিল্ড মাস্ক ব্যবহার করতে পারেন। Geocode an address , Geocode a location , এবং Place geocoding endpoints এর জন্য, প্রতিক্রিয়া বস্তুর সমস্ত ক্ষেত্র ডিফল্টরূপে ফেরত পাঠানো হয়। Search for destinations endpoint এর জন্য, আপনাকে 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 দেখুন।