search_places টুলটি একটি LLM-কে ন্যাচারাল ল্যাঙ্গুয়েজ কোয়েরি থেকে Google Maps-এ জায়গা খুঁজতে দেয়। এই টুলটি মিলে যাওয়া জায়গাগুলির AI-জেনারেটেড সারসংক্ষেপ প্রদান করে।
সারসংক্ষেপে উল্লেখ করা প্রতিটি জায়গার জন্য, এটি জায়গার আইডি,
স্থানাঙ্ক, Google Maps লিঙ্ক এবং অ্যাট্রিবিউশনও প্রদান করে।
এই পৃষ্ঠায় অনুরোধের বিকল্পগুলি বর্ণনা করা হয়েছে, যার মধ্যে রয়েছে
Pro বিকল্প;
উত্তরে কী কী থাকে; এবং অনুরোধের জন্য কীভাবে বিল করা হয়। সম্পূর্ণ টুল
স্কিমার জন্য,
search_places রেফারেন্স দেখুন।
অনুরোধের বিকল্প
ব্যবহারকারীর অনুরোধ এবং টুলের বিবরণের উপর ভিত্তি করে, টুল কল করার সময় LLM এইসব বিকল্প সেট করে। আপনার নিজস্ব নির্দেশাবলীর মাধ্যমে মডেল কোন বিকল্প ব্যবহার করবে তা আপনি প্রভাবিত করতে পারেন; Pro ব্যবহার নিয়ন্ত্রণ করুন দেখুন।
| Option | বিবরণ |
|---|---|
text_query |
প্রয়োজনীয়। সার্চ কোয়েরি, যেমন coffee shops near Golden Gate Park। কোয়েরিতে অবশ্যই পর্যাপ্ত লোকেশন তথ্য থাকতে হবে যাতে কোনও অস্পষ্টতা না থাকে অথবা অনুরোধে অবশ্যই location_bias অন্তর্ভুক্ত থাকতে হবে। |
location_bias |
একটি বৃত্ত (center এবং ঐচ্ছিক radius_meters, ৫০,০০০ মিটার পর্যন্ত) যার দিকে ফলাফল পক্ষপাতদুষ্ট হয়। text_query যদি কোনও নির্দিষ্ট লোকেশনের নাম উল্লেখ করে, তাহলে তার পরিবর্তে সেই লোকেশন ব্যবহার করা হয়। |
language_code |
সারসংক্ষেপের ভাষা, যেমন en বা ja। ডিফল্ট হিসেবে ইংরেজি সেট করা থাকে। |
region_code |
ব্যবহারকারীর CLDR অঞ্চল কোড, যেমন US। অঞ্চল-নির্দিষ্ট জায়গার নামকে প্রভাবিত করে এবং প্রযোজ্য আইনের ভিত্তিতে ফলাফলকে প্রভাবিত করতে পারে। |
page_size |
ফেরত দেওয়ার জন্য সর্বাধিক সংখ্যক জায়গা। ডিফল্ট হল ৫। ৬ থেকে ১০ পর্যন্ত ভ্যালু হল Pro বিকল্প। ১০-এর বেশি ভ্যালু হলে INVALID_ARGUMENT সমস্যা দেখায়। পরিষেবাটি অনুরোধের চেয়ে কম জায়গা দেখাতে পারে। |
include_extended_details |
true হলে, সারসংক্ষেপে জায়গার বিস্তারিত বিবরণ অন্তর্ভুক্ত থাকে। এটি একটি Pro বিকল্প। ডিফল্ট হিসেবে false সেট করা থাকে। |
Pro বিকল্প
দুটি বিকল্প Pro SKU বেছে নেয়। যে অনুরোধে একটি বা দুটিই ব্যবহার করা হয়, সেটির বিল Pro SKU-এর অধীনে করা হয়:
| প্রো বিকল্প | কখন ব্যবহার করবেন |
|---|---|
true এ include_extended_details সেট করা হয়েছে |
ব্যবহারকারীর অনুরোধে জায়গার বিস্তারিত বিবরণ প্রয়োজন, যেমন রিভিউ থেকে ইনসাইট, মেনু হাইলাইট, পরিবেশ বা ভিজিটরদের জন্য পরামর্শ। |
page_size: ৬ থেকে ১০ পর্যন্ত |
ব্যবহারকারী ৫টির বেশি জায়গার মধ্যে তুলনা করতে চান। |
যেসব অনুরোধে কোনও বিকল্পই ব্যবহার করা হয় না, যার মধ্যে ১ থেকে ৫ পর্যন্ত page_size সহ অনুরোধও পড়ে, সেগুলির জন্য Essentials SKU-এর অধীনে বিল করা হয়।
জায়গার বিস্তারিত বিবরণ
ব্যবহারকারীর অনুরোধে গুণগত ইনসাইট, রিয়েল-টাইম পরিস্থিতি বা বিশেষ অ্যাট্রিবিউটের প্রয়োজন হলে, include_extended_details-কে true-এ সেট করুন, যেমন:
- পর্যালোচনাকারীরা কী বলেন: রিভিউ-ভিত্তিক ইনসাইট, গ্রাহকের মনোভাব এবং মতামত।
- নির্দিষ্ট অফার: মেনু আইটেম, ডিশ, খাবারের বিশেষত্ব, পানীয় বা ব্যবসার হাইলাইট।
- পরিবেশ: ইন্টিরিয়র ডেকর, নান্দনিকতা, পরিবেশ বা মুড।
- দর্শকদের জন্য ব্যবহারিক পরামর্শ: আগে থেকে বুক করতে হবে কিনা, ওয়াক-ইন নীতি, অপেক্ষা করার সময়, জায়গাটি কতটা ব্যস্ত, পার্কিং এবং সুবিধা।
- প্রক্সিমিটি: কোয়েরি লোকেশন থেকে দূরত্ব বা ভ্রমণের সময়, অথবা
location_biasকেন্দ্র, যখন ব্যবহারকারী জিজ্ঞাসা করেন যে কাছাকাছি বা সবচেয়ে কাছে কী আছে।
সারসংক্ষেপের ইনসাইট কোয়েরি এবং প্রতিটি জায়গার জন্য উপলভ্য ডেটার উপর নির্ভর করে। সব ধরনের ইনসাইট প্রতিটি উত্তরে দেখানো হয় না।
স্ট্যান্ডার্ড সার্চের জন্য এটি false (ডিফল্ট) হিসেবে ছেড়ে দিন: ক্যুইজিন বা স্টোরের ধরন,
ঠিকানা, যোগাযোগের তথ্য, খোলা থাকার সময় এবং স্ট্যান্ডার্ড সুযোগ-সুবিধা। বিস্তারিত তথ্য সহ
অনুরোধ সম্পূর্ণ হতে বেশি সময় লাগে।
বিস্তারিত বিবরণ উত্তরের গঠন পরিবর্তন করে না। সেগুলি না থাকলে, সারসংক্ষেপে প্রতিটি জায়গার বিবরণ এক বা দুটি বাক্যে দেওয়া হয়। এর মাধ্যমে, প্রতিটি জায়গার আরও বড় বিবরণ পাওয়া যায় যা Google Maps-এর আরও ডেটা ব্যবহার করে, যার মধ্যে রিভিউ থেকে পাওয়া ইনসাইটও অন্তর্ভুক্ত। দুটি SKU-এর জন্য স্ট্রাকচার্ড places এন্ট্রি একই।
উদাহরণ
নিম্নলিখিত অনুরোধে বিস্তারিত বিবরণ সহ সর্বাধিক ৮টি জায়গার তথ্য চাওয়া হয়েছে। এটি Pro SKU-এর অধীনে বিল করা হয়:
{
"method": "tools/call",
"params": {
"name": "search_places",
"arguments": {
"text_query": "date night Italian restaurants in Chicago",
"page_size": 8,
"include_extended_details": true
}
},
"jsonrpc": "2.0",
"id": 1
}
বিস্তারিত বিবরণ ছাড়াই, সারসংক্ষেপ প্রতিটি জায়গাকে এক বা দুটি বাক্যে বর্ণনা করে:
Example Trattoria [0] (4.6★ (1,250) · 123 W Example St · $$$) A neighborhood trattoria known for handmade pasta and a long wine list.
With extended details, the summary adds what reviewers highlight and practical tips:
Example Trattoria [0] (4.6★ (1,250) · 123 W Example St · $$$) মোমবাতির আলোয় আলোকিত, অন্তরঙ্গ ডাইনিং রুম যা পর্যালোচকরা রোমান্টিক কিন্তু সপ্তাহান্তে কোলাহলপূর্ণ বলে বর্ণনা করেন। বিশেষ পদের মধ্যে রয়েছে ট্যাগলিয়াটেল আল রাগু, বুরাটা ও তিরামিসু। রিজার্ভেশন করে আসা ভাল; রিজার্ভেশন না করে এলে শুক্রবার ও শনিবার সন্ধ্যায় ৩০–৪৫ মিনিট অপেক্ষা করতে হতে পারে এবং স্ট্রিট পার্কিংয়ের জায়গা সীমিত।
রেসপন্স
উত্তরে এগুলি রয়েছে:
summary: সার্চ ফলাফলের ন্যাচারাল ল্যাঙ্গুয়েজ সারসংক্ষেপ। এতে[0]-এর মতো শূন্য-ভিত্তিক উদ্ধৃতি থাকতে পারে, যাplaces-এর এন্ট্রিতে ম্যাপ করা হয়।places[]: সারসংক্ষেপে উল্লেখ করা জায়গা। প্রতিটি জায়গায় এগুলি অন্তর্ভুক্ত:place: জায়গার রিসোর্স নাম,places/{id}ফর্ম্যাটে।id: জায়গার আইডি। আপনি এটি অন্যান্য Google Maps Platform API-এর সাথে ব্যবহার করতে পারেন, যেমন, ম্যাপে জায়গাটি দেখানোর জন্য।location: জায়গার অক্ষাংশ ও দ্রাঘিমাংশ।googleMapsLinks: জায়গার জন্য Google Maps লিঙ্ক (placeUrl), দিকনির্দেশ (directionsUrl), রিভিউ (reviewsUrl), ফটো (photosUrl) এবং রিভিউ লেখা (writeAReviewUrl)।attribution: অ্যাট্রিবিউশন যা আপনাকে অবশ্যই জায়গার সাথে দেখাতে হবে। অ্যাট্রিবিউশন সংক্রান্ত প্রয়োজনীয়তা দেখুন।
উত্তরে দুটি SKU-এর জন্য একই স্ট্রাকচার আছে। ফিল্ডের বিবরণের জন্য,
search_places রেফারেন্স দেখুন।
সীমাবদ্ধ GA চলাকালীন Pro বিকল্প
Restricted GA চলাকালীন, Pro বিকল্পগুলি শুধুমাত্র Pro অনুমোদিত তালিকায় থাকা প্রোজেক্টের জন্য উপলভ্য। আপনার প্রোজেক্ট এখনও অনুমোদিত তালিকায় না থাকলে, প্রো বিকল্পগুলি বাতিল করার পরিবর্তে উপেক্ষা করা হয়:
include_extended_details-কেfalseহিসেবে বিবেচনা করা হয়।page_size-এর ভ্যালু ৫-এর বেশি হলে, ১০-এর বেশি ভ্যালু সহ, তা কমিয়ে ৫ করা হয়।
Essentials SKU-এর অধীনে অনুরোধের বিল করা হয়। অ্যাক্সেসের অনুরোধ করতে, সীমাবদ্ধ GA চলাকালীন Pro বিকল্প দেখুন।
বিলিং ও কোটা
প্রতিটি search_places অনুরোধ হল একটি বিলেবল ইভেন্ট:
- কোনও অনুরোধে Pro বিকল্প ব্যবহার না করা হলে, সেটির জন্য Essentials SKU-এর অধীনে বিল করা হয়।
- Pro বিকল্প ব্যবহার করে করা অনুরোধ Pro SKU-এর অধীনে বিল করা হয়। একটি অনুরোধে দুটি বিকল্পই ব্যবহার করলে চার্জে কোনও পরিবর্তন হয় না। Pro-এর দাম জানতে, Essentials, Pro এবং Grounding with Google Maps-এর তুলনা করুন দেখুন।
search_places কোটা হল প্রতি মিনিটে, প্রতি প্রোজেক্টে ৩০০টি কোয়েরি, যা দুটি SKU-এর
মাধ্যমে শেয়ার করা হয়। মূল্য সংক্রান্ত তথ্যের জন্য,
মূল্য সংক্রান্ত প্রধান টেবিল এবং
ভারতের জন্য মূল্য সংক্রান্ত টেবিল দেখুন।