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

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

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

منابع Google Maps Platform که سرور 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 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 مرتبط را اضافه کنید.

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

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

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

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

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

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

جفت کردن با سرور MCP «دانش توسعه‌دهنده»

سرور Developer Knowledge MCP یک سرور MCP راه دور است که اسناد رسمی را در سراسر سایت‌های توسعه‌دهنده Google، ازجمله Google Maps Platform،‏ Firebase،‏ Google Cloud، و Android جستجو می‌کند تا دستیار هوش مصنوعی شما بتواند پاسخ‌های خود را براساس اسناد فعلی ارائه دهد. این ابزار ابزارهای search_documents، get_documents، و answer_query را ارائه می‌دهد که مکمل ابزارهای Maps Code Assist هستند و جایگزین آن‌ها نمی‌شوند. Maps Code Assist به‌طور خاص برای «پلاتفرم Google Maps» ساخته شده است، بنابراین جفت کردن این دو زمانی مفیدتر است که پروژه شما از محصولات دیگر Google نیز استفاده کند.

برای افزودن آن به برنامه هوش مصنوعی خود در کنار Maps Code Assist، محیط توسعه یکپارچه یا عامل کدنویسی خود را پیکربندی کنید و مشتری خود را انتخاب کنید. برای کمک به دستیارتان در تصمیم‌گیری درباره زمان جستجوی اسناد، مهارت نماینده retrieving-developer-knowledge را نیز نصب کنید. با پیکربندی هر دو سرور، می‌توانید سؤالات بین‌محصولی بپرسید، مثلاً:

  • «Look up the Places API (New) autocomplete request format and the Cloud Functions for Firebase docs, then write a callable function that proxies autocomplete requests using my restricted API key.»

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

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