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

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

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

مجموعة أدوات 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) مستضاف. يبحث محرّك RAG في الإصدارات الحديثة من المستندات الرسمية والبرامج التعليمية وعيّنات الرموز البرمجية في "منصة خرائط Google"، ويعرض السياق ذي الصلة للنموذج اللغوي الكبير كي يتمكّن من إنشاء ردّ دقيق.

الفوترة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

للاطّلاع على تفاصيل أدوات 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، استخدِم النماذج التالية: