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

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

ابزارها

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

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

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

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

برنامه نمونه Grounding Lite را امتحان کنید (در یک برگه جدید باز کنید)

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

استفاده از 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

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

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

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

سرویس Maps Grounding Lite را در پروژه Google Cloud خود فعال کنید

برای فعال کردن 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

احراز هویت با استفاده از کلید API

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

برای احراز هویت با استفاده از کلید API:

  1. با دنبال کردن مراحل موجود در «شروع به کار با پلتفرم نقشه‌های گوگل»، یک کلید API ایجاد یا پیکربندی کنید.
  2. کلید را با استفاده از هدر X-Goog-Api-Key به سرور MCP ارسال کنید. شما باید این را به عنوان یک هدر HTTP سفارشی در پیکربندی ابزار MCP مربوط به LLM مشخص کنید.

احراز هویت با استفاده از OAuth

شما می‌توانید با استفاده از OAuth و با ایجاد اعتبارنامه‌های OAuth و ارسال آنها به میزبان MCP یا برنامه سرور MCP، احراز هویت کنید.

برای احراز هویت با استفاده از OAuth:

  1. در کنسول گوگل کلود ، پروژه‌ای را که می‌خواهید برای Grounding Lite استفاده کنید، انتخاب کنید.
  2. در منوی API & Services ، گزینه Credentials را انتخاب کنید.
  3. در منوی بالا، گزینه‌ی «ایجاد اعتبارنامه‌ها» > «شناسه‌ی کلاینت OAuth» را انتخاب کنید.
  4. اگر پروژه صفحه رضایت پیکربندی‌شده ندارد، روی پیکربندی صفحه رضایت کلیک کنید و دستورالعمل‌های روی صفحه را دنبال کنید.
  5. در بخش معیارها ، روی ایجاد کلاینت OAuth کلیک کنید.
  6. در صفحه ایجاد شناسه کلاینت OAuth ، نوع برنامه را انتخاب کرده و نامی برای شناسه کلاینت وارد کنید.
  7. جزئیات اضافی مرتبط با نوع برنامه خود را مشخص کنید. برای مثال، اگر در حال ایجاد یک برنامه وب هستید، URI های مجاز برای درخواست های مرورگر و سرور را اضافه کنید.
  8. پس از ایجاد کلاینت، شناسه و رمز کلاینت را ذخیره کنید.
  9. هنگام پیکربندی میزبان MCP یا برنامه سرور MCP خود برای دسترسی به Grounding Lite، شناسه و رمز کلاینت OAuth خود را وارد کنید.

برای اطلاعات بیشتر، به استفاده از OAuth 2.0 برای دسترسی به API های گوگل مراجعه کنید.

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

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

برای اطلاعات بیشتر، به پیکربندی 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، از فرم‌های زیر استفاده کنید: