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

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

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

منابع «پلاتفرم Google Maps» که سرور MCP می‌تواند به آن‌ها دسترسی داشته باشد شامل این موارد است:

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

ابزارها

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

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

صورت‌حساب

استفاده از «دستیار کد Maps» تا زمانی که در مرحله «آزمایشی» است هزینه‌ای ندارد.

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

Maps Code Assist تابع شرایط خدمات پلاتفرم 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 مرتبط را اضافه کنید.

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

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

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

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

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

  • «چگونه به برنامه Android خودم نقشه اضافه کنم؟»
  • «بهترین روش برای دریافت مکان فعلی کاربر روی نقشه در iOS چیست؟»
  • "Provide an example of using the directions service in the Maps JavaScript API."

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

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

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

برای تأیید اینکه سرور کار می‌کند و دیدن فهرست ابزارهای دردسترس، می‌توانید درخواست اچ‌تی‌تی‌پی 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، از فرم‌های زیر استفاده کنید: