MCP Tools Reference: mapstools.googleapis.com

টুল: search_places

ব্যবহারকারীর অনুরোধ যখন কোনো স্থান, ব্যবসা প্রতিষ্ঠান, ঠিকানা, অবস্থান, দর্শনীয় স্থান বা গুগল ম্যাপস-সম্পর্কিত অন্য কোনো কিছু খোঁজার জন্য হয়, তখন এই টুলটি চালু করুন।

ইনপুট প্রয়োজনীয়তা (অত্যাবশ্যক):

  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 (স্ট্রিং - ঐচ্ছিক): ব্যবহারকারীর ইউনিকোড CLDR অঞ্চল কোড। এই প্যারামিটারটি স্থানের বিবরণ, যেমন অঞ্চল-নির্দিষ্ট স্থানের নাম (যদি উপলব্ধ থাকে), প্রদর্শন করতে ব্যবহৃত হয়। প্রযোজ্য আইনের উপর ভিত্তি করে এই প্যারামিটারটি ফলাফলকে প্রভাবিত করতে পারে।

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

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

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

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

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

  • attribution ফিল্ড থেকে প্রাপ্ত তথ্য ব্যবহার করে গ্রাউন্ডেড আউটপুটটির উৎস উল্লেখ করতে হবে, যদি তা উপলব্ধ থাকে।

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

কার্ল অনুরোধ 
                  
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-এর জন্য অনুরোধ বার্তা।

অনুসন্ধান পাঠ্য অনুরোধ

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 (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 ( LatLng )

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

ইউনিয়ন ফিল্ড _radius_meters .

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

radiusMeters

number

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

অক্ষাংশ দ্রাঘিমাংশ

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

number

অক্ষাংশ ডিগ্রিতে। এটি অবশ্যই [-90.0, +90.0] সীমার মধ্যে হতে হবে।

longitude

number

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

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

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

অনুসন্ধান পাঠ্য প্রতিক্রিয়া

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)
  },
  "attribution": {
    object (Attribution)
  },

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

string

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

id

string

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

googleMapsLinks

object ( GoogleMapsLinks )

গুগল ম্যাপসের বিভিন্ন কার্যকলাপ চালু করার লিঙ্ক।

attribution

object ( Attribution )

স্থানটির সাথে উল্লেখ করা আবশ্যক।

ইউনিয়ন ফিল্ড _location .

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

location

object ( LatLng )

এই স্থানটির অবস্থান।

অক্ষাংশ দ্রাঘিমাংশ

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

number

অক্ষাংশ ডিগ্রিতে। এটি অবশ্যই [-90.0, +90.0] সীমার মধ্যে হতে হবে।

longitude

number

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

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

string

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

placeUrl

string

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

writeAReviewUrl

string

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

reviewsUrl

string

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

photosUrl

string

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

অ্যাট্রিবিউশন

JSON উপস্থাপনা 
{
  "title": string,
  "url": string
}
ক্ষেত্র
title

string

কৃতিত্ব প্রদানের জন্য প্রদর্শিত শিরোনাম।

url

string

অ্যাট্রিবিউশনের জন্য লিঙ্ক করার ইউআরএল।

টুল টীকা

ধ্বংসাত্মক ইঙ্গিত: ❌ | স্ব-সূচক ইঙ্গিত: ❌ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ✅ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌