جعبه‌ابزار «دستیار کدنویسی پلاتفرم Google Maps» (آزمایشی)

جعبه‌ابزار Google Maps Platform Code Assist یک سرور «پروتکل بافتار مدل» (MCP) است که پاسخ‌های مدل‌های زبانی بزرگ (LLM) را که برای توسعه برنامه‌ها با Google Maps Platform استفاده می‌شوند بهبود می‌بخشد. این کار با پایه‌گذاری پاسخ‌ها در اسناد رسمی و به‌روز و نمونه‌های کد انجام می‌شود.

ازآنجایی‌که سرور MCP هنگام درخواست مدل به محتوا دسترسی پیدا می‌کند، بافت LLM دررابطه‌با Google Maps Platform نباید به داده‌های دردسترس در تاریخ آموزش مدل محدود شود.

منابع Google Maps Platform که سرور MCP می‌تواند به آن‌ها دسترسی داشته باشد عبارت‌اند از:

  • اسناد پلاتفرم Google Maps
  • شرایط خدمات Google Maps Platform
  • مرکز اعتماد «پلاتفرم Google Maps»
  • مخزن‌های کد در سازمان‌های رسمی GitHub در پلاتفرم Google Maps

ابزارها

Maps Code Assist ابزارهایی را ارائه می‌دهد که به مدل‌های زبانی بزرگ امکان می‌دهد به قابلیت‌های زیر دسترسی داشته باشند:

  • retrieve-instructions: ابزار کمکی که کارخواه از آن برای دریافت دستورالعمل‌های حیاتی سیستم درباره نحوه استدلال بهتر درباره قصد کاربر و فرموله کردن فراخوانی‌های مؤثر به ابزار retrieve-google-maps-platform-docs استفاده می‌کند.
  • retrieve-google-maps-platform-docs: ابزار اصلی. این برنامه پُرسمان زبان طبیعی را دریافت می‌کند و آن را به موتور «تولید با کمک بازیابی» (RAG) میزبانی‌شده ارسال می‌کند. موتور RAG نسخه‌های جدید اسناد رسمی، آموزش‌ها، و نمونه کدهای Google Maps Platform را جستجو می‌کند و بافت مربوطه را به مدل زبانی بزرگ برمی‌گرداند تا پاسخ دقیقی تولید کند.

صورت‌حساب

استفاده از Maps Code Assist در مرحله «آزمایشی» رایگان است.

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

«دستیار کد Maps» تابع شرایط خدمات پلاتفرم Google Maps، ازجمله شرایط مختص سرویس برای این سرویس است. این بخش الزامات تکمیلی استفاده از سرویس را برای Maps Code Assist، ازجمله مدل‌های زبانی بزرگ سازگار و الزامات ذکر منبع، شرح می‌دهد.

الزامات مدل‌های زبانی بزرگ سازگار

فقط می‌توانید از Maps Code Assist با مدل زبانی بزرگی استفاده کنید که با «شرایط خدمات پلاتفرم Google Maps» مطابقت داشته باشد.

برای مثال، شما مسئول هستید که مطمئن شوید «محتوای Google Maps» توسط مدل زبانی بزرگی که برای استفاده انتخاب می‌کنید ذخیره موقت، ذخیره، یا برای بهبود آن استفاده نمی‌شود. قبل‌از استفاده از Maps Code Assist، باید «شرایط خدمات» هر مدلی را که قصد دارید با Maps Code Assist استفاده کنید مرور کنید. نباید از Maps Code Assist با مدل‌هایی استفاده کنید که از داده‌های ورودی به مدل برای آموزش یا بهبود مدل استفاده می‌کنند. مسئولیت اطمینان از اینکه استفاده شما از مدل کاملاً با محدودیت‌های «محتوای Google Maps» در «شرایط خدمات Google Maps Platform»، ازجمله شرایط خاص سرویس، مطابقت دارد برعهده شما است.

الزامات ذکر منبع برای منابع Google Maps

هنگام ارائه نتایجی که از ابزارهای ارائه‌شده توسط Maps Code Assist استفاده می‌کنند، باید منابع Google Maps مرتبط را اضافه کنید.

پیکربندی مدل‌های زبانی بزرگ برای دسترسی به سرور MCP‏ Maps Code Assist

با دنبال کردن اسناد پیکربندی MCP مربوطه و استفاده از نقطه پایانی سرور Code Assist MCP، می‌توانید LLM را برای دسترسی به سرور MCP پیکربندی کنید: https://mapscodeassist.googleapis.com/mcp.

سرور MCP ‏Maps Code Assist از انتقال HTTP قابل‌جاری‌سازی استفاده می‌کند. برای اطلاعات بیشتر، پیکربندی MCP در برنامه هوش مصنوعی را ببینید.

نمونه موارد استفاده

پس‌از پیکربندی، می‌توانید از مدل زبانی بزرگ خود درباره Google Maps Platform سؤال بپرسید. چند پیام‌واره نمونه در اینجا آمده است:

  • «چگونه به برنامه Android خودم نقشه اضافه کنم؟»
  • «بهترین روش برای دریافت مکان فعلی کاربر روی نقشه در iOS چیست؟»
  • «نمونه‌ای از استفاده از سرویس مسیرها در Maps JavaScript API ارائه کن.»

ابزارهای دردسترس

برای مشاهده جزئیات ابزارهای MCP دردسترس و شرح آن‌ها برای سرور MCP «دستیار کد Maps»، به مرجع MCP «دستیار کد Maps» مراجعه کنید.

فهرست کردن ابزارها با درخواست اچ‌تی‌تی‌پی

برای تأیید اینکه سرور کار می‌کند و دیدن فهرست ابزارهای دردسترس، می‌توانید درخواست اچ‌تی‌تی‌پی tools/list را مستقیماً به سرور MCP راه دور «دستیار کد Maps» ارسال کنید. روش tools/list به اصالت‌سنجی نیاز ندارد.

curl -X POST https://mapscodeassist.googleapis.com/TOOLSET_ENDPOINT \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'MCP-Protocol-Version: MCP_PROTOCOL_VERSION' \
    -H 'Mcp-Method: tools/list' \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/list",
      "params": {
        "_meta": {
          "io.modelcontextprotocol/protocolVersion": "MCP_PROTOCOL_VERSION",
          "io.modelcontextprotocol/clientCapabilities": {
            "extensions": {
              "io.modelcontextprotocol/ui": {
                "mimeTypes": ["text/html;profile=mcp-app"]
              }
            }
          }
        }
      }
    }'

موارد زیر را جایگزین کنید:

  • ‫TOOLSET_ENDPOINT: باقی‌مانده نقطه پایان MCP بعداز نام سرویس. برای Maps Code Assist، این mcp است.
  • ‫MCP_PROTOCOL_VERSION: نسخه پروتکل MCP. برای مثال، 2026-07-28.

هم‌رسانی بازخورد

برای هم‌رسانی بازخورد درباره Maps Code Assist، از فرم‌های زیر استفاده کنید: