Maps Grounding Lite

Google Maps Platform Grounding Lite হল Model Context Protocol (MCP) সহায়তা সহ একটি পরিষেবা যা Google Maps থেকে পাওয়া বিশ্বস্ত জিওস্পেশিয়াল ডেটা ব্যবহার করে আপনার AI অ্যাপ্লিকেশনকে গ্রাউন্ড করা সহজ করে তোলে। MCP সার্ভার এমন টুল প্রদান করে যা LLM-কে জায়গা, আবহাওয়া ও রুটের ক্ষমতা অ্যাক্সেস করতে এবং লোকেশন নাম ও Google Maps URL-কে প্লেস আইডিতে সমাধান করতে দেয়। যেসব টুলে MCP সার্ভার কাজ করে সেগুলিতে Maps Grounding Lite চালু করে আপনি এটি ব্যবহার করে দেখতে পারেন।

টুল

Maps Grounding Lite এমন টুল প্রদান করে যা LLM-কে নিম্নলিখিত Google Maps সংক্রান্ত সুবিধা অ্যাক্সেস করতে দেয়:

• জায়গা সার্চ করো: জায়গা সম্পর্কে তথ্য চেয়ে AI-জেনারেটেড জায়গার ডেটা সারাংশ, সেইসাথে সারাংশে অন্তর্ভুক্ত প্রতিটি জায়গার জন্য প্লেস আইডি, অক্ষাংশ ও দ্রাঘিমাংশ কোঅর্ডিনেট এবং Google Maps লিঙ্ক পান। ম্যাপে জায়গা দেখাতে, আপনি রিটার্ন করা প্লেস আইডি এবং অক্ষাংশ ও দ্রাঘিমাংশের কোঅর্ডিনেট অন্যান্য Google Maps Platform API-এর সাথে ব্যবহার করতে পারবেন।
• আবহাওয়া সংক্রান্ত তথ্য খোঁজো: আবহাওয়া সংক্রান্ত তথ্য চেয়ে বর্তমান পরিস্থিতি, প্রতি ঘণ্টার পূর্বাভাস ও দৈনিক পূর্বাভাস দেখাও।

• রুট গণনা করা: দুটি লোকেশনের মধ্যে ড্রাইভিং বা হাঁটার রুট সম্পর্কে তথ্য চেয়ে রুট দূরত্ব ও সময়সীমা সংক্রান্ত তথ্য ফেরত দেয়।

  মনে রাখবেন: Maps Grounding Lite ধাপে ধাপে রাউটিং, দিকনির্দেশ, রিয়েল-টাইম ট্রাফিক বা নেভিগেশন সংক্রান্ত তথ্য প্রদান করে না।

• নাম সমাধান করুন এবং Maps URL সমাধান করুন: প্লেস আইডিতে লোকেশনের নাম, ঠিকানা ও Google Maps URL সমাধান করুন। আরও তথ্যের জন্য, রেজোলিউশন API দেখুন।

Maps Grounding Lite MCP সার্ভার চালু করলে, LLM, সার্ভারের মাধ্যমে প্রকাশ করা নতুন টুলকে কল করতে পারে এবং উপরে তালিকাভুক্ত ডেটার ধরনের জন্য অতিরিক্ত গ্রাউন্ডিং তথ্য রিটার্ন করতে পারে। LLM এই অতিরিক্ত তথ্য প্রসঙ্গের জন্য ব্যবহার করতে পারলেও, LLM-এর তৈরি করা চূড়ান্ত উত্তরে MCP সার্ভারের মাধ্যমে রিটার্ন করা সঠিক তথ্য নাও থাকতে পারে। জেনারেট করা উত্তরের যথার্থতা আপনাকে যাচাই করতে হবে।

Resolution API

Maps Grounding Lite-এ রেজোলিউশন API থাকে, যা আপনাকে ফ্রি-ফর্ম লোকেশন টেক্সট ও URL-কে স্ট্রাকচার্ড Google Maps প্লেস আইডেন্টিফায়ারে রেজলভ করতে দেয়। Maps Grounding Lite MCP সার্ভারে রেজোলিউশন API, REST পদ্ধতি ও টুল হিসেবে উপলভ্য:

• নাম সমাধান করা (REST, MCP): Google Maps-এ নির্দিষ্ট স্থান এন্টিটির জন্য লোকেশনের নাম বা ঠিকানার ব্যাচ সমাধান করুন। এটি স্থিতিশীল প্লেস আইডিতে আনস্ট্রাকচার্ড ব্যবহারকারীর কোয়েরি গ্রাউন্ড করার জন্য উপযোগী।
• Maps URL সংক্রান্ত সমস্যার সমাধান করা (REST, MCP): নির্দিষ্ট জায়গা এন্টিটির জন্য Google Maps URL-এর ব্যাচ সংক্রান্ত সমস্যার সমাধান করুন। সাপোর্ট করা ফর্ম্যাটের মধ্যে স্ট্যান্ডার্ড প্লেস URL ও ছোট URL অন্তর্ভুক্ত।

আপনি অন্যান্য Google Maps Platform API-এর সাথে ফেরত পাওয়া প্লেস আইডি ব্যবহার করতে পারবেন। এছাড়াও, প্রতিটি উত্তরে একটি লিঙ্ক থাকে যা সমাধান করা জায়গাগুলিকে Google Maps-এ একটি তালিকা হিসেবে সেভ করে।

আরও তথ্যের জন্য, Maps Tools Resolution API দেখুন।

Maps Grounding Lite স্যাম্পেল অ্যাপ ব্যবহার করে দেখুন (নতুন ট্যাবে খুলুন)

বিলিং ও কোটা

আপনাকে কীভাবে বিল করা হয়

Google Maps Platform-এর পে-অ্যাজ-ইউ-গো প্রাইসিং মডেলে, প্রতিটি অনুরোধের জন্য Maps Grounding Lite-এর ব্যবহার গণনা করা হয়, যেখানে প্রতিটি অনুরোধ একটি বিলিং ইভেন্টকে বোঝায়। প্রতিটি প্রোডাক্ট SKU-এর ব্যবহার ট্র্যাক করা হয়। আপনার বিলে মোট চার্জের সাথে প্রতিটি SKU-র জন্য একটি লাইন আইটেম দেখানো হয়। আরও জানতে অভিযোগ জানানো সংক্রান্ত ওভারভিউ দেখুন।

মূল্যের বিবরণ জানতে মূল মূল্য তালিকা ও ভারতের মূল্য তালিকা দেখুন।

Resolution API-তে (ResolveNames এবং ResolveMapsUrls) করা অনুরোধের জন্য Places API টেক্সট সার্চ এসেনশিয়াল (শুধুমাত্র ID) SKU-এর আওতায় কোনও চার্জ লাগে না।

এছাড়াও, Essentials ও Pro প্যাকেজের মাধ্যমে Maps Grounding Lite অফার করা হয় সেভ করতে সাবস্ক্রাইব করুন ।

কোটা

Maps Grounding Lite-এর প্রদান করা টুল ও API-এর ক্ষেত্রে নিম্নলিখিত কোটা প্রযোজ্য:

• জায়গা সার্চ করা: প্রতি প্রোজেক্টে প্রতি মিনিটে ৩০০টি কোয়েরি।
• আবহাওয়া সংক্রান্ত তথ্য দেখা: প্রতি প্রজেক্টে প্রতি মিনিটে ৩০০টি কোয়েরি।
• রুট কম্পিউট করা: প্রতি প্রোজেক্টে প্রতি মিনিটে ৩০০টি কোয়েরি।
• নাম সমাধান করা: প্রতি প্রোজেক্টে প্রতি মিনিটে ৬০০ কোয়েরি।
• Maps URL সংক্রান্ত সমস্যার সমাধান করুন: প্রতি প্রোজেক্টে প্রতি মিনিটে ৬০০টি কোয়েরি।

প্রতিটি Resolution API অনুরোধকে একটি কোয়েরি হিসেবে গণ্য করা হয়, এতে যতগুলি আইটেমই থাকুক না কেন।

নীতি ও পরিষেবার শর্তাবলী

Maps Grounding Lite Google Maps Platform পরিষেবার শর্তাবলী মেনে চলে, যার মধ্যে এই পরিষেবার জন্য পরিষেবা-নির্দিষ্ট শর্তাবলী অন্তর্ভুক্ত। এই বিভাগে Maps Grounding Lite-এর জন্য অতিরিক্ত পরিষেবা ব্যবহারের প্রয়োজনীয়তা বর্ণনা করা হয়েছে, এর মধ্যে রয়েছে উপযুক্ত LLM এবং সোর্স অ্যাট্রিবিউশন সংক্রান্ত প্রয়োজনীয়তা।

মানানসই LLM-এর জন্য প্রয়োজনীয়তা

আপনি শুধু এমন LLM-এর সাথে Maps Grounding Lite ব্যবহার করতে পারেন যা Google Maps Platform পরিষেবার শর্তাবলী মেনে চলে।

যেমন, আপনি যে LLM ব্যবহার করতে চান সেটি যেন Google Maps কন্টেন্ট ক্যাশে, স্টোর বা ব্যবহার করে উন্নত না হয় তা নিশ্চিত করার দায়িত্ব আপনার। Maps Grounding Lite ব্যবহার করার আগে, Maps Grounding Lite-এর সাথে আপনি যে মডেল ব্যবহার করতে চান সেটির পরিষেবার শর্তাবলী আপনাকে পর্যালোচনা করতে হবে। আপনি এমন কোনও মডেলের সাথে Maps Grounding Lite ব্যবহার করতে পারবেন না যা কোনও মডেল ট্রেনিং বা উন্নতির জন্য মডেলের ইনপুট করা ডেটা ব্যবহার করে। Google Maps Platform পরিষেবার শর্তাবলীতে Google Maps কন্টেন্টের উপর আরোপিত বিধিনিষেধ সহ পরিষেবা-নির্দিষ্ট শর্তাবলী আপনার মডেলের ব্যবহার সম্পূর্ণরূপে মেনে চলছে কিনা তা নিশ্চিত করার দায়িত্ব আপনার।

Google Maps সোর্সের জন্য অ্যাট্রিবিউশন সংক্রান্ত আবশ্যকতা

Maps Grounding Lite থেকে পাওয়া প্রতিটি টুল রেসপন্সে সোর্স অন্তর্ভুক্ত থাকে। Maps Grounding Lite-এর দেওয়া টুল ব্যবহার করে ফলাফল দেখানোর সময়, আপনাকে অবশ্যই সংযুক্ত Google Maps সোর্স এমনভাবে অন্তর্ভুক্ত করতে হবে যা নিম্নলিখিত প্রয়োজনীয়তা পূরণ করে:

• Google Maps সোর্সকে অবশ্যই জেনারেট করা কন্টেন্ট অনুসরণ করতে হবে যা সোর্স সমর্থন করে। এই জেনারেট করা কন্টেন্টকে গ্রাউন্ডেড আউটপুটও বলা হয়।
• Google Maps সোর্স অবশ্যই একটি ব্যবহারকারীর ইন্টার‍্যাকশনের মধ্যে দৃশ্যমান হতে হবে।

'জায়গা সার্চ করুন' টুলের সোর্স

search_places টুল places ফিল্ডে এমন সোর্স দেওয়া হয় যা summary-কে সমর্থন করে। places-এর জন্য, নিম্নলিখিত মেটাডেটা রিটার্ন করা হয়েছে:

• place (রিসোর্সের নাম)
• id
• location
• googleMapsLinks

প্রতিটি জায়গার জন্য, আপনাকে অবশ্যই এমন একটি লিঙ্ক প্রিভিউ তৈরি করতে হবে যা এইসব প্রয়োজনীয়তা পূরণ করে:

• Maps Grounding Lite টেক্সট অ্যাট্রিবিউশন নির্দেশিকা অনুসরণ করে প্রতিটি সোর্সকে Google Maps-এর সাথে অ্যাট্রিবিউট করুন।
• উত্তরে দেওয়া places.googleMapsLinks.placeUrl ব্যবহার করে সোর্সে লিঙ্ক করুন।

MCP সার্ভার ব্যবহার করার জন্য LLM কনফিগার করা

Maps Grounding Lite ব্যবহার করতে হলে, আপনাকে প্রথমে Maps Grounding Lite API পরিষেবা চালু করা একটি Google Cloud প্রোজেক্টের পাশাপাশি API কী অথবা OAuth ক্লায়েন্ট আইডির প্রয়োজন হবে। তারপরে, আপনি MCP সার্ভার অ্যাক্সেস করার জন্য LLM কনফিগার করতে পারবেন। Grounding Lite MCP সার্ভার, স্ট্রিম করা যায় এমন HTTP ট্রান্সপোর্ট ব্যবহার করে।

আপনার Google Cloud প্রোজেক্টে Maps Grounding Lite পরিষেবা চালু করুন

আপনার প্রোজেক্টে API চালু করতে:

1. Google Cloud Console-এ, Maps Grounding Lite-এর জন্য আপনি যে প্রোজেক্ট ব্যবহার করতে চান সেটি বেছে নিন।
2. Google Cloud Console-এ প্রোজেক্টের জন্য বিলিং চালু করুন।
3. Google Cloud Console API Library-তে Maps Grounding Lite চালু করুন।

API key ব্যবহার করে যাচাইকরণ করা

আপনি Maps Grounding Lite-এর সাথে আগে থেকে থাকা API কী ব্যবহার করতে পারেন অথবা নতুন কী তৈরি করতে পারেন, তবে আপনাকে Google Cloud প্রোজেক্ট ও কী, দু'টিতেই Maps Grounding Lite API পরিষেবা চালু করতে হবে।

মনে রাখবেন: এছাড়াও, পরীক্ষা ও প্রোটোটাইপিংয়ের জন্য, আপনি কোনও বিলিং অ্যাকাউন্ট সেট-আপ না করেই Maps ডেমো কী ব্যবহার করতে পারবেন।

API key ব্যবহার করে যাচাই করতে:

1. Google Maps Platform-এর সাথে শুরু করা লিঙ্কে দেওয়া ধাপগুলি অনুসরণ করে API কী তৈরি বা কনফিগার করুন।
2. X-Goog-Api-Key হেডার ব্যবহার করে MCP সার্ভারে কী পাস করুন। LLM-এর MCP টুল কনফিগারেশনে কাস্টম HTTP হেডার হিসেবে এটি উল্লেখ করতে হবে।

মনে রাখবেন: API কী তৈরি বা কনফিগার করার সময়, উপযুক্ত বিধিনিষেধ প্রয়োগ করে কী-এর ব্যবহার সীমিত করতে ভুলবেন না। আরও তথ্যের জন্য, আপনার API কী সীমাবদ্ধ করুন।

OAuth ব্যবহার করে যাচাইকরণ

আপনি OAuth ক্রেডেনশিয়াল তৈরি করে এবং সেগুলি MCP হোস্ট বা MCP সার্ভার অ্যাপ্লিকেশনে পাস করার মাধ্যমে OAuth ব্যবহার করে প্রমাণীকরণ করতে পারবেন।

OAuth ব্যবহার করে যাচাই করতে:

1. Google Cloud Console-এ, Maps Grounding Lite-এর জন্য আপনি যে প্রোজেক্ট ব্যবহার করতে চান সেটি বেছে নিন।
2. API ও পরিষেবা মেনুতে, ক্রেডেনশিয়াল বিকল্প বেছে নিন।
3. উপরের মেনু থেকে, ক্রেডেনশিয়াল তৈরি করুন > OAuth ক্লায়েন্ট আইডি বিকল্প বেছে নিন।
4. প্রোজেক্টে কনফিগার করা সম্মতি স্ক্রিন না থাকলে, সম্মতি স্ক্রিন কনফিগার করুন বিকল্পে ক্লিক করে অন-স্ক্রিন নির্দেশাবলী অনুসরণ করুন।
5. মেট্রিক্স বিভাগে, OAuth ক্লায়েন্ট তৈরি করুন বিকল্পে ক্লিক করুন।
6. OAuth ক্লায়েন্ট আইডি তৈরি করুন স্ক্রিনে, একটি অ্যাপ্লিকেশন ধরন বেছে নিন এবং ক্লায়েন্ট আইডির নাম লিখুন।
7. আপনার আবেদনের ধরনের সাথে প্রাসঙ্গিক অতিরিক্ত বিবরণ উল্লেখ করুন। যেমন, আপনি কোনও ওয়েব অ্যাপ্লিকেশন তৈরি করলে, ব্রাউজার ও সার্ভার অনুরোধের জন্য অনুমোদিত URI যোগ করুন।
8. আপনার ক্লায়েন্ট তৈরি হয়ে গেলে, ক্লায়েন্ট আইডি ও সিক্রেট সেভ করুন।
9. Maps Grounding Lite অ্যাক্সেস করার জন্য আপনার MCP হোস্ট বা MCP সার্ভার অ্যাপ্লিকেশন কনফিগার করার সময়, আপনার OAuth ক্লায়েন্ট আইডি ও সিক্রেট পাস করুন। এছাড়াও, আপনাকে অবশ্যই নিচের স্কোপের অনুরোধ করতে হবে: https://www.googleapis.com/auth/maps-platform.mapstools.

আরও তথ্যের জন্য, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা দেখুন।

Maps Grounding Lite MCP সার্ভার অ্যাক্সেস করার জন্য LLM কনফিগার করা

Maps Grounding Lite API পরিষেবা চালু করা আছে এমন Google Cloud প্রোজেক্ট এবং API কী বা OAuth ক্লায়েন্ট আইডি ও সিক্রেটের মতো বৈধ ক্রেডেনশিয়াল থাকলে, আপনি LLM-কে MCP সার্ভার অ্যাক্সেস করার জন্য কনফিগার করতে পারবেন। এর জন্য আপনাকে সংশ্লিষ্ট MCP কনফিগারেশন ডকুমেন্টেশন অনুসরণ করতে হবে এবং Maps Grounding Lite MCP সার্ভার URL ব্যবহার করতে হবে: https://mapstools.googleapis.com/mcp

আরও তথ্যের জন্য, AI অ্যাপ্লিকেশনে MCP কনফিগার করা দেখুন।

Gemini CLI-এর মাধ্যমে Maps Grounding Lite কনফিগার করা

এই বিভাগে, Gemini CLI ব্যবহার করে কীভাবে Maps Grounding Lite MCP সার্ভার কনফিগার করতে হয় তার একটি উদাহরণ দেওয়া হয়েছে। আরও বিবরণের জন্য, Gemini CLI-এর সাথে MCP সার্ভার দেখুন।

1. Gemini CLI ইনস্টল করার পরে, আপনি Maps Grounding Lite MCP সার্ভার কনফিগার করতে add কমান্ড ব্যবহার করতে পারবেন:

   gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp
   

   কনফিগারেশন সফল হলে, আপনি একটি কনফার্মেশন দেখতে পাবেন যে আপনার ব্যবহারকারীর সেটিংসে সার্ভার যোগ করা হয়েছে।

2. সার্ভার সঠিকভাবে কাজ করছে কিনা তা যাচাই করতে, /mcp list কমান্ডটি চালান:

   > /mcp list
   
   Configured MCP servers:
   
   maps-grounding-lite-mcp - Ready (5 tools)
   Tools:
   -   compute_routes
   -   lookup_weather
   -   resolve_maps_urls
   -   resolve_names
   -   search_places
   

3. CLI-এর মাধ্যমে Maps সম্পর্কিত প্রশ্ন জিজ্ঞাসা করা শুরু করুন। যেমন, "মাউন্টেন ভিউতে কিছু রেস্তোরাঁর নাম সাজেস্ট করো" বলে দেখুন, এটি আপনার হয়ে search_places টুল কল করবে।

মনে রাখবেন: OAuth ব্যবহার করে Maps Grounding Lite অ্যাক্সেস করার জন্য Gemini CLI এক্সটেনশন কনফিগার করা সংক্রান্ত তথ্যের জন্য, Google Cloud ডকুমেন্টেশনে Gemini CLI বিভাগ দেখুন।

Agent Development Kit (ADK)-এর মাধ্যমে 'গ্রাউন্ডিং লাইট' কনফিগার করা

এই বিভাগে এমন উদাহরণ দেওয়া আছে যা দেখায় যে কীভাবে Agent Development Kit (ADK) এবং Python, Java বা TypeScript-এর মাধ্যমে Grounding Lite MCP সার্ভার কনফিগার করতে হয়।

মনে রাখবেন: Maps Grounding Lite পরিষেবা চালু করেছেন কিনা এবং API কী পেয়েছেন কিনা তা নিশ্চিত করুন।

Python

আপনি GitHub-এ adk-samples রিপোজিটরিতে এই উদাহরণের সম্পূর্ণ প্রয়োগ খুঁজে পেতে পারেন।

ধাপ ১: McpToolset-এর মাধ্যমে Google Maps Grounding Lite-এর জন্য আপনার এজেন্টকে সংজ্ঞায়িত করুন

আপনার agent.py ফাইল পরিবর্তন করুন। আপনার আসল API key দিয়ে YOUR_GOOGLE_MAPS_API_KEY পরিবর্তন করুন।

# ./adk_agent_samples/mcp_agent/agent.py
import os
from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

# Retrieve the API key from an environment variable or directly insert it.
GOOGLE_MAPS_API_KEY = os.getenv("GOOGLE_MAPS_API_KEY")
if not GOOGLE_MAPS_API_KEY:
    GOOGLE_MAPS_API_KEY = "YOUR_GOOGLE_MAPS_API_KEY_HERE"

if GOOGLE_MAPS_API_KEY == "YOUR_GOOGLE_MAPS_API_KEY_HERE":
    print("WARNING: GOOGLE_MAPS_API_KEY is not set.")

root_agent = Agent(
    model='gemini-flash-latest',
    name='travel_planner_agent',
    description='A helpful assistant for planning travel routes.',
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mapstools.googleapis.com/mcp",
                headers={
                    "X-Goog-Api-Key": GOOGLE_MAPS_API_KEY,
                    "Content-Type": "application/json",
                    "Accept": "application/json, text/event-stream"
                }
            )
        )
    ]
)
    

ধাপ ২: __init__.py আছে কিনা দেখুন

আপনার agent.py-এর মতো একই ডিরেক্টরিতে __init__.py আছে কিনা তা নিশ্চিত করুন:

from . import agent
    

ধাপ ৩: adk web রান করান ও ইন্টার‍্যাক্ট করুন

1. এনভায়রনমেন্ট ভেরিয়েবল সেট করুন:
   আপনার টার্মিনালে Google Maps API কী এনভায়রনমেন্ট ভেরিয়েবল হিসেবে সেট করুন:

   export GOOGLE_MAPS_API_KEY="YOUR_ACTUAL_GOOGLE_MAPS_API_KEY"
           

2. রান করুন adk web:
   ADK ওয়েব ইন্টারফেস চালু করতে, নিম্নলিখিত কমান্ডটি রান করুন:

   adk web
           

3. UI-তে ইন্টার‍্যাক্ট করা:
   • travel_planner_agent বেছে নিন।
   • এই ধরনের প্রম্পট ব্যবহার করে দেখুন:
     • "আমি আগামীকাল সান ফ্রান্সিসকোতে থাকব। আবহাওয়া কেমন?"
     • "গোল্ডেন গেট পার্কের কাছাকাছি কফি শপ খোঁজো।"
     • "GooglePlex থেকে SFO-তে যাওয়ার দিকনির্দেশ দাও।"

Java

Java-তে McpToolset ইনিশিয়ালাইজ করে এমন একটি এজেন্টকে সংজ্ঞায়িত করুন। আপনি এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার না করলে, YOUR_GOOGLE_MAPS_API_KEY_HERE-এর জায়গায় আপনার পাওয়া আসল API কী বসিয়ে দিন।

package agents;

import com.google.adk.agents.LlmAgent;
import com.google.adk.runner.InMemoryRunner;
import com.google.adk.sessions.SessionKey;
import com.google.adk.tools.mcp.McpToolset;
import com.google.adk.tools.mcp.StreamableHttpServerParameters;
import com.google.genai.types.Content;
import com.google.genai.types.Part;
import java.util.HashMap;
import java.util.Map;

public class MapsAgentCreator {
    public static void main(String[] args) {
        String googleMapsApiKey = System.getenv("GOOGLE_MAPS_API_KEY");
        if (googleMapsApiKey == null || googleMapsApiKey.trim().isEmpty()) {
            googleMapsApiKey = "YOUR_GOOGLE_MAPS_API_KEY_HERE";
            if ("YOUR_GOOGLE_MAPS_API_KEY_HERE".equals(googleMapsApiKey)) {
                System.out.println("WARNING: GOOGLE_MAPS_API_KEY is not set.");
            }
        }

        Map<String, String> headers = new HashMap<>();
        headers.put("X-Goog-Api-Key", googleMapsApiKey);
        headers.put("Content-Type", "application/json");
        headers.put("Accept", "application/json, text/event-stream");

        StreamableHttpServerParameters serverParams =
                StreamableHttpServerParameters.builder("https://mapstools.googleapis.com/mcp")
                        .headers(headers)
                        .build();

        try (McpToolset toolset = new McpToolset(serverParams)) {
            LlmAgent agent = LlmAgent.builder()
                    .model("gemini-flash-latest")
                    .name("travel_planner_agent")
                    .description("A helpful assistant for planning travel routes.")
                    .tools(toolset)
                    .build();

            System.out.println("Agent created: " + agent.name());

            InMemoryRunner runner = new InMemoryRunner(agent);
            String userId = "maps-user-" + System.currentTimeMillis();
            String sessionId = "maps-session-" + System.currentTimeMillis();
            String promptText =
                    "Please give me directions to the nearest pharmacy to Madison Square Garden.";

            SessionKey sessionKey = runner.sessionService()
                    .createSession(runner.appName(), userId, null, sessionId)
                    .blockingGet()
                    .sessionKey();
            System.out.println("Session created: " + sessionId + " for user: " + userId);

            Content promptContent = Content.fromParts(Part.fromText(promptText));
            System.out.println("\nSending prompt: \"" + promptText + "\" to agent...\n");

            runner.runAsync(sessionKey, promptContent)
                    .blockingForEach(event -> {
                        System.out.println("Event received: " + event.toJson());
                    });
        } catch (Exception e) {
            System.err.println("An error occurred: " + e.getMessage());
            e.printStackTrace();
        }
    }
}
    

TypeScript

TypeScript-এ MCPToolset ইনিশিয়ালাইজ করে এমন একটি এজেন্টকে সংজ্ঞায়িত করুন:

import 'dotenv/config';
import {LlmAgent, MCPToolset} from "@google/adk";

const googleMapsApiKey = process.env.GOOGLE_MAPS_API_KEY;
if (!googleMapsApiKey) {
    console.warn("WARNING: GOOGLE_MAPS_API_KEY is not set.");
    throw new Error(
        'GOOGLE_MAPS_API_KEY is not provided, please run "export GOOGLE_MAPS_API_KEY=YOUR_ACTUAL_KEY" to add that.'
    );
}

export const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "travel_planner_agent",
    description: "A helpful assistant for planning travel.",
    tools: [
        new MCPToolset({
            type: "SseConnectionParams",
            url: "https://mapstools.googleapis.com/mcp",
            headers: {
                "X-Goog-Api-Key": googleMapsApiKey,
                "Content-Type": "application/json",
                "Accept": "application/json, text/event-stream"
            }
        })
    ],
});
    

মতামত শেয়ার করা

Maps Grounding Lite সম্পর্কে মতামত শেয়ার করতে, নিম্নলিখিত ফর্ম ব্যবহার করুন:

• বাগ সম্পর্কে অভিযোগ জানান
• ফিচার সংক্রান্ত অনুরোধ জমা দিন
• মতামত জানান