مجموعة أدوات Code Assist في "منصة خرائط Google" (تجريبية)

مجموعة أدوات Code Assist في "منصة خرائط Google" هي خادم يستند إلى "بروتوكول سياق النموذج" (MCP) ويحسّن الردود من النماذج اللغوية الكبيرة (LLM) المستخدَمة لتطوير التطبيقات باستخدام "منصة خرائط Google". وتعمل هذه الأداة من خلال ربط الردود بالمستندات الرسمية والمحدَّثة وعيّنات التعليمات البرمجية.

بما أنّ خادم MCP يصل إلى المحتوى عند توجيه طلب إلى النموذج، لا يقتصر سياق نموذج لغوي كبير بشأن "منصة خرائط Google" على البيانات المتاحة في تاريخ تدريب النموذج.

تشمل موارد "منصة خرائط Google" التي يمكن لخادم MCP الوصول إليها ما يلي:

  • مستندات "منصة خرائط Google"
  • بنود خدمة "منصة خرائط Google"
  • مركز الثقة في "منصة خرائط Google"
  • مستودعات الرموز البرمجية في مؤسسات GitHub الرسمية على "منصة خرائط Google"

الأدوات

توفّر ميزة Maps Code Assist أدوات تتيح للنماذج اللغوية الكبيرة الوصول إلى الإمكانات التالية:

  • retrieve-instructions: هي أداة مساعِدة يستخدمها العميل للحصول على تعليمات النظام المهمة حول أفضل طريقة لفهم نية المستخدم وصياغة طلبات فعّالة لأداة retrieve-google-maps-platform-docs.
  • retrieve-google-maps-platform-docs: الأداة الأساسية يأخذ طلب بحث بلغة طبيعية ويرسله إلى محرّك "التوليد المعزّز بالاسترجاع" (RAG) مستضاف. يبحث محرّك التوليد المعزّز بالاسترجاع في الإصدارات الجديدة من المستندات الرسمية والبرامج التعليمية وعيّنات الرموز البرمجية الخاصة بـ "منصة خرائط Google"، ويعرض السياق ذي الصلة للنموذج اللغوي الكبير كي يتمكّن من إنشاء ردّ دقيق.

الفوترة

لا يتم تحصيل أي رسوم مقابل استخدام Maps Code Assist أثناء مرحلته التجريبية.

السياسات وبنود الخدمة

تخضع Maps Code Assist لبنود خدمة "منصة خرائط Google"، بما في ذلك البنود الخاصة بهذه الخدمة. يصف هذا القسم متطلبات استخدام الخدمة الإضافية لـ Maps Code Assist، بما في ذلك النماذج اللغوية الكبيرة المتوافقة ومتطلبات الإسناد إلى المصدر.

متطلبات نماذج اللغات الكبيرة المتوافقة

لا يجوز لك استخدام Maps Code Assist إلا مع نموذج لغوي كبير متوافق مع بنود خدمة "منصة خرائط Google".

على سبيل المثال، أنت مسؤول عن ضمان عدم تخزين محتوى "خرائط Google" مؤقتًا أو تخزينه أو استخدامه لتحسين نموذج اللغة الكبير الذي تختار استخدامه. قبل استخدام Maps Code Assist، عليك مراجعة بنود الخدمة لأي نموذج تنوي استخدامه مع Maps Code Assist. يجب عدم استخدام Maps Code Assist مع أي نماذج تستخدم البيانات التي يتم إدخالها في النموذج لأي تدريب أو تحسين للنموذج. تقع على عاتقك مسؤولية التأكّد من أنّ استخدامك للنموذج يتوافق تمامًا مع القيود المفروضة على محتوى "خرائط Google" في بنود خدمة "منصة خرائط Google"، بما في ذلك البنود الخاصة بالخدمة.

متطلبات تحديد المصدر لمصادر "خرائط Google"

عند عرض النتائج التي تستخدم الأدوات التي يوفّرها Maps Code Assist، يجب تضمين مصادر "خرائط Google" ذات الصلة.

إعداد النماذج اللغوية الكبيرة للوصول إلى خادم MCP في Maps Code Assist

يمكنك ضبط نماذج LLM للوصول إلى خادم MCP باتّباع مستندات إعداد MCP المقابلة واستخدام نقطة نهاية خادم MCP في Code Assist: https://mapscodeassist.googleapis.com/mcp.

يستخدم خادم MCP في Maps Code Assist بروتوكول النقل Streamable HTTP. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ضبط بروتوكول MCP في تطبيق مستنِد إلى الذكاء الاصطناعي.

أمثلة على حالات الاستخدام

بعد ضبط الإعدادات، يمكنك طرح أسئلة على نموذجك اللغوي الكبير حول "منصة خرائط Google". إليك بعض الأمثلة على الطلبات:

  • "كيف يمكنني إضافة خريطة إلى تطبيق Android؟"
  • "ما هي أفضل طريقة للحصول على الموقع الجغرافي الحالي للمستخدم على خريطة في iOS؟"
  • "قدِّم مثالاً على استخدام خدمة الاتجاهات في واجهة برمجة تطبيقات JavaScript لخرائط Google".

الربط بخادم MCP الخاص بـ Developer Knowledge

خادم MCP الخاص بـ Developer Knowledge هو خادم MCP عن بُعد يبحث في المستندات الرسمية على مواقع Google الإلكترونية المخصّصة للمطوّرين، بما في ذلك "منصة خرائط Google" وFirebase وGoogle Cloud و Android، لكي يتمكّن مساعد الذكاء الاصطناعي من استناد إجاباته إلى المستندات الحالية. وتوفّر أدوات search_documents وget_documents وanswer_query التي تُكمّل أدوات Maps Code Assist بدلاً من استبدالها. Maps Code Assist is purpose-built for Google Maps Platform, so pairing the two is most useful when your project also uses other Google products.

لإضافته إلى تطبيق الذكاء الاصطناعي إلى جانب Maps Code Assist، اتّبِع الخطوات الواردة في مقالة ضبط بيئة التطوير المتكاملة أو وكيل الترميز واختَر العميل. لمساعدة مساعدك في تحديد وقت البحث في المستندات، يمكنك أيضًا تثبيت مهارة وكيل retrieving-developer-knowledge. بعد إعداد كلا الخادمَين، يمكنك طرح أسئلة حول منتجات متعددة، مثل:

  • "ابحث عن تنسيق طلب الإكمال التلقائي في Places API (الإصدار الجديد) ومستندات وظائف Firebase السحابية، ثم اكتب دالة قابلة للاستدعاء تعمل كوكيل لطلبات الإكمال التلقائي باستخدام مفتاح واجهة برمجة التطبيقات المقيّد الخاص بي".

الأدوات المتاحة

للاطّلاع على تفاصيل أدوات MCP المتاحة وأوصافها لخادم MCP الخاص بـ Maps Code Assist، يُرجى مراجعة مرجع MCP الخاص بـ Maps Code Assist.

عرض قائمة بالأدوات من خلال طلب HTTP

للتحقّق من أنّ الخادم يعمل والاطّلاع على قائمة بالأدوات المتاحة، يمكنك إرسال طلب HTTP من نوع tools/list مباشرةً إلى خادم MCP البعيد الخاص بـ Maps Code Assist. لا تتطلّب طريقة 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، استخدِم النماذج التالية: