যখন আপনি স্থানের বিশদ বিবরণ (নতুন) , কাছাকাছি অনুসন্ধান (নতুন) , বা পাঠ্য অনুসন্ধান (নতুন) পদ্ধতিতে কল করেন, তখন আপনাকে অবশ্যই নির্দিষ্ট করতে হবে যে প্রতিক্রিয়াতে আপনি কোন ক্ষেত্রগুলি ফিরিয়ে দিতে চান৷ প্রত্যাবর্তিত ক্ষেত্রের কোনো ডিফল্ট তালিকা নেই। আপনি যদি এই তালিকাটি বাদ দেন, পদ্ধতিগুলি একটি ত্রুটি ফেরত দেয়।
আপনি একটি প্রতিক্রিয়া ক্ষেত্র মাস্ক তৈরি করে ক্ষেত্রের তালিকা নির্দিষ্ট করুন। তারপরে আপনি $fields বা fields প্যারামিটার ব্যবহার করে অথবা HTTP বা gRPC হেডার X-Goog-FieldMask ব্যবহার করে যেকোনও পদ্ধতিতে রেসপন্স ফিল্ড মাস্ক পাস করুন।
আপনি অপ্রয়োজনীয় ডেটার অনুরোধ করবেন না তা নিশ্চিত করার জন্য ফিল্ড মাস্কিং একটি ভাল ডিজাইন অনুশীলন, যা অপ্রয়োজনীয় প্রক্রিয়াকরণের সময় এবং বিলিং চার্জ এড়াতে সহায়তা করে।
একটি প্রতিক্রিয়া ক্ষেত্রের মুখোশ সংজ্ঞায়িত করুন
রেসপন্স ফিল্ড মাস্ক হল পাথের একটি কমা-বিভক্ত তালিকা, যেখানে প্রতিটি পাথ প্রতিক্রিয়া বার্তায় একটি অনন্য ক্ষেত্র নির্দিষ্ট করে। পথটি শীর্ষ-স্তরের প্রতিক্রিয়া বার্তা থেকে শুরু হয় এবং নির্দিষ্ট ক্ষেত্রের জন্য একটি বিন্দু-বিচ্ছিন্ন পথ ব্যবহার করে।
নিম্নরূপ একটি ক্ষেত্রের পথ তৈরি করুন:
topLevelField[.secondLevelField][.thirdLevelField][...]
আপনি * এর একটি ফিল্ড মাস্ক ব্যবহার করে সমস্ত ক্ষেত্রে অনুরোধ করতে পারেন।
কীভাবে ফিল্ড মাস্ক তৈরি করবেন সে সম্পর্কে আরও তথ্যের জন্য, field_mask.proto দেখুন।
কোন ফিল্ড মাস্ক ব্যবহার করবেন তা নির্ধারণ করুন
আপনি কোন ফিল্ড মাস্ক ব্যবহার করতে চান তা আপনি কীভাবে নির্ধারণ করতে পারেন তা এখানে:
- `*` এর একটি ফিল্ড মাস্ক ব্যবহার করে সমস্ত ক্ষেত্রের অনুরোধ করুন।
- প্রতিক্রিয়াতে ক্ষেত্রগুলির শ্রেণিবিন্যাস দেখুন এবং আপনি কোন ক্ষেত্রগুলি চান তা নির্ধারণ করুন।
- ফিল্ড হায়ারার্কি ব্যবহার করে আপনার ফিল্ড মাস্ক তৈরি করুন।
কাছাকাছি অনুসন্ধান (নতুন) এবং পাঠ্য অনুসন্ধান (নতুন) এর জন্য একটি প্রতিক্রিয়া ক্ষেত্র মাস্ক সংজ্ঞায়িত করুন
কাছাকাছি অনুসন্ধান (নতুন) এবং পাঠ্য অনুসন্ধান (নতুন) প্রতিক্রিয়ার places ক্ষেত্রের স্থান বস্তুর একটি অ্যারে প্রদান করে। এই APIগুলির জন্য, places হল প্রতিক্রিয়ার শীর্ষ-স্তরের ক্ষেত্র।
উদাহরণস্বরূপ, একটি পাঠ্য অনুসন্ধান (নতুন) থেকে সম্পূর্ণ প্রতিক্রিয়া বস্তু দেখতে:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: *' \
'https://places.googleapis.com/v1/places:searchText'একটি পাঠ্য অনুসন্ধান (নতুন) কল থেকে সম্পূর্ণ প্রতিক্রিয়া অবজেক্টটি ফর্মটিতে রয়েছে:
{
"places": [
{
"name": "places/ChIJs5ydyTiuEmsR0fRSlU0C7k0",
"id": "ChIJs5ydyTiuEmsR0fRSlU0C7k0",
"types": [
"vegetarian_restaurant",
"vegan_restaurant",
"meal_takeaway",
"restaurant",
"food",
"point_of_interest",
"establishment"
],
"nationalPhoneNumber": "0433 479 794",
"internationalPhoneNumber": "+61 433 479 794",
"formattedAddress": "29 King St, Sydney NSW 2000, Australia",
"displayName": {
"text": "Spiced @ Barangaroo",
"languageCode": "en"
}, ...
},
...
]
}
অতএব, আপনি ফর্মে এই APIগুলির জন্য একটি ফিল্ড মাস্ক নির্দিষ্ট করুন:
places[.secondLevelField][.thirdLevelField][...]
আপনি যদি শুধুমাত্র formattedAddress এবং displayName ক্ষেত্রগুলি ফেরত দিতে চান তবে আপনার ফিল্ড মাস্ক সেট করুন:
places.formattedAddress,places.displayName
displayName নির্দিষ্ট করার ক্ষেত্রে displayName এর text এবং language উভয় ক্ষেত্রই অন্তর্ভুক্ত থাকে। আপনি যদি শুধুমাত্র text ক্ষেত্র চান, ফিল্ড মাস্কটি এইভাবে সেট করুন:
places.formattedAddress,places.displayName.text
স্থানের বিবরণের জন্য একটি প্রতিক্রিয়া ক্ষেত্র মাস্ক সংজ্ঞায়িত করুন (নতুন)
স্থানের বিবরণ ফর্মে একটি একক স্থান বস্তু প্রদান করে:
{
"name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
"id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
"types": [
"locality",
"political"
],
"formattedAddress": "Trinidad, CA 95570, USA",
"displayName": {
"text": "Trinidad",
"languageCode": "en"
}
...
}
অতএব, আপনি এই API এর জন্য একটি ফিল্ড মাস্ক নির্দিষ্ট করুন প্লেস অবজেক্টের ক্ষেত্রগুলি নির্দিষ্ট করে যা আপনি ফেরত দিতে চান:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: formattedAddress,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
gRPC কল
gRPC-এর জন্য, প্রতিক্রিয়া ক্ষেত্র মাস্ক ধারণকারী একটি পরিবর্তনশীল সেট করুন। আপনি তারপর অনুরোধ যে পরিবর্তনশীল পাস করতে পারেন.
const ( fieldMask = "places.formattedAddress,places.displayName" )
ক্ষেত্র পাথ বিবেচনা
আপনার প্রতিক্রিয়ার জন্য প্রয়োজনীয় ক্ষেত্রগুলি অন্তর্ভুক্ত করুন। আপনার প্রয়োজনীয় ক্ষেত্রগুলি ফিরিয়ে দেওয়া হচ্ছে:
- প্রক্রিয়াকরণের সময় হ্রাস করে , তাই আপনার ফলাফলগুলি কম বিলম্বে ফেরত দেওয়া হয়।
- স্থিতিশীল লেটেন্সি কর্মক্ষমতা নিশ্চিত করে যদি API ভবিষ্যতে আরও প্রতিক্রিয়া ক্ষেত্র যোগ করে এবং সেই নতুন ক্ষেত্রগুলির জন্য অতিরিক্ত গণনা সময় প্রয়োজন। আপনি যদি সমস্ত ক্ষেত্র নির্বাচন করেন, বা আপনি যদি শীর্ষ স্তরে সমস্ত ক্ষেত্র নির্বাচন করেন, আপনার প্রতিক্রিয়াতে সমস্ত নতুন ক্ষেত্র স্বয়ংক্রিয়ভাবে অন্তর্ভুক্ত হলে আপনি কর্মক্ষমতা হ্রাস পেতে পারেন।
- একটি ছোট প্রতিক্রিয়া আকারে ফলাফল , যা উচ্চতর নেটওয়ার্ক থ্রুপুটে অনুবাদ করে।
- নিশ্চিত করে যে আপনি অপ্রয়োজনীয় ডেটার অনুরোধ করবেন না , যা অপ্রয়োজনীয় প্রক্রিয়াকরণের সময় এবং বিল করা চার্জ এড়াতে সহায়তা করে।