Maps Experience এজেন্ট টুল

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

Maps Experience agent tools হল দুটি SKU সহ একটি প্রোডাক্ট: Essentials এবং Pro। Pro বিকল্প ব্যবহার না করলে, প্রতিটি অনুরোধের জন্য Essentials-এর অধীনে বিল করা হয়। Pro বিকল্পে কোনও রুটে জায়গা সার্চ করা, জায়গার বিস্তারিত বিবরণ, সার্চ প্রতি আরও জায়গা, রুট প্রতি আরও মধ্যবর্তী স্টপ, লাইভ ট্রাফিক সহ রুট, পরাগ পূর্বাভাস এবং ঐতিহাসিক এয়ার কোয়ালিটি যোগ করা হয়। দুটি SKU-ই একই টুল, MCP সার্ভার, REST পদ্ধতি এবং ক্রেডেনশিয়াল ব্যবহার করে। আরও জানতে, Essentials ও Pro দেখুন।

টুল

Maps Experience agent tools, LLM-কে নিম্নলিখিত Google Maps ফিচার অ্যাক্সেস করতে দেয়:

• জায়গা সার্চ করা: জায়গা সম্পর্কে তথ্য জানতে চাওয়া এবং AI-জেনারেটেড সারাংশ পাওয়া। এছাড়াও, উত্তরে সারসংক্ষেপের প্রতিটি জায়গার জন্য জায়গা আইডি, অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক এবং Google Maps লিঙ্ক অন্তর্ভুক্ত থাকে। আপনি ম্যাপে জায়গা দেখাতে অন্যান্য Google Maps Platform API-এর সাথে জায়গার আইডি এবং অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট ব্যবহার করতে পারবেন। Places UI Kit-এর মাধ্যমে কোনও অতিরিক্ত খরচ ছাড়াই এইসব জায়গা দেখাতে, এজেন্টিক ডেটা ভিজ্যুয়ালাইজেশন টোকেন (প্রিভিউ) ব্যবহার করুন। Pro-এর মাধ্যমে, আপনি জায়গার আরও বিবরণ, যেমন রিভিউ থেকে ইনসাইট এবং প্রতিটি অনুরোধে সর্বাধিক ১০টি জায়গার জন্য অনুরোধ করতে পারেন।
• রুট বরাবর খোঁজা: ভ্রমণের রুট বরাবর জায়গা খুঁজুন—retrieval_token থেকে compute_routes, route_endpoints বা encoded_polyline ব্যবহার করে নির্দিষ্ট করা—এবং AI-জেনারেটেড সারসংক্ষেপ, জায়গার বিবরণ, ঘুরপথে যাওয়ার দূরত্ব ও ভ্রমণের সময় এবং এজেন্টিক ডেটা ভিজ্যুয়ালাইজেশন টোকেন (প্রিভিউ) পান। প্রতিটি search_along_route অনুরোধের জন্য Pro SKU-এর অধীনে বিল করা হয়।
• আবহাওয়া দেখুন: কোনও লোকেশনের পরিবেশগত অবস্থা সম্পর্কে অনুরোধ করুন, যার মধ্যে রয়েছে আবহাওয়া (বর্তমান পরিস্থিতি, ২৪-ঘণ্টার প্রতি ঘণ্টার ইতিহাস এবং সর্বাধিক ১০-দিনের প্রতি ঘণ্টার ও দৈনিক পূর্বাভাস) এবং বর্তমান বা সর্বাধিক ৪-দিনের পূর্বাভাস এয়ার কোয়ালিটি। Pro-এর মাধ্যমে, আপনি সর্বাধিক ৫ দিনের দৈনিক পরাগের পূর্বাভাস (উদ্ভিদের প্রজাতির বিবরণ সহ) এবং সর্বাধিক ৩০ দিনের প্রতি ঘণ্টার এয়ার কোয়ালিটির ইতিহাসও অনুরোধ করতে পারেন।

• রুট গণনা করুন: শুরু এবং গন্তব্যের মধ্যে একটি রুটের জন্য অনুরোধ করুন, ঐচ্ছিকভাবে মধ্যবর্তী স্টপের মাধ্যমে এবং রুটের দূরত্ব, সময়কাল এবং একটি DRIVE রুটের জন্য retrievalToken ফেরত দিন যা আপনি search_along_route-এ পাস করতে পারেন। Pro-এর মাধ্যমে, রুটগুলি লাইভ ট্রাফিক পরিস্থিতি বিবেচনা করতে পারে এবং আরও মধ্যবর্তী স্টপ অন্তর্ভুক্ত করতে পারে।

  মনে রাখবেন: Maps Experience agent tools ধাপে ধাপে দিকনির্দেশ বা নেভিগেশন সংক্রান্ত তথ্য প্রদান করে না। Pro বিকল্প ছাড়া গণনা করা রুট লাইভ ট্রাফিক হিসাব করে না।

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

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

Essentials ও Pro

Essentials ও Pro হল একই প্রোডাক্টের দুটি SKU, আলাদা প্রোডাক্ট বা প্ল্যান নয়। Pro বিকল্প ব্যবহার করলে, অনুরোধের জন্য Pro-এর অধীনে বিল করা হয়। অন্যান্য সব অনুরোধের জন্য Essentials-এর অধীনে বিল করা হয়। Pro বিকল্পগুলি হল টুল অনুরোধের সাধারণ ফিল্ড, তাই LLM আপনার হয়ে সেগুলি ব্যবহার করতে পারে। এছাড়াও, একজন এজেন্ট একই কথোপকথনে দুটি SKU ব্যবহার করতে পারেন। যেমন, কোনও এজেন্ট কোনও ল্যান্ডমার্কের কাছাকাছি কফি শপ খুঁজতে Essentials ব্যবহার করতে পারেন। তারপর, তাদের সিগনেচার ড্রিঙ্ক ও বসার জায়গা সম্পর্কে ফলো-আপ প্রশ্নের উত্তর দিতে, এটি Pro ব্যবহার করতে পারে। Pro-এর জন্য কোনও আলাদা MCP সার্ভার, এন্ডপয়েন্ট বা ক্রেডেনশিয়াল নেই।

Essentials, Pro এবং Grounding with Google Maps-এর তুলনা করুন

Grounding with Google Maps হল একটি আলাদা প্রোডাক্ট। এটি Gemini API, Google AI Studio এবং Gemini Enterprise Agent Platform-এ Gemini মডেলে বিল্ট-ইন হিসেবে থাকে। মডেলটি সিদ্ধান্ত নেয় যে কখন Google Maps-এ কোয়েরি করতে হবে এবং উদ্ধৃতি সহ গ্রাউন্ডেড উত্তর ফেরত দেয়। আপনি Gemini-তে তৈরি করার সময় Grounding with Google Maps বেছে নিন এবং মডেলকে গ্রাউন্ডিং ম্যানেজ করতে দিন। অন্যান্য মডেল বা এজেন্ট ফ্রেমওয়ার্কের জন্য অথবা প্রতিটি টুল কলের সরাসরি নিয়ন্ত্রণের জন্য Maps Experience agent tools বেছে নিন।

নিচের সারণীতে Essentials SKU, Pro SKU এবং Grounding with Google Maps-এর তুলনা করা হয়েছে:

	Maps Experience agent tools		Grounding with Google Maps
	Essentials SKU (আগে Maps Grounding Lite নামে পরিচিত ছিল)	Pro SKU
অনুরোধের জন্য কীভাবে বিল করা হয়	প্রতিটি টুল সংক্রান্ত অনুরোধ যা Pro বিকল্প ব্যবহার করে না	প্রতিটি search_along_route অনুরোধ, অথবা Pro বিকল্প ব্যবহার করে এমন অন্য কোনও টুলের জন্য করা যেকোনও অনুরোধ। দেখুন Pro SKU-এর অধীনে কী বিল করা হয়েছে।	প্রতিটি Google Maps কোয়েরি বা গ্রাউন্ডেড প্রম্পট, প্ল্যাটফর্ম এবং মডেলের উপর নির্ভর করে
মডেল ও প্ল্যাটফর্ম	যেকোনও মডেল বা এজেন্ট ফ্রেমওয়ার্ক যা MCP সাপোর্ট করে বা REST API কল করতে পারে। দুটি SKU-এর জন্য একটি টুল সেট এবং একই ক্রেডেনশিয়াল		Gemini API, Google AI Studio এবং Gemini Enterprise Agent Platform-এ Gemini মডেল
টুল কী রিটার্ন করে	মূল তথ্য: প্রতিটি সার্চে সর্বাধিক ৫টি জায়গার বিবরণ, লাইভ ট্রাফিক ছাড়া রুটের দূরত্ব ও সময়, বর্তমান আবহাওয়া ও পূর্বাভাস (সাথে ২৪ ঘণ্টার প্রতি ঘণ্টার আবহাওয়ার ইতিহাস) এবং বর্তমান বা পূর্বাভাস এয়ার কোয়ালিটি	Essentials-এর সব সুবিধা, সাথে ঘুরপথে যাওয়ার সময় ও দূরত্ব সহ রুটের মধ্যে থাকা জায়গা, জায়গার বিস্তারিত বিবরণ (যেমন রিভিউ থেকে পাওয়া ইনসাইট), সার্চ প্রতি সর্বাধিক ১০টি জায়গা, লাইভ ট্রাফিক সহ রুট, সর্বাধিক ২৫টি মধ্যবর্তী ওয়েপয়েন্ট, পরাগরেণুর পূর্বাভাস এবং সর্বাধিক ৩০ দিনের এয়ার কোয়ালিটির ইতিহাস	রিভিউ থেকে জায়গার বিবরণ ও ইনসাইট এবং লাইভ ট্রাফিক সহ রুটের তথ্য
অনুরোধের উদাহরণ	ফ্যাকচুয়াল ও লজিস্টিক সংক্রান্ত প্রশ্ন: স্টোর বা ব্যবসা, খোলা থাকার সময়, ঠিকানা, দূরত্ব বা ভ্রমণের আনুমানিক সময়, বর্তমান আবহাওয়া, ১০ দিনের আবহাওয়ার পূর্বাভাস এবং বর্তমান বা ৪ দিনের এয়ার কোয়ালিটির পূর্বাভাস খোঁজা	সাবজেক্টিভ, বিস্তারিত বা বিশেষ প্রশ্ন: কোনও রুটের মধ্যে থাকা জায়গা, পরিবেশ, সিগনেচার ডিশ, দর্শকদের জন্য পরামর্শ, ৬ থেকে ১০টি জায়গার মধ্যে তুলনা, বর্তমান ট্রাফিকের মধ্যে ভ্রমণের সময়, পরাগরেণু ও অ্যালার্জি সংক্রান্ত পূর্বাভাস, এবং গত ৩০ দিনের এয়ার কোয়ালিটির ইতিহাস	Gemini-তে কনভারসেশনাল সার্চ, ভ্রমণসূচী প্ল্যান করা এবং স্থানীয় জায়গা খোঁজা
Places UI Kit ভিজ্যুয়ালাইজেশন	এজেন্টিক ডেটা ভিজ্যুয়ালাইজেশন টোকেন (প্রিভিউ)-এর সাথে কোনও অতিরিক্ত খরচ ছাড়াই অন্তর্ভুক্ত		আলাদাভাবে বিল করা হয়েছে
কোনও চার্জ ছাড়াই মাসিক ব্যবহার	১০,০০০টি অনুরোধ	৫,০০০টি অনুরোধ	প্ল্যাটফর্ম ও মডেলের উপর নির্ভর করে। যেমন, Gemini API-তে, Gemini 3 এবং নতুন মডেলগুলিতে প্রতি মাসে ৫,০০০টি সার্চ কোয়েরি বিনামূল্যে অন্তর্ভুক্ত থাকে। তারপরে, প্রতি ১,০০০টি সার্চ কোয়েরির জন্য $১৪ খরচ হয়।
যখন ব্যবহার করবেন তখন পেমেন্ট করুন	প্রতি ১,০০০টি অনুরোধের জন্য $৭.০০, ভলিউম ডিসকাউন্ট সহ	১,০০০টি অনুরোধের জন্য $১৪.০০, ভলিউম ডিসকাউন্ট সহ
সেভ করতে সাবস্ক্রাইব করুন	Essentials ও Pro প্ল্যানে অন্তর্ভুক্ত	Pro প্ল্যানে অন্তর্ভুক্ত	উপলভ্য নয়
শুরু করুন	দুটি SKU-এর জন্য একটি সেট-আপ: MCP সার্ভার ব্যবহার করার জন্য LLM কনফিগার করুন অথবা REST-এর মাধ্যমে টুল কল করুন দেখুন।		Gemini API অথবা Agent Platform

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

Pro SKU-এর অধীনে কী বিল করা হয়

Essentials-এ কোন কোন ফিচার অন্তর্ভুক্ত এবং কোন কোন ফিচারের জন্য Pro SKU প্রয়োজন, তা নিম্নলিখিত সারণীতে সংক্ষিপ্তভাবে তুলে ধরা হয়েছে:

টুল	ক্ষমতা	Essentials	Pro
জায়গা সার্চ করুন	প্রতিটি অনুরোধে জায়গার সংখ্যা	৫ পর্যন্ত	৬ থেকে ১০ (page_size ৬ থেকে ১০-এর মধ্যে)
	সার্চের সারসংক্ষেপে জায়গার বিস্তারিত বিবরণ (রিভিউ থেকে ইনসাইট, মেনু হাইলাইট, পরিবেশ, কোনও জায়গা কতটা ব্যস্ত, ভিজিটরদের জন্য পরামর্শ এবং কাছাকাছি কোয়েরির জন্য দূরত্ব বা ভ্রমণের সময়)	উপলভ্য নয়	include_extended_details-এর সাথে উপলভ্য
রুট বরাবর খুঁজুন	রুট বরাবর জায়গা, ঘুরপথে যাওয়ার দূরত্ব ও ভ্রমণের সময় এবং ঐচ্ছিক জায়গার বিস্তারিত বিবরণ বা ট্রাফিক-সচেতন ঘুরপথে যাওয়ার সময়	উপলভ্য নয়	প্রতিটি অনুরোধ
রুট কম্পিউট করুন	রাউটিং সংক্রান্ত পছন্দ	লাইভ ট্রাফিক সংক্রান্ত তথ্য নেই	ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL-এর সাথে লাইভ ট্রাফিক বা ট্রানজিট রুটের জন্য রিয়েল-টাইম ট্রানজিট ডেটা হিসেব করে
	প্রতিটি রুটে মধ্যবর্তী ওয়েপয়েন্ট	১০ পর্যন্ত	১১ থেকে ২৫ (১০ intermediate_waypoints-এর বেশি)
আবহাওয়া দেখুন	আবহাওয়া	বর্তমান আবহাওয়া, প্রতি ঘণ্টা ও দিনের পূর্বাভাস (১০ দিন পর্যন্ত) এবং ২৪ ঘণ্টা পর্যন্ত প্রতি ঘণ্টার ইতিহাস (capabilities-এ WEATHER, অথবা লিগ্যাসি অনুরোধ যা capabilities, weather_options, air_quality_options এবং language_code বাদ দেয়)	কোনও Pro বিকল্প নেই (সব WEATHER ডেটা Essentials-এ অন্তর্ভুক্ত)
	এয়ার কোয়ালিটি	বর্তমান পরিস্থিতি, আজকের সারাদিনের প্রতি ঘণ্টার ফলাফল এবং ৪ দিন পর্যন্ত প্রতি ঘণ্টার পূর্বাভাস (capabilities-এ AIR_QUALITY)	অতীতে ৩০ দিন পর্যন্ত এয়ার কোয়ালিটির ইতিহাস (আজকের আগে capabilities-এ AIR_QUALITY-এর সাথে date বা লোকেশনের টাইম জোনে অতীতে hour), যখন উত্তরে ফেরত দেওয়া হয়
	পরাগ	উপলভ্য নয়	সর্বাধিক ৫ দিনের জন্য দৈনিক পরাগের পূর্বাভাস এবং উদ্ভিদের প্রজাতির বিবরণ (POLLEN-এর মধ্যে capabilities), যখন উত্তরে ফেরত আসে
Resolution API	কোনও Pro বিকল্প নেই। সমস্ত অনুরোধের জন্য Places API Text Search Essentials (IDs Only) SKU-এর অধীনে কোনও চার্জ ছাড়াই বিল করা হয়।

প্রতিটি ক্ষমতা চালু করে এমন অনুরোধের বিকল্পের জন্য, জায়গা সার্চ করুন, রুট বরাবর সার্চ করুন, রুট গণনা করুন এবং আবহাওয়া দেখুন বিকল্প দেখুন।

Control Pro ব্যবহার

search_places, compute_routes এবং lookup_weather-এ প্রো বিকল্প ডিফল্ট হিসেবে বন্ধ থাকে। ব্যবহারকারীর অনুরোধে প্রয়োজন হলে এবং টুলের বিবরণ বা আপনার নির্দেশাবলী অনুমতি দিলে, একটি LLM সেগুলি সেট করে—বা search_along_route কল করে। টুলের বিবরণ মডেলকে বলে যে কোন বিকল্পের খরচ বেশি এবং কখন সেগুলি ব্যবহার করতে হবে: ৫-এর বেশি page_size, জায়গার বিবরণ, ১০টির বেশি মধ্যবর্তী ওয়েপয়েন্ট, ট্রাফিক-অ্যাওয়ার রাউটিং এবং search_along_route। আপনি REST-এর মাধ্যমে টুল কল করলে, আপনার কোড প্রতিটি বিকল্প সেট করে। খরচ ম্যানেজ করতে:

• Pro বিকল্প কখন উপযুক্ত তা মডেলকে বলুন। যেমন: "ব্যবহারকারী রিভিউ, মেনু বা পরিবেশ সম্পর্কে জিজ্ঞাসা করলে তবেই include_extended_details সেট করুন।" অথবা: "ব্যবহারকারী বর্তমান ভ্রমণের সময় জানতে চাইলে তবেই ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL ব্যবহার করুন।" অথবা: "ব্যবহারকারী কোনও রুট বরাবর জায়গা সম্পর্কে জিজ্ঞাসা করলে শুধুমাত্র তখনই search_along_route-কে কল করুন।" অথবা: "POLLEN, বা AIR_QUALITY-এর সাথে অতীতের date বা hour যোগ করুন, শুধুমাত্র যখন ব্যবহারকারী পরাগ, অ্যালার্জি বা ঐতিহাসিক এয়ার কোয়ালিটি সম্পর্কে জিজ্ঞাসা করেন।"
• Essentials SKU-তে কোনও এজেন্টকে রাখতে, মডেলকে নির্দেশ দিন যাতে কখনও search_along_route কল না করে বা Pro বিকল্প ব্যবহার না করে। প্রো বিকল্পগুলি হল include_extended_details, ৫-এর বেশি page_size, ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, ১০টির বেশি ইন্টারমিডিয়েট ওয়েপয়েন্ট, capabilities-এ POLLEN এবং capabilities-এ AIR_QUALITY সহ অতীতের date বা hour। আপনার MCP ক্লায়েন্ট টুল বা টুলের আর্গুমেন্ট সীমিত করতে পারলে, আপনি search_along_route এবং টুলের কনফিগারেশনে সেই আর্গুমেন্টের ভ্যালুও ব্লক করতে পারবেন।
• আপনার বিলিং রিপোর্টে Maps Grounding Pro SKU মনিটর করুন এবং বাজেট সংক্রান্ত সতর্কতা সেট করুন।

Resolution API

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

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

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

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

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

বিলিং ও কোটা

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

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

MCP সার্ভার বা REST-এর মাধ্যমে প্রতিটি Search places, Search along route, Compute routes বা Lookup weather অনুরোধের জন্য একটি SKU-এর অধীনে বিল করা হয়: Maps Grounding Essentials বা Maps Grounding Pro। প্রতিটি search_along_route অনুরোধ এবং Pro বিকল্প ব্যবহার করে এমন যেকোনও অনুরোধের জন্য Pro SKU-এর অধীনে বিল করা হয়। কোনও অনুরোধের জন্য দুটি SKU-এর অধীনে কখনও বিল করা হয় না এবং অনুরোধে Pro বিকল্পের সংখ্যা চার্জ পরিবর্তন করে না। প্রতিটি টুলের জন্য SKU নির্ধারণ করে এমন ক্ষমতা এবং বিকল্পগুলির জন্য, Pro SKU-এর অধীনে কী বিল করা হয় দেখুন।

Maps Grounding Essentials অনুরোধের জন্য প্রতি মাসে প্রথম ১০,০০০টি অনুরোধের পরে প্রতি ১,০০০টি অনুরোধের জন্য $৭.০০ বিল করা হয়। Maps Grounding Pro অনুরোধের জন্য প্রতি মাসে প্রথম ৫,০০০টি অনুরোধের পরে প্রতি ১,০০০টি অনুরোধের জন্য $১৪.০০ বিল করা হয়। উভয় SKU-এর ক্ষেত্রে বেশি মাসিক ব্যবহারের জন্য ভলিউম ডিসকাউন্ট আছে।

মূল্য সংক্রান্ত বিবরণের জন্য মূল্যের প্রধান টেবিল এবং ভারতের জন্য মূল্যের টেবিল দেখুন।

Resolution API সংক্রান্ত অনুরোধের (ResolveNames এবং ResolveMapsUrls) জন্য Places API Text Search Essentials (শুধুমাত্র আইডি) SKU-এর অধীনে কোনও চার্জ নেওয়া হয় না।

আপনি যদি Places UI Kit-এর মাধ্যমে search_places বা search_along_route রেসপন্স থেকে জায়গাগুলি দেখান, তাহলে আপনি এজেন্টিক ডেটা ভিজ্যুয়ালাইজেশন টোকেন (প্রিভিউ) ব্যবহার করতে পারেন যাতে সেই Places UI Kit অনুরোধের জন্য বিল করা না হয়।

Essentials SKU-এর ব্যবহার Essentials ও Pro সেভ করতে সাবস্ক্রাইব করুন প্ল্যানে অন্তর্ভুক্ত। Pro SKU-এর ব্যবহার Pro প্ল্যানে অন্তর্ভুক্ত।

কোটা

Maps Experience agent tools-এর মাধ্যমে প্রদান করা টুল ও API-এর ক্ষেত্রে নিম্নলিখিত কোটা প্রযোজ্য হয়:

• জায়গা সার্চ করা: প্রতিটি প্রোজেক্টের জন্য প্রতি মিনিটে ৩০০টি কোয়েরি।
• রুট বরাবর সার্চ করা: প্রতিটি প্রোজেক্টের জন্য প্রতি মিনিটে ৩০০টি কোয়েরি।
• আবহাওয়া লুক-আপ: প্রতিটি প্রোজেক্টের জন্য প্রতি মিনিটে ৩০০টি কোয়েরি।
• Compute routes: প্রতিটি প্রোজেক্টের জন্য প্রতি মিনিটে ৩০০টি কোয়েরি।
• নাম সমাধান করা: প্রতিটি প্রোজেক্টের জন্য প্রতি মিনিটে ৬০০টি কোয়েরি।
• Maps URL সমাধান করা: প্রতিটি প্রোজেক্টের জন্য প্রতি মিনিটে ৬০০টি কোয়েরি।

প্রতিটি টুলের জন্য কোটা গণনা করা হয় এবং Essentials ও Pro SKU-এর মাধ্যমে শেয়ার করা হয়। একই টুলের জন্য Pro অনুরোধ, Essentials অনুরোধের মতোই কোটা ব্যবহার করে।

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

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

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

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

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

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

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

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

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

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

search_places টুল places ফিল্ড এবং search_along_route টুল results[].place ফিল্ড এমন সোর্স প্রদান করে যা summary-কে সাপোর্ট করে। প্রতিটি জায়গার জন্য, নিম্নলিখিত মেটাডেটা রিটার্ন করা হয়:

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

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

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

এইসব শর্তাবলী সেইসব সারসংক্ষেপের ক্ষেত্রেও প্রযোজ্য যেগুলিতে Pro থেকে পাওয়া জায়গার বিস্তারিত বিবরণ অন্তর্ভুক্ত থাকে, যেমন রিভিউ থেকে পাওয়া ইনসাইট। summary প্রতিটি জায়গাকে শূন্য-ভিত্তিক ইন্ডেক্স দিয়ে উল্লেখ করে, যেমন [0], যা places বা results-এর কোনও এন্ট্রির সাথে ম্যাপ করে। প্রতিটি জায়গার সাথে googleMapsLinks.reviewsUrl অন্তর্ভুক্ত থাকে, যা Google Maps-এ জায়গার রিভিউতে লিঙ্ক করে। ইনসাইটের পিছনে থাকা রিভিউ দেখতে ব্যবহারকারীরা এটি ফলো করতে পারেন।

ভয়েস-ফার্স্ট ইন্টারফেস

আপনার অ্যাপ যদি ভয়েসের মাধ্যমে Maps Experience agent tools-এর ফলাফল দেখায়, তাহলে আপনাকে ভয়েস-ফার্স্ট ইন্টারফেস-এর জন্য প্রয়োজনীয়তাও পূরণ করতে হবে। সংক্ষেপে:

• সোর্সিং: Google Maps-এর সোর্সগুলি একটি কম্প্যানিয়ন UI-তে দেখান যা ভয়েস কথোপকথনের একটি হুবহু ঐতিহাসিক রেকর্ড দেখায়।
• অ্যাক্টিভ ডিসক্লোজার: ইন্টার‍্যাকশনের সময় ব্যবহারকারীকে জানান যে AI-জেনারেটেড কন্টেন্টে Google Maps থেকে পাওয়া তথ্য থাকতে পারে। এছাড়াও, তাকে জানান যে বিস্তারিত সোর্স কম্প্যানিয়ন UI-তে উপলভ্য। আপনি স্ক্রিনে বা ভয়েসের মাধ্যমে এটি করতে পারবেন।
• স্থায়ী ডিসক্লোজার: স্থায়ী ব্যাখ্যা রাখুন, যেমন ভয়েস সেটিংস মেনুতে, যে AI-জেনারেটেড কন্টেন্টে Google Maps কন্টেন্ট অন্তর্ভুক্ত থাকতে পারে।
• ব্যবহারকারীর প্রশ্ন: কন্টেন্টের সোর্স সম্পর্কে ব্যবহারকারীর প্রশ্নের সঠিক উত্তর দিন এবং বিস্তারিত জানতে তাদের কম্প্যানিয়ন UI-তে নিয়ে যান।

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

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

আপনার Google Cloud প্রোজেক্টে Maps Experience agent tools চালু করুন

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

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

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

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

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

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

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

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

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

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

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

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

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

Maps Experience agent tools MCP সার্ভার অ্যাক্সেস করতে LLM কনফিগার করুন

Maps Experience agent tools পরিষেবা চালু করে ক্রেডেনশিয়াল তৈরি করার পরে, আপনি MCP সার্ভার অ্যাক্সেস করার জন্য LLM কনফিগার করতে পারবেন। আপনার LLM-এর MCP কনফিগারেশন ডকুমেন্টেশন অনুসরণ করুন এবং MCP সার্ভার URL ব্যবহার করুন: https://mapstools.googleapis.com/mcp

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

Gemini CLI-এর মাধ্যমে Maps Experience agent tools কনফিগার করা

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

1. Gemini CLI ইনস্টল করার পরে, MCP সার্ভার কনফিগার করতে gemini mcp add রান করুন:

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

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

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

   > /mcp list
   
   Configured MCP servers:
   
   maps-experience-agent-tools-mcp - Ready (6 tools)
   Tools:
   -   compute_routes
   -   lookup_weather
   -   resolve_maps_urls
   -   resolve_names
   -   search_along_route
   -   search_places
   

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

মনে রাখবেন: Gemini CLI এক্সটেনশনের সাথে OAuth ব্যবহার করতে, Google Cloud ডকুমেন্টেশনে MCP-এর Gemini CLI বিভাগ দেখুন।

Agent Development Kit (ADK)-এর মাধ্যমে Maps Experience agent tools কনফিগার করা

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

মনে রাখবেন: আপনি Maps Experience এজেন্ট টুল চালু করেছেন এবং API কী পেয়েছেন কিনা তা নিশ্চিত করুন।

Python

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

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

আপনার agent.py ফাইল পরিবর্তন করুন। YOUR_GOOGLE_MAPS_API_KEY-এর জায়গায় আপনার আসল 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 key সেট করুন:

   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: "StreamableHTTPConnectionParams",
            url: "https://mapstools.googleapis.com/mcp",
            transportOptions: {
                requestInit: {
                    headers: {
                        "X-Goog-Api-Key": googleMapsApiKey,
                        "Content-Type": "application/json",
                        "Accept": "application/json, text/event-stream"
                    }
                }
            }
        })
    ],
});
    

REST-এর মাধ্যমে টুল কল করুন

Maps Experience agent tools-এর প্রতিটি টুল REST পদ্ধতি হিসেবেও উপলভ্য। আপনার নিজস্ব এজেন্ট বা অ্যাপ্লিকেশনে টুলগুলি ওয়্যার করতে চাইলে সরাসরি REST পদ্ধতিগুলি কল করুন—যেমন, কোনও মডেলের জন্য আপনার নিজস্ব ফাংশন ঘোষণা করতে, মডেলটি কোন বিকল্পগুলি সেট করতে পারে তা বেছে নিন বা আপনার কোডে ডিফল্ট ভ্যালু সেট করুন।

নিম্নলিখিত সারণীতে প্রতিটি টুলের জন্য REST পদ্ধতি তালিকাভুক্ত করা হয়েছে:

টুল	REST পদ্ধতি
search_places	POST https://mapstools.googleapis.com/v1:searchText
search_along_route	POST https://mapstools.googleapis.com/v1:searchAlongRoute
lookup_weather	POST https://mapstools.googleapis.com/v1:lookupWeather
compute_routes	POST https://mapstools.googleapis.com/v1:computeRoutes
resolve_names	POST https://mapstools.googleapis.com/v1:resolveNames
resolve_maps_urls	POST https://mapstools.googleapis.com/v1:resolveMapsUrls

REST অনুরোধ সংশ্লিষ্ট টুলের মতো একই বিকল্প গ্রহণ করে এবং একই উত্তর ফেরত দেয়। REST অনুরোধ ও উত্তর বডিতে, ফিল্ডের নাম লোয়ার ক্যামেল কেস ব্যবহার করে—যেমন, text_query-এর পরিবর্তে textQuery। REST অনুরোধগুলি একই SKU-এর অধীনে বিল করা হয়, Pro বিকল্পগুলির জন্য একই নিয়ম অনুসরণ করে এবং MCP টুল কলের মতো একই কোটার দিকে গণনা করা হয়।

যাচাই করতে, MCP সার্ভারের জন্য যে Google Cloud প্রোজেক্ট ও ক্রেডেনশিয়াল ব্যবহার করেছেন, সেটিই ব্যবহার করুন। সেট-আপের ধাপের জন্য, MCP সার্ভার ব্যবহার করার জন্য LLM কনফিগার করুন দেখুন। X-Goog-Api-Key হেডারে API key পাস করুন অথবা Authorization হেডারে https://www.googleapis.com/auth/maps-platform.mapstools স্কোপ সহ OAuth অ্যাক্সেস টোকেন পাস করুন।

নিম্নলিখিত উদাহরণ searchText পদ্ধতিকে কল করে:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-d '{
  "textQuery": "coffee shops near Golden Gate Park"
}' \
"https://mapstools.googleapis.com/v1:searchText"

API_KEY-এর জায়গায় আপনার API key লিখুন।

উত্তরে search_places টুলের ফলাফলের মতো একই summary, places এবং contentToken ফিল্ড রয়েছে। প্রতিটি টুলের গাইডে এর উদাহরণের একটি REST ভার্সন দেখানো হয়।

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

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

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