MCP Reference: mapstools.googleapis.com

এটি Maps Experience Agent Tools-এর মাধ্যমে প্রদান করা একটি MCP সার্ভার। সার্ভারটি ডেভেলপারদের Google Maps Platform-এর উপরে LLM অ্যাপ্লিকেশন তৈরি করার জন্য টুল প্রদান করে।

মডেল কন্টেক্সট প্রোটোকল (MCP) সার্ভার একটি এক্সটার্নাল পরিষেবার প্রক্সি হিসেবে কাজ করে যা লার্জ ল্যাঙ্গুয়েজ মডেল (LLM) বা AI অ্যাপ্লিকেশনকে কন্টেক্সট, ডেটা বা ক্ষমতা প্রদান করে। MCP সার্ভার AI অ্যাপ্লিকেশনকে ডেটাবেস এবং ওয়েব পরিষেবার মতো এক্সটার্নাল সিস্টেমের সাথে কানেক্ট করে, তাদের উত্তর এমন একটি ফর্ম্যাটে অনুবাদ করে যা AI অ্যাপ্লিকেশন বুঝতে পারে।

সার্ভার সেটআপ

ব্যবহার করার আগে আপনাকে অবশ্যই MCP সার্ভার চালু করতে এবং যাচাইকরণ সেট-আপ করতে হবে। Google এবং Google Cloud রিমোট MCP সার্ভার ব্যবহার করার ব্যাপারে আরও তথ্য পেতে, Google Cloud MCP সার্ভার এক নজরে দেখুন।

সার্ভার এন্ডপয়েন্ট

MCP সার্ভিস এন্ডপয়েন্ট হল MCP সার্ভারের নেটওয়ার্ক অ্যাড্রেস ও কমিউনিকেশন ইন্টারফেস (সাধারণত একটি URL) যা কোনও AI অ্যাপ্লিকেশন (MCP ক্লায়েন্টের জন্য হোস্ট) একটি সুরক্ষিত, স্ট্যান্ডার্ডাইজড কানেকশন তৈরি করতে ব্যবহার করে। এটি হল LLM-এর জন্য প্রসঙ্গ অনুরোধ করা, কোনও টুল কল করা বা কোনও রিসোর্স অ্যাক্সেস করার জন্য যোগাযোগের পয়েন্ট। Google MCP এন্ডপয়েন্ট গ্লোবাল বা আঞ্চলিক হতে পারে।

Maps Experience Agent Tools MCP সার্ভারে নিম্নলিখিত গ্লোবাল MCP এন্ডপয়েন্ট আছে:

  • https://mapstools.googleapis.com/mcp

MCP টুল

MCP টুল হল একটি ফাংশন বা এক্সিকিউটেবল ক্ষমতা যা একটি MCP সার্ভার বাস্তব জগতে কোনও অ্যাকশন পারফর্ম করার জন্য LLM বা AI অ্যাপ্লিকেশনের কাছে প্রকাশ করে।

টুল

mapstools.googleapis.com MCP সার্ভারে নিম্নলিখিত টুল আছে:

MCP টুল
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 ফিল্ড থেকে তথ্য ব্যবহার করতে হবে, যদি তা উপলভ্য থাকে।
lookup_weather

বর্তমান পরিস্থিতি, প্রতি ঘণ্টা ও দৈনিক পূর্বাভাস সহ আবহাওয়ার বিস্তারিত ডেটা খুঁজে বের করে।

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

লোকেশন ও লোকেশন সংক্রান্ত নিয়ম (গুরুত্বপূর্ণ):

location ফিল্ড ব্যবহার করে সেই লোকেশন নির্দিষ্ট করা হয় যার জন্য আবহাওয়ার ডেটা চাওয়া হয়েছে। এই ফিল্ডটি 'oneof' স্ট্রাকচার, যার অর্থ হল আবহাওয়ার সঠিক ডেটা লুকআপ নিশ্চিত করতে, আপনাকে নিচে উল্লেখ করা তিনটি লোকেশন সাব-ফিল্ডের মধ্যে শুধুমাত্র একটির জন্য ভ্যালু প্রদান করতে হবে।

  1. ভৌগোলিক স্থানাঙ্ক (lat_lng)

    • আপনাকে সঠিক অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট প্রদান করা হলে এটি ব্যবহার করুন।
    • উদাহরণ: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // লস অ্যাঞ্জেলেস

  2. প্লেস আইডি (place_id)

    • একটি দ্ব্যর্থহীন স্ট্রিং শনাক্তকারী (Google Maps Place ID)।
    • place_id, search_places টুল থেকে ফেচ করা যেতে পারে।
    • উদাহরণ: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // আইফেল টাওয়ার

  3. ঠিকানা স্ট্রিং (ঠিকানা)

    • একটি ফ্রি-ফর্ম স্ট্রিং যার জন্য জিওকোডিংয়ের নির্দিষ্টতা প্রয়োজন।
    • শহর ও অঞ্চল: সবসময় অঞ্চল/দেশ অন্তর্ভুক্ত করুন (যেমন, "লন্ডন, যুক্তরাজ্য", "লন্ডন" নয়)।
    • রাস্তার ঠিকানা: সম্পূর্ণ ঠিকানা লিখুন (যেমন, "১৬০০ পেনসিলভেনিয়া অ্যাভিনিউ এনডব্লিউ, ওয়াশিংটন, ডিসি")।
    • পোস্টাল/পিন কোড: অবশ্যই দেশের নাম উল্লেখ করতে হবে (যেমন, "90210, USA", "90210" নয়)।
    • উদাহরণ: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

ব্যবহারের মোড:

  • বর্তমান আবহাওয়া: শুধু location প্রদান করুন। date এবং hour উল্লেখ করবেন না।

  • প্রতি ঘণ্টার পূর্বাভাস: location, date এবং hour (0-23) প্রদান করুন। নির্দিষ্ট সময়ের জন্য (যেমন, "বিকেল ৫টায়") অথবা "পরের কয়েক ঘণ্টা" বা "আজকে পরে" এই ধরনের শব্দ ব্যবহার করুন। ব্যবহারকারী মিনিট উল্লেখ করলে, নিকটতম ঘণ্টায় রাউন্ড ডাউন করুন। এখন থেকে ১২০ ঘণ্টার বেশি সময়ের জন্য প্রতি ঘণ্টার পূর্বাভাস দেখানো হয় না। ঘণ্টাভিত্তিক আবহাওয়ার ইতিহাস ২৪ ঘণ্টা পর্যন্ত দেখা যায়।

  • দৈনিক পূর্বাভাস: location এবং date প্রদান করুন। hour উল্লেখ করবেন না। সাধারণ দিনের অনুরোধের জন্য ব্যবহার করুন (যেমন, "আগামীকালের আবহাওয়া", "শুক্রবার আবহাওয়া", "১২/২৫ তারিখে আবহাওয়া")। আজকের তারিখ যদি প্রসঙ্গে না থাকে, তাহলে আপনাকে ব্যবহারকারীর সাথে এটি স্পষ্ট করতে হবে। আজ থেকে শুরু করে ১০ দিনের বেশি দৈনিক পূর্বাভাস দেখানো হয় না। আগেকার আবহাওয়ার তথ্য কাজ করে না।

প্যারামিটার সংক্রান্ত সীমাবদ্ধতা:

  • টাইমজোন: সব date এবং hour ইনপুট অবশ্যই লোকেশন অনুযায়ী স্থানীয় টাইমজোন অনুযায়ী হতে হবে, ব্যবহারকারীর টাইমজোন অনুযায়ী নয়।
  • তারিখের ফর্ম্যাট: ইনপুট অবশ্যই {year, month, day}টি পূর্ণসংখ্যায় আলাদা করতে হবে।
  • ইউনিট: ডিফল্ট হিসেবে METRIC সেট করা থাকে। ব্যবহারকারী মার্কিন যুক্তরাষ্ট্রের স্ট্যান্ডার্ড অনুযায়ী বা স্পষ্টভাবে অনুরোধ করলে, ফারেনহাইট/মাইলের জন্য units_system-কে IMPERIAL-এ সেট করুন।

  • গ্রাউন্ডেড আউটপুট অবশ্যই সোর্সের সাথে অ্যাট্রিবিউট করতে হবে, এর জন্য attribution ফিল্ড থেকে তথ্য ব্যবহার করতে হবে, যদি তা উপলভ্য থাকে।
compute_routes

যাত্রা শুরুর স্থান ও গন্তব্যের মধ্যে ভ্রমণের রুট গণনা করে, ঐচ্ছিকভাবে মধ্যবর্তী স্টপের মাধ্যমে। প্রতিটি রুটের দূরত্ব ও সময়কাল দেখায়।

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

  1. origin এবং destination (অবজেক্ট - বাধ্যতামূলক): প্রতিটি অবশ্যই নিম্নলিখিতগুলির মধ্যে ঠিক একটি ব্যবহার করে প্রদান করতে হবে:

    • address (স্ট্রিং, যেমন, 'Eiffel Tower, Paris')। নামযুক্ত জায়গা, ল্যান্ডমার্ক ও ব্যবসা সরাসরি সমাধান করা হয়, তাই কোনও ওয়েপয়েন্ট জিওকোড করার জন্য প্রথমে search_places কল করবেন না। ব্যবহারকারীর উল্লেখ করা যেকোনও শহর, অঞ্চল বা দেশ অন্তর্ভুক্ত করুন।
    • lat_lng (অবজেক্ট, {"latitude": number, "longitude": number})।
    • place_id (স্ট্রিং, যেমন, 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), উদাহরণস্বরূপ search_places থেকে।

  2. intermediate_waypoints (অবজেক্টের অ্যারে - ঐচ্ছিক): যাত্রা শুরুর স্থান ও গন্তব্যের মধ্যে, ক্রমানুসারে, সর্বাধিক ১০টি স্টপ। origin-এর মতো একই ফর্ম্যাট। TRANSIT-এর সাথে কাজ করে না। ব্যবহারকারী যেসব স্টপের জন্য অনুরোধ করেছেন শুধুমাত্র সেগুলিই অন্তর্ভুক্ত করুন।

  3. travel_mode (enum - ঐচ্ছিক): DRIVE (ডিফল্ট), WALK, BICYCLE অথবা TRANSIT।

  4. সময় (ঐচ্ছিক - সর্বাধিক একটি সেট করুন): UTC অফসেট সহ RFC 3339 টাইমস্ট্যাম্প, যেমন, '2026-09-19T08:00:00-07:00'। ডিফল্ট হিসেবে এখন ছাড়ার সময় সেট করা থাকে। TRANSIT-এর জন্য, সময়টি অতীতে সর্বাধিক ৭ দিন বা ভবিষ্যতে সর্বাধিক ১০০ দিন হতে পারে। অন্যান্য মোডের ক্ষেত্রে, সময় ভবিষ্যতের ৩৬৫ দিন পর্যন্ত হতে পারে এবং অতীতের হলে চলবে না।

    • departure_time: ব্যবহারকারী কখন রওনা দেবেন তা উল্লেখ করলে এটি ব্যবহার করুন (যেমন, "আগামীকাল সকাল ৮টায়")।
    • arrival_time: ব্যবহারকারী কখন পৌঁছাবেন তা উল্লেখ করলে এটি ব্যবহার করুন (যেমন, "সকাল ৯টার মধ্যে পৌঁছাতে হবে")।

  5. routing_preference (enum - ঐচ্ছিক):

    • ROUTING_PREFERENCE_TRAFFIC_UNAWARE (ডিফল্ট): লাইভ ট্রাফিক, ঘটনা এবং রাস্তা বন্ধের তথ্য উপেক্ষা করে। সবচেয়ে কম লেটেন্সি।
    • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: উপলভ্য থাকলে লাইভ ট্রাফিক পরিস্থিতি ব্যবহার করে। WALK বা BICYCLE-এর জন্য কাজ করে না। ব্যবহারকারী ট্রাফিক, যানজট বা ট্রাফিক-অ্যাডজাস্ট করা ETA সম্পর্কে জিজ্ঞাসা করলে তবেই এটি সেট করুন। এতে বেশি খরচ ও লেটেন্সি হয়।

  6. location_bias (অবজেক্ট - ঐচ্ছিক): {"latitude": number, "longitude": number} ওয়েপয়েন্ট অ্যাড্রেসে জায়গার নাম দ্ব্যর্থহীন করতে ব্যবহার করা হয়। কোনও নাম অস্পষ্ট হলে (যেমন, "Springfield") এবং ব্যবহারকারী কোনও অঞ্চল উল্লেখ না করলে, address-এ যেমন নাম দেওয়া আছে তেমনই রাখুন এবং কোনও অঞ্চল অনুমান করার পরিবর্তে location_bias-কে অভিপ্রেত এলাকার দিকে সেট করুন।

  7. compute_alternative_routes (বুলিয়ান - ঐচ্ছিক): ব্যবহারকারী রুটের বিকল্প বা অল্টারনেটিভ চাইলে তবেই true-এ সেট করুন। ডিফল্ট হিসেবে false সেট করা থাকে, যা শুধু সাজেস্ট করা রুট দেখায়।

  8. include_polyline (বুলিয়ান - ঐচ্ছিক): শুধুমাত্র রুট জিওমেট্রি (encoded_polyline) প্রয়োজন হলে true-এ সেট করুন। ডিফল্ট হিসেবে false সেট করা থাকে।

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

  • শুরু বা গন্তব্যের জায়গা উল্লেখ করা না থাকলে, টুল কল করার আগে আপনাকে অবশ্যই ব্যবহারকারীকে স্পষ্ট করে বলতে হবে।
  • "B থেকে A কত দূরে?" প্রশ্নের জন্য, B-কে origin এবং A-কে destination হিসেবে ব্যবহার করুন।

টুল কলের উদাহরণ: {"origin":{"address":"আইফেল টাওয়ার"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"লুভর মিউজিয়াম"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"}

উত্তরের জন্য নির্দেশাবলী:

  • বিকল্প রুটের অনুরোধ করা হলে, সবচেয়ে বেশি থেকে সবচেয়ে কম সাজেস্ট করা রুট হিসেবে সেগুলি সাজানো হয়।
  • routes খালি থাকলে, ব্যবহারকারীকে বলো যে কোনও রুট খুঁজে পাওয়া যায়নি। কোনও রুট অনুমান করবেন না।
  • টুল থেকে পাওয়া ফ্যাক্টগুলিই শুধু উল্লেখ করো। এক এক করে দিকনির্দেশ, ট্রানজিট লাইন, স্টেশন, প্ল্যাটফর্ম বা ট্রান্সফার সংক্রান্ত তথ্য নিজে থেকে তৈরি করবেন না।
  • গ্রাউন্ডেড আউটপুট অবশ্যই প্রতিটি রুটের attribution ফিল্ড ব্যবহার করে সোর্সের সাথে অ্যাট্রিবিউট করতে হবে, যখন উপলভ্য থাকে।
resolve_names

নির্দিষ্ট লোকেশন কোয়েরির (ল্যান্ডমার্কের নাম বা সঠিক ঠিকানা) ব্যাচ লিস্টকে ক্যানোনিকাল Google Maps Place ID-তে সমাধান করে।

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

  1. queries (অবজেক্টের অ্যারে - বাধ্যতামূলক): সমাধান করার জন্য লোকেশন কোয়েরির তালিকা। আপনি সর্বাধিক ২০টি কোয়েরি উল্লেখ করতে পারবেন।

    • প্রতিটি কোয়েরি অবজেক্টে এগুলি থাকতে হবে:
      • text (স্ট্রিং - বাধ্যতামূলক): টেক্সট কোয়েরি যা কোনও নির্দিষ্ট জায়গার নাম বা ঠিকানা দেখায়।
        • উদাহরণ: 'Googleplex, Mountain View, CA', '1600 Amphitheatre Pkwy, Mountain View, CA', 'Eiffel Tower, Paris'।

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

    • ফর্ম্যাট: {"viewport": {"low": {"latitude": [value], "longitude": [value]}, "high": {"latitude": [value], "longitude": [value]}}}

  3. region_code (স্ট্রিং - ঐচ্ছিক): ফলাফল পক্ষপাতদুষ্ট করার জন্য ব্যবহারকারীর ইউনিকোড CLDR অঞ্চল কোড (দুটি অক্ষরের দেশের কোড, যেমন, US, CA)।

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

  • নির্দিষ্টতা (গুরুত্বপূর্ণ): কোয়েরিতে অবশ্যই কোনও নির্দিষ্ট জায়গার নাম বা ঠিকানা থাকতে হবে। 'restaurants'-এর মতো সাধারণ সার্চ বা 'Starbucks'-এর মতো চেনের নাম কাজ করে না।
  • আপনি যে ডাউনস্ট্রিম টুল ব্যবহার করার পরিকল্পনা করছেন সেটি যদি আগে থেকেই সরাসরি কাঁচা ঠিকানা বা জায়গার নামের স্ট্রিং গ্রহণ করে, তাহলে এই টুল কল করবেন না।

Google Maps-এ সেভ করুন:

  • উত্তরে একটি save_to_maps_url ফিল্ড অন্তর্ভুক্ত থাকে: একটি Google Maps লিঙ্ক যাতে সফলভাবে সমাধান করা সব জায়গা থাকে।
  • ব্যবহারকারী যখন Google Maps-এ সমাধান করা জায়গাগুলি তালিকা হিসেবে সেভ, শেয়ার বা খুলতে চান, তখন ব্যবহারকারীকে এই লিঙ্কটি দেখান। এই লিঙ্কটি নিজে তৈরি করবেন না।

সমস্যা ম্যানেজ করা (গুরুত্বপূর্ণ):

  • এটি একটি ব্যাচ প্রসেসিং টুল। কোনও অনুরোধের ফলে "মিশ্র ফলাফল" পাওয়া যেতে পারে (যেমন, কিছু কোয়েরি সফলভাবে সমাধান করা গেলেও অন্যগুলি ব্যর্থ হয়)।
  • results-এর আউটপুট তালিকা ইনপুট queries ইন্ডেক্সের সাথে ১:১ ম্যাপ করবেই। কোয়েরি ব্যর্থ হলে, results তালিকার সংশ্লিষ্ট ইন্ডেক্সে একটি খালি Result মেসেজ (কোনও entity সেট করা নেই) দেখানো হবে।
  • কোন নির্দিষ্ট কোয়েরি ইনডেক্স ব্যর্থ হয়েছে তা শনাক্ত করতে আপনাকে অবশ্যই রেসপন্সে failed_requests ম্যাপ ফিল্ড চেক করতে হবে। failed_requests-এর 'কী' অনুরোধে ব্যর্থ কোয়েরির ০-ভিত্তিক ইন্ডেক্সকে দেখায়। আংশিক ব্যর্থতার কারণে পুরো ব্যাচ কল ব্যর্থ হয়েছে বলে ধরে নেবেন না।
resolve_maps_urls

Google Maps URL-এর একটি তালিকা ক্যানোনিকাল Google Maps Place ID-তে সমাধান করে।

এই টুল কখন কল করতে হবে (গুরুত্বপূর্ণ):

  • ব্যবহারকারী এক বা একাধিক Google Maps শেয়ারিং লিঙ্ক বা URL (যেমন, 'https://maps.app.goo.gl/...') প্রদান করলে এই টুল ব্যবহার করুন, 'https://www.google.com/maps/place/...' অথবা 'https://maps.google.com/...') এবং আপনাকে অন্তর্নিহিত ক্যানোনিকাল স্থান আইডি এক্সট্র্যাক্ট করতে হবে।
  • একটি ব্যাচ অনুরোধে সমাধান করার জন্য আপনি সর্বাধিক ২০টি URL উল্লেখ করতে পারবেন।

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

  • urls (স্ট্রিংয়ের অ্যারে - বাধ্যতামূলক): সমাধান করার জন্য Google Maps URL-এর তালিকা। প্রতিটি URL অবশ্যই একটি সঠিক, একক-স্থানের Google Maps URL হতে হবে।

Google Maps-এ সেভ করুন:

  • উত্তরে একটি save_to_maps_url ফিল্ড অন্তর্ভুক্ত থাকে: একটি Google Maps লিঙ্ক যাতে সফলভাবে সমাধান করা সব জায়গা থাকে।
  • ব্যবহারকারী যখন Google Maps-এ তালিকা হিসেবে সমাধান করা জায়গাগুলি সেভ, শেয়ার বা খুলতে চান (যেমন, কথোপকথনে শেয়ার করা জায়গাগুলি সংগ্রহ করা), তখন ব্যবহারকারীকে এই লিঙ্কটি দেখান। এই লিঙ্কটি নিজে তৈরি করবেন না।

সমস্যা ম্যানেজ করা (গুরুত্বপূর্ণ):

  • এটি একটি ব্যাচ প্রসেসিং টুল। কোনও অনুরোধের ক্ষেত্রে "মিশ্র ফলাফল" (যেমন, কিছু URL-এর ক্ষেত্রে সমস্যার সমাধান হলেও, অন্যগুলির ক্ষেত্রে হয়নি) পাওয়া যেতে পারে।
  • entities-এর আউটপুট তালিকা ইনপুট urls ইন্ডেক্সের সাথে ১:১ ম্যাপ করবেই। URL রেজোলিউশন ব্যর্থ হলে, entities তালিকার সংশ্লিষ্ট ইন্ডেক্সে একটি খালি Entity মেসেজ (কোনও ফিল্ড সেট করা নেই) দেখা যাবে।
  • কোন নির্দিষ্ট URL ইন্ডেক্স করা যায়নি তা শনাক্ত করতে আপনাকে অবশ্যই উত্তরে failed_requests ম্যাপ ফিল্ড চেক করতে হবে। failed_requests-এর কী, অনুরোধে ব্যর্থ URL-এর 0-ভিত্তিক ইন্ডেক্সকে দেখায়। আংশিক ব্যর্থতার কারণে পুরো ব্যাচ কল ব্যর্থ হয়েছে বলে ধরে নেবেন না।

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

কোনও MCP সার্ভারের সব টুলের জন্য MCP টুল স্পেসিফিকেশন পেতে, tools/list পদ্ধতি ব্যবহার করুন। 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/list",
    "jsonrpc": "2.0",
    "id": 1
}'