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 (string - OPTIONAL): যে ভাষায় সার্চ ফলাফলের সারসংক্ষেপ দেখানো হবে।

    • ফর্ম্যাট: দুই অক্ষরের ভাষা কোড (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 ফিল্ড থেকে তথ্য ব্যবহার করতে হবে, যদি তা উপলভ্য থাকে।

search_places MCP টুল কল করার জন্য কীভাবে curl ব্যবহার করতে হয় তা নিম্নলিখিত কোড স্যাম্পেল থেকে জানতে পারবেন।

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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

SearchText-এর জন্য অনুরোধের মেসেজ।

SearchTextRequest

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

  // 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

ঐচ্ছিক। সর্বাধিক ৫টি জায়গা দেখানো হবে। পরিষেবাটি এই মানের চেয়ে কম রিটার্ন করতে পারে। ডিফল্ট ভ্যালু হল ৫।
includeExtendedDetails

boolean

ঐচ্ছিক। উত্তরে জায়গার আরও বিবরণ অন্তর্ভুক্ত করে।

ব্যবহারকারীর অনুরোধে সমৃদ্ধ গুণগত ইনসাইট, রিয়েল-টাইম ডায়নামিক্স বা বিশেষ এন্টিটি অ্যাট্রিবিউট প্রয়োজন হলে এই ফিল্ড true-এ সেট করুন: - গুণগত রিভিউ, গ্রাহকের মনোভাব ও মতামত। - নির্দিষ্ট অফার যেমন মেনু আইটেম, ডিশ, খাবারের বিশেষত্ব, পানীয় বা ব্যবসার হাইলাইট। - গুণগত পরিবেশ, ইন্টিরিয়র ডেকর, নান্দনিকতা, পরিবেশ বা মুড। - রিয়েল-টাইম ডেটা এবং বিশেষ সুবিধার স্পেসিফিকেশন, ভিজিটর নীতি/পরামর্শ, কতক্ষণ অপেক্ষা করতে হবে।

স্ট্যান্ডার্ড ডিসকভারি সার্চ (যেমন, ক্যুইজিন, স্টোরের ধরন), লোকেশন/ঠিকানা লুক-আপ, পরিচিতির তথ্য, অপারেটিং সময় এবং স্ট্যান্ডার্ড মেটাডেটা/সুযোগ-সুবিধার জন্য false (ডিফল্ট) ছেড়ে দিন।

এই ফিল্ড চালু করলে আরও বেশি লেটেন্সি হবে।

_location_bias ফিল্ড একত্রিত করুন।

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

object (LocationBias)

সার্চ ফলাফলকে প্রভাবিত করার জন্য একটি ঐচ্ছিক অঞ্চল। text_query-এ কোনও সুনির্দিষ্ট লোকেশন থাকলে, এই ফিল্ডের পরিবর্তে সার্চ ফলাফলকে প্রভাবিত করতে সেটি ব্যবহার করা হবে।

LocationBias

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

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

LatLng

JSON উপস্থাপনা 
{
  "latitude": number,
  "longitude": number
}
ফিল্ড
latitude

number

ডিগ্রিতে অক্ষাংশ। এটি অবশ্যই [-৯০.০, +৯০.০] রেঞ্জের মধ্যে হতে হবে।
longitude

number

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

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

SearchText-এর জন্য উত্তর মেসেজ।

SearchTextResponse

JSON উপস্থাপনা 
{
  "places": [
    {
      object (PlaceView)
    }
  ],
  "summary": string,
  "contentToken": string
}
ফিল্ড
places[]

object (PlaceView)

শুধু আউটপুট। সারসংক্ষেপে উল্লেখ করা জায়গার তালিকা।
summary

string

শুধু আউটপুট। সার্চ ফলাফলের ন্যাচারাল ল্যাঙ্গুয়েজ সারসংক্ষেপ। সারসংক্ষেপে "[0]", "[1]", "[2]" ইত্যাদির মতো জিরো-বেসড সাইটেশন থাকতে পারে। এই সাইটেশনগুলি places ফিল্ডের সংশ্লিষ্ট জায়গার সাথে ম্যাপ করা থাকে।
contentToken

string

শুধু আউটপুট। একটি এনক্রিপ্ট করা টোকেন যা সার্চের প্রসঙ্গকে এনক্যাপসুলেট করে এবং Google Maps ভিজ্যুয়াল রেন্ডারিং পরিষেবা, SDK বা Maps Agentic UI Toolkit (A2UI)-এ পাস করা যেতে পারে যাতে সার্চ ফলাফলের জন্য ইন্টার‍্যাক্টিভ UI কম্পোনেন্ট দেখানো যায়।

PlaceView

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)

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

object (Attribution)

জায়গার সাথে দেখানোর জন্য প্রয়োজনীয় অ্যাট্রিবিউশন।

_location ফিল্ড একত্রিত করুন।

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

object (LatLng)

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

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

Google Maps-এ এই জায়গার জন্য রিভিউ লেখার লিঙ্ক।
reviewsUrl

string

Google Maps-এ এই জায়গার রিভিউ দেখানোর লিঙ্ক।
photosUrl

string

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

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

JSON উপস্থাপনা 
{
  "title": string,
  "url": string
}
ফিল্ড
title

string

অ্যাট্রিবিউশনের জন্য দেখানোর শীর্ষক।
url

string

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

টুল অ্যানোটেশন

প্রদত্ত টুলের প্রাথমিক ঝুঁকি বর্ণনা করার জন্য MCP ক্লায়েন্টদের টুল অ্যানোটেশন পাঠানো হয়। বেশিরভাগ ক্লায়েন্ট এইসব ইঙ্গিতকে বিশ্বাসযোগ্য বলে মনে করে না, তবে ব্যবহারকারীকে কখন কনফার্মেশন প্রম্পট পাঠানো হবে তা নির্ধারণ করতে এগুলি ব্যবহার করা যেতে পারে।

টাইটেল স্ট্রিংয়ের সাথে, নিম্নলিখিত বুলিয়ান হিন্ট এইভাবে সংজ্ঞায়িত করা হয়:

  • readOnlyHint: সত্য হলে, টুলটি তার পরিবেশ পরিবর্তন করে না। ডিফল্ট: false.
  • destructiveHint: সত্য হলে, টুলটি ধ্বংসাত্মক অ্যাকশন করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র যোগ করার অ্যাকশন করতে পারে। ডিফল্ট: true.
  • idempotentHint: সত্য হলে, একই আর্গুমেন্ট সহ টুলটিকে বারবার কল করলে এর এনভায়রনমেন্টে কোনও অতিরিক্ত প্রভাব পড়বে না। ডিফল্ট: false.
  • openWorldHint: সত্য হলে, টুলটি এক্সটার্নাল এন্টিটির 'মুক্ত পৃথিবী'-র সাথে ইন্টার‍্যাক্ট করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র অভ্যন্তরীণ এন্টিটির সাথে ইন্টার‍্যাক্ট করতে পারে। যেমন, ওয়েব সার্চ টুল ওপেন ওয়ার্ল্ড হলেও মেমরি টুল ওপেন ওয়ার্ল্ড নয়।

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌