Grounding Lite

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

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

الأدوات

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

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

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

  ملاحظة: لا يوفّر Grounding Lite معلومات مفصّلة حول المسارات أو الاتجاهات أو حركة المرور في الوقت الفعلي أو التنقّل

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

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

لا يتم تحصيل أي رسوم مقابل استخدام 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

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

• يجب الإشارة إلى أنّ مصدر كل معلومة هو "خرائط Google"، وذلك باتّباع إرشادات الإشارة إلى المصدر في Grounding Lite.
• عرض عنوان صفحة المصدر من البيانات الوصفية Open Graph og:title من googleMapsLinks المقدَّمة في الردّ
• يمكنك الانتقال إلى المستند المصدر باستخدام places.googleMapsLinks.placeUrl من الردّ.

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

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

إنشاء مفتاح واجهة برمجة تطبيقات أو ضبطه

يمكنك استخدام مفتاح واجهة برمجة تطبيقات حالي مع Maps Grounding Lite أو إنشاء مفتاح جديد، شرط تفعيل خدمة Maps Grounding Lite API على المفتاح. لا تفرض واجهة برمجة التطبيقات Maps Grounding Lite أي رسوم خلال الفترة التجريبية، ولكن يجب تفعيل الفوترة في المشروع.

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

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
   

5. اتّبِع الخطوات الواردة في بدء استخدام "منصة خرائط Google" لإنشاء مفتاح لواجهة برمجة التطبيقات أو ضبطه.

ملاحظة: عند إنشاء مفتاح واجهة برمجة تطبيقات أو إعداده، احرص على الحدّ من استخدام المفتاح من خلال تطبيق القيود المناسبة. لمزيد من المعلومات، يُرجى الاطّلاع على تقييد استخدام مفاتيح واجهة برمجة التطبيقات.

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

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

بعد الحصول على مفتاح API مع تفعيل خدمة Maps Grounding Lite API، يمكنك إعداد النماذج اللغوية الكبيرة للوصول إلى خادم MCP باتّباع مستندات إعداد MCP ذات الصلة واستخدام عنوان URL لخادم Grounding Lite MCP: https://mapstools.googleapis.com/mcp

إعداد 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" باستخدام واجهة سطر الأوامر. على سبيل المثال، جرِّب قول "اقترح عليّ بعض المطاعم في Mountain View"، ما سيؤدي إلى استدعاء أداة search_places نيابةً عنك.

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

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

• الإبلاغ عن خطأ
• إرسال طلب للحصول على ميزة
• تقديم ملاحظات