MCP Tools Reference: mapstools.googleapis.com

MCP টুলস রেফারেন্স:

এই ডকুমেন্টটি Google রিমোট মডেল কনটেক্সট প্রোটোকল (MCP) টুল ব্যবহার করার জন্য ব্যবহৃত এক্সটার্নাল-ফেসিং REST API এন্ডপয়েন্টগুলি বর্ণনা করে। এই API একটি এক্সটার্নাল HTTP ক্লায়েন্ট (যেমন কার্ল বা একটি ওয়েব পরিষেবা) এবং অভ্যন্তরীণ MCP সার্ভারের মধ্যে একটি সুরক্ষিত প্রক্সি হিসেবে কাজ করে।

MCP টুলের স্পেসিফিকেশন পান

একটি MCP সার্ভারের সকল টুলের জন্য MCP টুলের স্পেসিফিকেশন পেতে, `tools/list` পদ্ধতিটি ব্যবহার করুন। নিম্নলিখিত উদাহরণটি দেখায় যে MCP সার্ভারের মধ্যে বর্তমানে উপলব্ধ সমস্ত টুল এবং তাদের স্পেসিফিকেশন তালিকাভুক্ত করার জন্য curl কীভাবে ব্যবহার করতে হয়।

কার্ল অনুরোধ 
curl --location 'https://mapstools.googleapis.com/mcp'
--header 'content-type: application/json'
--header 'accept: application/json, text/event-stream'
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'

টুল: 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: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

টুল: লুকআপ_ওয়েদার

যেকোনো স্থানের বর্তমান পরিস্থিতি, ঘণ্টায় এবং দৈনিক পূর্বাভাস প্রদান করে। আবহাওয়া সম্পর্কিত সমস্ত অনুসন্ধানের জন্য এই টুলটি ব্যবহার করুন।

নির্দিষ্ট তথ্য উপলব্ধ: তাপমাত্রা (বর্তমান, অনুভূতি, সর্বোচ্চ/ন্যূনতম, তাপ সূচক), বাতাস (গতি, দমকা হাওয়া, দিক), মহাজাগতিক ঘটনা (সূর্যোদয়/সূর্যাস্ত, চন্দ্র পর্যায়), বৃষ্টিপাত (প্রকার, সম্ভাবনা, পরিমাণ/QPF), বায়ুমণ্ডলীয় অবস্থা (UV সূচক, আর্দ্রতা, মেঘের আচ্ছাদন, বজ্রপাতের সম্ভাবনা), এবং জিওকোডেড অবস্থান ঠিকানা।

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

  • বর্তমান অবস্থা: শুধুমাত্র একটি অবস্থান প্রয়োজন (যেমন, শহর বা ঠিকানা)। তারিখ বা সময় নির্দিষ্ট করবেন না।

  • প্রতি ঘণ্টার পূর্বাভাস: একটি অবস্থান এবং এক ঘন্টা (০-২৩) প্রয়োজন। ব্যবহারকারী যদি নির্দিষ্ট সময়ে আবহাওয়া সম্পর্কে জিজ্ঞাসা করেন অথবা 'পরবর্তী কয়েক ঘন্টা' বা 'আজ পরে' এর মতো শব্দ ব্যবহার করেন তবে এটি ব্যবহার করুন।

  • দৈনিক পূর্বাভাস: একটি অবস্থান এবং একটি পূর্ণ তারিখ প্রয়োজন।

তারিখ পরিচালনা (গুরুত্বপূর্ণ): ব্যবহারকারীর দ্বারা প্রদত্ত তারিখ এবং ঘন্টা অনুরোধকৃত অবস্থানের স্থানীয় সময় অঞ্চলে প্রদান করা আবশ্যক। তারিখগুলিকে পৃথক পূর্ণসংখ্যার প্যারামিটারে বিভক্ত করতে হবে: বছর, মাস এবং দিন। এই প্যারামিটারগুলির জন্য প্রয়োজনীয় বিন্যাস হল: {"year": , "মাস": , "দিন": }

নিম্নলিখিত নমুনাগুলি lookup_weather 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": lookup_weather,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

টুল: compute_routes

একটি নির্দিষ্ট উৎপত্তিস্থল এবং গন্তব্যস্থলের মধ্যে একটি ভ্রমণ রুট গণনা করে। সমর্থিত ভ্রমণ মোড: ড্রাইভ (ডিফল্ট), হাঁটা।

ইনপুট প্রয়োজনীয়তা (ক্রিটিকাল): origin এবং destination উভয়ই প্রয়োজন। প্রতিটি নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করে প্রদান করা আবশ্যক, যা তার নিজ নিজ ক্ষেত্রের মধ্যে নেস্টেড:

  • ঠিকানা: (স্ট্রিং, যেমন, 'আইফেল টাওয়ার, প্যারিস')। দ্রষ্টব্য: ইনপুট ঠিকানা যত বেশি সূক্ষ্ম বা নির্দিষ্ট হবে, ফলাফল তত ভালো হবে।

  • lat_lng: (বস্তু, {"অক্ষাংশ": সংখ্যা, "দ্রাঘিমাংশ": সংখ্যা})

  • place_id: (স্ট্রিং, যেমন, 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') দ্রষ্টব্য: এই আইডিটি search_places টুল থেকে পাওয়া যেতে পারে। ইনপুট প্রকারের যেকোনো সমন্বয় অনুমোদিত (যেমন, ঠিকানা অনুসারে উৎপত্তি, lat_lng অনুসারে গন্তব্য)। যদি উৎপত্তি বা গন্তব্যের যেকোনো একটি অনুপস্থিত থাকে, তাহলে টুলটি কল করার চেষ্টা করার আগে আপনাকে ব্যবহারকারীর কাছ থেকে স্পষ্টীকরণের জন্য জিজ্ঞাসা করতে হবে ।

উদাহরণ টুল কল: {"origin":{"address":"Iffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

নিম্নলিখিত নমুনাগুলি দেখায় যে কীভাবে compute_routes 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": compute_routes,
    arguments: {
      // please fill these details according to tools MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'