گراندینگ لایت

آزمایشی: Grounding Lite در مرحله آزمایشی (قبل از GA) است. محصولات و ویژگی‌های قبل از GA ممکن است پشتیبانی محدودی داشته باشند و تغییرات در محصولات و ویژگی‌های قبل از GA ممکن است با سایر نسخه‌های قبل از GA سازگار نباشد. پیشنهادات قبل از GA تحت پوشش شرایط خاص سرویس پلتفرم Google Maps هستند. برای اطلاعات بیشتر، به توضیحات مرحله راه‌اندازی مراجعه کنید. استفاده از Grounding Lite در حالی که در مرحله آزمایشی است، هیچ هزینه‌ای ندارد.

پلتفرم نقشه‌های گوگل Grounding Lite سرویسی با پشتیبانی از پروتکل مدل زمینه (MCP) است که اتصال برنامه‌های هوش مصنوعی شما را با داده‌های مکانی قابل اعتماد از نقشه‌های گوگل آسان می‌کند. سرور MCP ابزارهایی را ارائه می‌دهد که به LLMها اجازه می‌دهد به قابلیت‌های مکان‌ها، آب و هوا و مسیرها دسترسی داشته باشند. می‌توانید Grounding Lite را با فعال کردن آن در هر ابزاری که از سرورهای MCP پشتیبانی می‌کند، امتحان کنید.

ابزارها

Grounding Lite ابزارهایی را ارائه می‌دهد که به LLMها اجازه می‌دهد به قابلیت‌های زیر در نقشه‌های گوگل دسترسی داشته باشند:

• جستجوی مکان‌ها : اطلاعاتی در مورد مکان‌ها درخواست کنید و خلاصه داده‌های مکانی تولید شده توسط هوش مصنوعی، و همچنین شناسه‌های مکان، مختصات طول و عرض جغرافیایی و پیوندهای نقشه‌های گوگل برای هر یک از مکان‌های موجود در خلاصه را دریافت کنید. می‌توانید از شناسه‌های مکان و مختصات طول و عرض جغرافیایی بازگشتی با سایر APIهای پلتفرم نقشه‌های گوگل برای نمایش مکان‌ها روی نقشه استفاده کنید.
• جستجوی آب و هوا : درخواست اطلاعات در مورد آب و هوا و ارائه شرایط فعلی، پیش‌بینی‌های ساعتی و پیش‌بینی‌های روزانه.

• محاسبه مسیرها : درخواست اطلاعات در مورد مسیرهای رانندگی یا پیاده‌روی بین دو مکان و اطلاعات مسافت و مدت زمان مسیر رفت و برگشت.

  توجه: Grounding Lite مسیریابی گام به گام، مسیرها، ترافیک در زمان واقعی یا اطلاعات ناوبری را ارائه نمی‌دهد.

فعال کردن سرور Maps Grounding Lite MCP به LLMها اجازه می‌دهد تا ابزارهای جدید ارائه شده توسط سرور را فراخوانی کنند تا اطلاعات زمینی اضافی را برای انواع داده‌های ذکر شده در بالا برگردانند. در حالی که LLM می‌تواند از این اطلاعات اضافی برای زمینه استفاده کند، پاسخی که LLM در نهایت تولید می‌کند ممکن است شامل اطلاعات دقیق برگردانده شده توسط سرور MCP نباشد. شما باید صحت پاسخ تولید شده را تأیید کنید.

صورتحساب و سهمیه‌ها

استفاده از Grounding Lite در حالت آزمایشی هیچ هزینه‌ای ندارد. با این حال، سهمیه‌های زیر برای ابزارهای ارائه شده توسط Grounding Lite اعمال می‌شود:

• مکان‌های جستجو : ۱۰۰ پرس‌وجو در دقیقه، برای هر پروژه. ۱۰۰۰ پرس‌وجو در روز، برای هر پروژه.
• جستجوی آب و هوا : ۳۰۰ درخواست در دقیقه، برای هر پروژه.
• محاسبه مسیرها : ۳۰۰ پرس‌وجو در دقیقه، برای هر پروژه.

سیاست‌ها و شرایط خدمات

Grounding Lite تابع شرایط خدمات پلتفرم نقشه‌های گوگل ، از جمله شرایط خاص این سرویس است. این بخش الزامات اضافی استفاده از خدمات برای Grounding Lite، از جمله LLM های سازگار و الزامات انتساب منبع را شرح می‌دهد.

الزامات LLM های سازگار

شما فقط می‌توانید از Grounding Lite با مدرک لیسانس مدیریت (LLM) که با شرایط خدمات پلتفرم نقشه‌های گوگل (Google Maps Platform Terms of Service) سازگار است، استفاده کنید.

برای مثال، شما مسئول هستید که اطمینان حاصل کنید محتوای نقشه‌های گوگل توسط LLM مورد استفاده شما ذخیره، ذخیره یا برای بهبود آن استفاده نمی‌شود. قبل از استفاده از Grounding Lite، باید شرایط خدمات هر مدلی را که قصد استفاده از آن را با Grounding Lite دارید، بررسی کنید. شما نباید از Grounding Lite با هیچ مدلی که از داده‌های ورودی به مدل برای آموزش یا بهبود مدل استفاده می‌کند، استفاده کنید. شما مسئول هستید که اطمینان حاصل کنید که استفاده شما از مدل به طور کامل با محدودیت‌های محتوای نقشه‌های گوگل در شرایط خدمات پلتفرم نقشه‌های گوگل، از جمله شرایط خاص سرویس، مطابقت دارد.

الزامات انتساب برای منابع نقشه‌های گوگل

هر پاسخ ابزار از Grounding Lite شامل منابعی است. هنگام ارائه نتایجی که از ابزارهای ارائه شده توسط Grounding Lite استفاده می‌کنند، باید منابع مرتبط Google Maps را به گونه‌ای درج کنید که الزامات زیر را برآورده کند:

• منابع نقشه‌های گوگل باید بلافاصله پس از محتوای تولید شده‌ای که منابع از آن پشتیبانی می‌کنند، قرار گیرند. این محتوای تولید شده همچنین به عنوان خروجی زمینی (Grounded Output) شناخته می‌شود.
• منابع نقشه‌های گوگل باید در یک تعامل کاربری قابل مشاهده باشند.

منابع ابزار جستجوی مکان‌ها

فیلد places در ابزار search_places منابعی را ارائه می‌دهد که از summary پشتیبانی می‌کنند. برای places ، فراداده‌های زیر برگردانده می‌شوند:

• place (نام منبع)
• id
• location
• googleMapsLinks

برای هر مکان، باید پیش‌نمایش لینکی ایجاد کنید که این الزامات را برآورده کند:

• با پیروی از دستورالعمل‌های انتساب متن Grounding Lite ، هر منبع را به Google Maps نسبت دهید.
• عنوان صفحه منبع را از فراداده Open Graph og:title از googleMapsLinks ارائه شده در پاسخ نمایش دهید.
• با استفاده از places.googleMapsLinks.placeUrl از پاسخ، به منبع لینک دهید.

پیکربندی LLMها برای استفاده از سرور MCP

برای استفاده از Grounding Lite، ابتدا به یک کلید API با سرویس Maps Grounding Lite API فعال نیاز دارید. سپس می‌توانید LLMها را برای دسترسی به سرور MCP پیکربندی کنید. سرور Grounding Lite MCP از انتقال HTTP قابل پخش استفاده می‌کند.

ایجاد یا پیکربندی کلید API

شما می‌توانید از یک کلید API موجود با Maps Grounding Lite استفاده کنید یا یک کلید API جدید ایجاد کنید، البته تا زمانی که سرویس Maps Grounding Lite API را روی کلید فعال کنید. Maps Grounding Lite API در طول دوره آزمایشی هزینه‌ای دریافت نمی‌کند، اما پرداخت هزینه باید در پروژه فعال باشد.

برای فعال کردن API:

1. در کنسول گوگل کلود ، پروژه‌ای را که می‌خواهید برای Grounding Lite استفاده کنید، انتخاب کنید.
2. فعال کردن صورتحساب برای پروژه در کنسول گوگل کلود .
3. از منوی ناوبری بالا، ترمینال Cloud Shell را باز کنید.

4. برای فعال کردن سرویس و نقطه پایانی MCP، دستورات زیر را اجرا کنید:

   gcloud beta services enable mapstools.googleapis.com --project=PROJECT_ID
   gcloud beta services mcp enable mapstools.googleapis.com --project=PROJECT_ID
   

5. برای ایجاد یا پیکربندی یک کلید API، مراحل موجود در شروع به کار با پلتفرم نقشه‌های گوگل را دنبال کنید.

توجه: هنگام ایجاد یا پیکربندی کلید API، حتماً با اعمال محدودیت‌های مناسب، استفاده از کلید را محدود کنید. برای اطلاعات بیشتر، به بخش «محدود کردن کلیدهای API» مراجعه کنید.

کلید API باید با استفاده از هدر X-Goog-Api-Key به سرور MCP ارسال شود. شما باید این را به عنوان یک هدر HTTP سفارشی در پیکربندی ابزار MCP در LLM مشخص کنید.

پیکربندی LLMها برای دسترسی به سرور Grounding Lite MCP

پس از فعال کردن کلید API با سرویس Maps Grounding Lite API ، می‌توانید LLMها را برای دسترسی به سرور MCP پیکربندی کنید. این کار با دنبال کردن مستندات پیکربندی MCP مربوطه و استفاده از آدرس اینترنتی سرور Grounding Lite MCP انجام می‌شود: https://mapstools.googleapis.com/mcp

پیکربندی Grounding Lite با Gemini CLI

این بخش مثالی از نحوه پیکربندی سرور Grounding Lite MCP با استفاده از Gemini CLI ارائه می‌دهد. برای جزئیات بیشتر، به سرورهای MCP با Gemini CLI مراجعه کنید.

1. پس از نصب رابط خط فرمان Gemini، می‌توانید از دستور add برای پیکربندی سرور Maps Grounding Lite MCP استفاده کنید:

   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 (3 tools)
   Tools:
   -   compute_routes
   -   lookup_weather
   -   search_places
   

3. شروع به پرسیدن سوالات مربوط به نقشه‌ها با رابط خط فرمان (CLI) کنید. برای مثال، عبارت «چند رستوران در مانتین ویو به من پیشنهاد بده» را امتحان کنید که باید ابزار search_places را از طرف شما فراخوانی کند.

اشتراک‌گذاری بازخورد

برای به اشتراک گذاشتن بازخورد در مورد Grounding Lite، از فرم‌های زیر استفاده کنید:

• گزارش اشکال
• ارسال درخواست ویژگی
• ارائه بازخورد