MCP Tools Reference: mapstools.googleapis.com

টুল: search_places

ব্যবহারকারী যখন স্থান, ব্যবসা, ঠিকানা, অবস্থান, আগ্রহের স্থান, অথবা অন্য কোনও Google Maps সম্পর্কিত অনুসন্ধানের অনুরোধ করেন তখন এই টুলটি কল করুন।

ইনপুট প্রয়োজনীয়তা (গুরুত্বপূর্ণ):

  1. text_query (স্ট্রিং - বাধ্যতামূলক): প্রাথমিক অনুসন্ধান প্রশ্ন। এটি ব্যবহারকারী কী খুঁজছেন তা স্পষ্টভাবে সংজ্ঞায়িত করবে।

    • উদাহরণ: 'restaurants in New York' , 'coffee shops near Golden Gate Park' , 'SF MoMA' , '1600 Amphitheatre Pkwy, Mountain View, CA, USA' , 'pets friendly parks in Manhattan, New York' , 'date night restaurants in Chicago' , 'accessible public libraries in Los Angeles' ।
    • নির্দিষ্ট স্থানের বিবরণের জন্য: অনুরোধকৃত বৈশিষ্ট্যটি অন্তর্ভুক্ত করুন (যেমন, 'Google Store Mountain View opening hours' , 'SF MoMa phone number' , 'Shoreline Park Mountain View address' )।

  2. location_bias (বস্তু - ঐচ্ছিক): একটি নির্দিষ্ট ভৌগোলিক এলাকার কাছাকাছি ফলাফলগুলিকে অগ্রাধিকার দিতে এটি ব্যবহার করুন।

    • বিন্যাস: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
    • ব্যবহার:
      • ৫ কিমি ব্যাসার্ধে বায়াস করতে: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
      • কেন্দ্রবিন্দুতে দৃঢ়ভাবে পক্ষপাত করতে: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} ( radius_meters বাদ দিয়ে)।

  3. language_code (স্ট্রিং - ঐচ্ছিক): যে ভাষায় অনুসন্ধান ফলাফলের সারাংশ দেখানো হবে।

    • বিন্যাস: একটি দুই অক্ষরের ভাষা কোড (ISO 639-1), ঐচ্ছিকভাবে একটি আন্ডারস্কোর এবং একটি দুই অক্ষরের দেশ কোড (ISO 3166-1 alpha-2), যেমন, en , ja , en_US , zh_CN , es_MX । যদি ভাষা কোড প্রদান না করা হয়, তাহলে ফলাফল ইংরেজিতে হবে।

  4. region_code (string - ঐচ্ছিক): ব্যবহারকারীর ইউনিকোড CLDR অঞ্চল কোড। এই প্যারামিটারটি স্থানের বিবরণ প্রদর্শন করতে ব্যবহৃত হয়, যেমন অঞ্চল-নির্দিষ্ট স্থানের নাম, যদি পাওয়া যায়। প্রযোজ্য আইনের উপর ভিত্তি করে প্যারামিটারটি ফলাফলকে প্রভাবিত করতে পারে।

    • বিন্যাস: দুই অক্ষরের দেশের কোড (ISO 3166-1 alpha-2), যেমন, US , CA .

টুল কলের জন্য নির্দেশাবলী:

  • অবস্থানের তথ্য (গুরুত্বপূর্ণ): অনুসন্ধানে পর্যাপ্ত অবস্থানের তথ্য থাকতে হবে। যদি অবস্থানটি অস্পষ্ট হয় (যেমন, কেবল "পিৎজা স্থান"), তাহলে আপনাকে অবশ্যই এটি text_query (যেমন, "নিউ ইয়র্কের পিৎজা স্থান") এ উল্লেখ করতে হবে অথবা location_bias প্যারামিটার ব্যবহার করতে হবে। দ্ব্যর্থতা নিরসনের জন্য প্রয়োজনে শহর, রাজ্য/প্রদেশ এবং অঞ্চল/দেশের নাম অন্তর্ভুক্ত করুন।

  • সর্বদা সম্ভাব্য সবচেয়ে সুনির্দিষ্ট এবং প্রাসঙ্গিকভাবে সমৃদ্ধ text_query প্রদান করুন।

  • যদি স্থানাঙ্ক স্পষ্টভাবে প্রদান করা থাকে অথবা ব্যবহারকারীর পরিচিত প্রেক্ষাপট থেকে অবস্থান অনুমান করা উপযুক্ত এবং আরও ভালো ফলাফলের জন্য প্রয়োজনীয় হয়, তবেই কেবল location_bias ব্যবহার করুন।

নিচের নমুনাটি দেখায় কিভাবে search_places MCP টুলটি ব্যবহার করতে curl ব্যবহার করতে হয়।

কার্ল অনুরোধ 
                  
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_places",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

SearchText এর জন্য বার্তা অনুরোধ করুন।

SearchTextRequest সম্পর্কে

JSON উপস্থাপনা 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "pageToken": string,

  // Union field _location_bias can be only one of the following:
  "locationBias": {
    object (LocationBias)
  }
  // End of list of possible types for union field _location_bias.
}
ক্ষেত্র
textQuery

string

প্রয়োজনীয়। টেক্সট কোয়েরি।

languageCode

string

ঐচ্ছিক। সারাংশটি যে ভাষায় ফেরত পাঠানোর অনুরোধ করা হবে। যদি ভাষা কোডটি অনির্দিষ্ট বা অচেনা হয়, তাহলে ইংরেজি পছন্দের সারাংশটি ফেরত পাঠানো হবে।

উদাহরণস্বরূপ, ইংরেজির জন্য "en"।

সমর্থিত ভাষার বর্তমান তালিকা: https://developers.google.com/maps/faq#languagesupport ।

regionCode

string

ঐচ্ছিক। যে স্থান থেকে অনুরোধটি আসছে তার ইউনিকোড দেশ/অঞ্চল কোড (CLDR)। এই প্যারামিটারটি স্থানের বিবরণ প্রদর্শন করতে ব্যবহৃত হয়, যেমন অঞ্চল-নির্দিষ্ট স্থানের নাম, যদি পাওয়া যায়। প্রযোজ্য আইনের উপর ভিত্তি করে প্যারামিটারটি ফলাফলকে প্রভাবিত করতে পারে।

উদাহরণস্বরূপ, মার্কিন যুক্তরাষ্ট্রের জন্য "US"।

আরও তথ্যের জন্য, https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html দেখুন।

মনে রাখবেন যে ৩-সংখ্যার অঞ্চল কোড বর্তমানে সমর্থিত নয়।

pageSize

integer

ঐচ্ছিক। সর্বাধিক কতগুলি স্থান ফেরত পাঠানো যাবে। পরিষেবাটি এই মানের চেয়ে কম ফেরত দিতে পারে।

pageToken

string

ঐচ্ছিক। পূর্ববর্তী SearchText কল থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করার জন্য এটি প্রদান করুন।

ইউনিয়ন ক্ষেত্র _location_bias ।

_location_bias নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

locationBias

object ( LocationBias )

অনুসন্ধান ফলাফলগুলিকে পক্ষপাতী করার জন্য একটি ঐচ্ছিক অঞ্চল। যদি text_query তে একটি স্পষ্ট অবস্থান থাকে, তাহলে এই ক্ষেত্রের পরিবর্তে অনুসন্ধান ফলাফলগুলিকে পক্ষপাতী করার জন্য এটি ব্যবহার করা হবে।

অবস্থান পক্ষপাত

JSON উপস্থাপনা 
{
  "circle": {
    object (Circle)
  }
}
ক্ষেত্র
circle

object ( Circle )

ঐচ্ছিক। কেন্দ্রবিন্দু এবং ব্যাসার্ধ দ্বারা সংজ্ঞায়িত একটি বৃত্ত। radius_meters ঐচ্ছিক। যদি সেট না করা হয়, তাহলে ফলাফল কেন্দ্রবিন্দুর দিকে পক্ষপাতী হবে।

বৃত্ত

JSON উপস্থাপনা 
{
  "center": {
    object (google.type.LatLng)
  },

  // Union field _radius_meters can be only one of the following:
  "radiusMeters": number
  // End of list of possible types for union field _radius_meters.
}
ক্ষেত্র
center

object ( google.type.LatLng )

প্রয়োজনীয়। বৃত্তের কেন্দ্রবিন্দু।

ইউনিয়ন ক্ষেত্র _radius_meters ।

_radius_meters নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

radiusMeters

number

বৃত্তের ব্যাসার্ধ মিটারে। ব্যাসার্ধ অবশ্যই ৫০,০০০ মিটারের মধ্যে হতে হবে।

অক্ষাংশ

JSON উপস্থাপনা 
{
  "latitude": number,
  "longitude": number
}
ক্ষেত্র
latitude

number

ডিগ্রীতে অক্ষাংশ। এটি অবশ্যই [-৯০.০, +৯০.০] পরিসরে হতে হবে।

longitude

number

ডিগ্রীতে দ্রাঘিমাংশ। এটি অবশ্যই [-১৮০.০, +১৮০.০] পরিসরে হতে হবে।

আউটপুট স্কিমা

SearchText-এর জন্য প্রতিক্রিয়া বার্তা।

SearchTextResponse সম্পর্কে

JSON উপস্থাপনা 
{
  "places": [
    {
      object (PlaceView)
    }
  ],
  "summary": string,
  "nextPageToken": string
}
ক্ষেত্র
places[]

object ( PlaceView )

শুধুমাত্র আউটপুট। সারাংশে উল্লেখিত স্থানগুলির তালিকা।

summary

string

শুধুমাত্র আউটপুট। অনুসন্ধান ফলাফলের একটি প্রাকৃতিক ভাষা সারাংশ। সারাংশে "[0]", "[1]", "[2]" ইত্যাদির মতো শূন্য-ভিত্তিক উদ্ধৃতি থাকতে পারে। এই উদ্ধৃতিগুলি places ক্ষেত্রের সংশ্লিষ্ট স্থানগুলিতে ম্যাপ করে।

nextPageToken

string

ঐচ্ছিক। একটি টোকেন যা পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করার জন্য page_token হিসেবে পাঠানো যেতে পারে।

প্লেসভিউ

JSON উপস্থাপনা 
{
  "place": string,
  "id": string,
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },

  // Union field _location can be only one of the following:
  "location": {
    object (google.type.LatLng)
  }
  // End of list of possible types for union field _location.
}
ক্ষেত্র
place

string

"places/{id}" ফর্ম্যাটে অন্তর্নিহিত স্থানের সম্পদের নাম।

id

string

অন্তর্নিহিত স্থানের স্থান আইডি।

googleMapsLinks

object ( GoogleMapsLinks )

বিভিন্ন Google Maps অ্যাকশন ট্রিগার করার লিঙ্ক।

ইউনিয়ন ক্ষেত্র _location ।

_location নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

location

object ( google.type.LatLng )

এই জায়গার অবস্থান।

অক্ষাংশ

JSON উপস্থাপনা 
{
  "latitude": number,
  "longitude": number
}
ক্ষেত্র
latitude

number

ডিগ্রীতে অক্ষাংশ। এটি অবশ্যই [-৯০.০, +৯০.০] পরিসরে হতে হবে।

longitude

number

ডিগ্রীতে দ্রাঘিমাংশ। এটি অবশ্যই [-১৮০.০, +১৮০.০] পরিসরে হতে হবে।

JSON উপস্থাপনা 
{
  "directionsUrl": string,
  "placeUrl": string,
  "writeAReviewUrl": string,
  "reviewsUrl": string,
  "photosUrl": string
}
ক্ষেত্র
directionsUrl

string

স্থানের দিকনির্দেশনা দেখানোর জন্য একটি লিঙ্ক। লিঙ্কটি শুধুমাত্র গন্তব্যের অবস্থান পূরণ করে এবং ডিফল্ট ভ্রমণ মোড DRIVE ব্যবহার করে।

placeUrl

string

এই জায়গাটি দেখানোর জন্য একটি লিঙ্ক।

writeAReviewUrl

string

গুগল ম্যাপে এই জায়গার পর্যালোচনা লেখার জন্য একটি লিঙ্ক।

reviewsUrl

string

গুগল ম্যাপে এই জায়গার পর্যালোচনা দেখানোর জন্য একটি লিঙ্ক।

photosUrl

string

গুগল ম্যাপে এই জায়গার পর্যালোচনা দেখানোর জন্য একটি লিঙ্ক।

টুল টীকা

ধ্বংসাত্মক ইঙ্গিত: ❌ | অদম্য ইঙ্গিত: ❌ | কেবল পঠনযোগ্য ইঙ্গিত: ✅ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌