Grounding Lite

‫Google Maps Platform Grounding Lite هي خدمة تتوافق مع بروتوكول سياق النموذج (MCP) وتسهّل تحديد مصدر بيانات تطبيقات الذكاء الاصطناعي باستخدام بيانات جغرافية مكانية موثوقة من "خرائط Google". يوفّر خادم MCP أدوات تتيح للنماذج اللغوية الكبيرة الوصول إلى إمكانات خاصة بالأماكن والطقس والطرق. يمكنك تجربة Grounding Lite من خلال تفعيلها في أي أداة تتوافق مع خوادم MCP.

الأدوات

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

  • البحث عن أماكن: طلب معلومات عن أماكن والحصول على ملخّصات بيانات الأماكن من إنشاء الذكاء الاصطناعي، بالإضافة إلى أرقام تعريف الأماكن وإحداثيات خطوط الطول والعرض وروابط في "خرائط Google" لكل مكان مضمّن في الملخّص يمكنك استخدام معرّفات الأماكن وإحداثيات خطوط الطول والعرض التي تم إرجاعها مع واجهات برمجة تطبيقات أخرى من Google Maps Platform لعرض الأماكن على الخريطة.
  • البحث عن معلومات الطقس: يمكنك طلب معلومات عن الطقس والحصول على أحوال الطقس الحالية والتوقعات كل ساعة والتوقعات اليومية.

  • حساب المسارات: طلب معلومات حول مسارات القيادة أو المشي بين موقعَين جغرافيَين وعرض معلومات حول مسافة المسار ومدته.

يتيح تفعيل خادم Maps Grounding Lite MCP للنماذج اللغوية الكبيرة استدعاء الأدوات الجديدة التي يعرضها الخادم لعرض معلومات إضافية حول أنواع البيانات المذكورة أعلاه. مع أنّ النموذج اللغوي الكبير يمكنه استخدام هذه المعلومات الإضافية لفهم السياق، قد لا يتضمّن الرد الذي ينشئه النموذج في النهاية المعلومات نفسها التي يعرضها خادم MCP. عليك التأكّد من دقة الرد الذي تم إنشاؤه.

تجربة تطبيق Grounding Lite النموذجي (يفتح الرابط في علامة تبويب جديدة)

الفوترة والحصص

لا يتم تحصيل أي رسوم مقابل استخدام Grounding Lite أثناء الفترة التجريبية. ومع ذلك، تنطبق الحصص التالية على الأدوات التي توفّرها Grounding Lite:

  • البحث عن أماكن: 100 طلب بحث في الدقيقة الواحدة لكل مشروع ‫1,000 طلب في اليوم لكل مشروع
  • البحث عن حالة الطقس: 300 طلب في الدقيقة لكل مشروع
  • Compute Routes: 300 طلب في الدقيقة لكل مشروع

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

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

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

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

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

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

يتضمّن كل ردّ من Grounding Lite المصادر. عند عرض نتائج تستخدم أدوات توفّرها Grounding Lite، يجب تضمين مصادر "خرائط Google" المرتبطة بطريقة تستوفي المتطلبات التالية:

  • يجب أن تظهر مصادر "خرائط Google" مباشرةً بعد المحتوى الذي تم إنشاؤه والذي تتوافق معه المصادر. يُشار أيضًا إلى هذا المحتوى الذي تم إنشاؤه باسم الناتج المستند إلى بيانات واقعية.
  • يجب أن تكون مصادر "خرائط Google" قابلة للعرض من خلال تفاعل واحد من المستخدم.

مصادر أداة "البحث عن أماكن"

يوفّر الحقل places في أداة search_places مصادر تؤيّد summary. بالنسبة إلى places، يتم عرض البيانات الوصفية التالية:

  • place (اسم المرجع)
  • id
  • location
  • googleMapsLinks

بالنسبة إلى كل مكان، يجب إنشاء معاينة للرابط تستوفي المتطلبات التالية:

إعداد نماذج اللغات الكبيرة لاستخدام خادم MCP

لاستخدام Grounding Lite، يجب أولاً إنشاء مشروع على Google Cloud مع تفعيل خدمة واجهة برمجة التطبيقات Maps Grounding Lite، بالإضافة إلى مفتاح واجهة برمجة تطبيقات أو معرّف عميل OAuth. بعد ذلك، يمكنك ضبط نماذج اللغات الكبيرة للوصول إلى خادم MCP. يستخدم خادم Grounding Lite MCP بروتوكول HTTP القابل للبث.

فعِّل خدمة Maps Grounding Lite في مشروعك على Google Cloud

لتفعيل واجهة برمجة التطبيقات في مشروعك، اتّبِع الخطوات التالية:

  1. في Google Cloud Console، اختَر المشروع الذي تريد استخدامه في Grounding Lite.
  2. فعِّل الفوترة للمشروع في وحدة تحكّم Google Cloud.
  3. من شريط التنقّل العلوي، افتح نافذة Cloud Shell الطرفية.

  4. نفِّذ الأوامر التالية لتفعيل الخدمة ونقطة نهاية MCP:

    gcloud beta services enable mapstools.googleapis.com --project=PROJECT_ID
gcloud beta services mcp enable mapstools.googleapis.com --project=PROJECT_ID

المصادقة باستخدام مفتاح واجهة برمجة تطبيقات

يمكنك استخدام مفتاح API حالي مع Maps Grounding Lite أو إنشاء مفتاح جديد، شرط تفعيل خدمة Maps Grounding Lite API في كلّ من مشروع Google Cloud والمفتاح.

للمصادقة باستخدام مفتاح واجهة برمجة التطبيقات، اتّبِع الخطوات التالية:

  1. أنشئ مفتاح واجهة برمجة تطبيقات أو اضبطه باتّباع الخطوات الواردة في مقالة البدء باستخدام "منصة خرائط Google".
  2. مرِّر المفتاح إلى خادم MCP باستخدام العنوان X-Goog-Api-Key. يجب تحديد ذلك كعنوان HTTP مخصّص في إعدادات أداة MCP الخاصة بنموذج اللغة الكبير.

المصادقة باستخدام OAuth

يمكنك المصادقة باستخدام بروتوكول OAuth من خلال إنشاء بيانات اعتماد OAuth وتمريرها إلى مضيف MCP أو تطبيق خادم MCP.

للمصادقة باستخدام OAuth، اتّبِع الخطوات التالية:

  1. في Google Cloud Console، اختَر المشروع الذي تريد استخدامه في Grounding Lite.
  2. في قائمة واجهات برمجة التطبيقات والخدمات، اختَر بيانات الاعتماد.
  3. في القائمة العلوية، اختَر إنشاء بيانات اعتماد > معرّف عميل OAuth.
  4. إذا لم يكن المشروع يتضمّن شاشة موافقة تم ضبطها، انقر على ضبط شاشة الموافقة واتّبِع التعليمات الظاهرة على الشاشة.
  5. في قسم المقاييس، انقر على إنشاء عميل OAuth.
  6. في شاشة إنشاء معرّف عميل OAuth، اختَر نوع التطبيق وأدخِل اسمًا لمعرّف العميل.
  7. حدِّد التفاصيل الإضافية ذات الصلة بنوع طلبك. على سبيل المثال، إذا كنت بصدد إنشاء تطبيق ويب، أضِف معرّفات الموارد المنتظمة (URI) المصرّح بها لطلبات المتصفّح والخادم.
  8. بعد إنشاء العميل، احفظ معرّف العميل وسر العميل.
  9. عند ضبط مضيف MCP أو تطبيق خادم MCP للوصول إلى Grounding Lite، مرِّر معرّف عميل OAuth وسرّه.

لمزيد من المعلومات، يُرجى الاطّلاع على استخدام بروتوكول OAuth 2.0 للوصول إلى Google APIs.

ضبط النماذج اللغوية الكبيرة للوصول إلى خادم Grounding Lite MCP

بعد إنشاء مشروع على Google Cloud وتفعيل خدمة Maps Grounding Lite API والحصول على بيانات اعتماد صالحة، مثل مفتاح واجهة برمجة التطبيقات أو معرّف عميل OAuth وسرّه، يمكنك إعداد النماذج اللغوية الكبيرة للوصول إلى خادم MCP باتّباع مستندات إعداد MCP ذات الصلة واستخدام عنوان URL لخادم Grounding Lite MCP: https://mapstools.googleapis.com/mcp

لمزيد من المعلومات، يُرجى الاطّلاع على ضبط MCP في تطبيق AI.

إعداد Grounding Lite باستخدام Gemini CLI

يقدّم هذا القسم مثالاً على كيفية ضبط خادم Grounding Lite MCP باستخدام Gemini CLI. لمزيد من التفاصيل، يُرجى الاطّلاع على خوادم MCP مع واجهة سطر الأوامر Gemini.

  1. بعد تثبيت Gemini CLI، يمكنك استخدام الأمر add لإعداد خادم Maps Grounding Lite MCP:

    gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-grounding-lite-mcp https://mapstools.googleapis.com/mcp

    إذا تمّت عملية الإعداد بنجاح، من المفترض أن يظهر لك تأكيد بأنّه تمت إضافة الخادم إلى إعدادات المستخدم.

  2. للتحقّق من أنّ الخادم يعمل بشكل صحيح، شغِّل الأمر /mcp list:

    > /mcp list

Configured MCP servers:

maps-grounding-lite-mcp - Ready (3 tools)
Tools:
-   compute_routes
-   lookup_weather
-   search_places

  3. ابدأ بطرح أسئلة ذات صلة بـ "خرائط Google" باستخدام واجهة سطر الأوامر. على سبيل المثال، جرِّب قول "اقترح عليّ بعض المطاعم في ماونتن فيو"، ما سيؤدي إلى استدعاء أداة search_places نيابةً عنك.

مشاركة الملاحظات

لمشاركة ملاحظاتك حول Grounding Lite، استخدِم النماذج التالية: