السياسات وبيانات المصدر الخاصة بواجهة Places API

يسرد هذا المستند المتطلبات الخاصة بجميع التطبيقات التي تم تطويرها باستخدام Places API (الإصدار الجديد)، بما في ذلك خدمة "الإكمال التلقائي" (الإصدار الجديد) التي تشكّل جزءًا من واجهة برمجة التطبيقات هذه. يمكن العثور على مزيد من المعلومات العامة لمطوّري "خرائط Google" في بنود خدمة "منصة خرائط Google".

السياسات

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

استثناءات من قيود التخزين المؤقت

يُرجى العِلم أنّ رقم تعريف المكان، الذي يُستخدَم لتحديد مكان بشكل فريد، مُعفى من قيود التخزين المؤقت. وبالتالي، يمكنك تخزين قيم أرقام تعريف الأماكن إلى أجل غير مسمى. يتم عرض رقم تعريف المكان في الحقل place_id في الردود من واجهة برمجة التطبيقات. تعرَّف على كيفية حفظ أرقام تعريف الأماكن وإعادة تحميلها وإدارتها في دليل أرقام تعريف الأماكن.

بلدان المنطقة الاقتصادية الأوروبية وأقاليمها

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

إذا لم يكن عنوان إرسال الفواتير في المنطقة الاقتصادية الأوروبية، تسري عليك بنود الخدمة التالية:

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

يقدّم هذا القسم متطلبات تحديد المصدر وإرشادات عرض "خرائط Google" والمحتوى من خلال تطبيقاتك.

عرض مصدر "خرائط Google"

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

تم تضمين مصدر "خرائط Google"

بالنسبة إلى مصدر "خرائط Google" الذي توفّره "منصة خرائط Google" في واجهة المستخدم، مثل حزمة أدوات "خرائط Google" الجاهزة للأماكن:

  • لا تُزِل مصدر البيانات المضمَّن بغض النظر عن مكان عرضه. لا تغيِّر مصدر البيانات أو تخفيه أو تحجبه، وتأكَّد من أنّه يظهر بوضوح على الخلفية.
  • احرص دائمًا على تمييز محتوى "منصة خرائط Google" بصريًا عن المحتوى الآخر باستخدام إشارات واجهة المستخدم، مثل الحدود أو لون الخلفية أو الظل أو المساحة الفارغة الكافية.
  • عند إجراء تعديلات مرئية، يجب الالتزام بجميع متطلبات الإسناد في "خرائط Google".

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

على اليمين: تحديد المصدر باستخدام شعار "خرائط Google"، على اليسار: تحديد المصدر باستخدام نص "خرائط Google"
على اليمين: مثال على نسب المحتوى إلى "خرائط Google" باستخدام الشعار، على اليسار: مثال على نسب المحتوى إلى "خرائط Google" باستخدام النص

مصدر الشعار

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

تنزيل شعارات "خرائط Google"

استخدِم ملفات شعار "خرائط Google" الرسمية. نزِّل الشعارات أدناه واتّبِع الإرشادات الواردة في هذا القسم.

تنزيل مواد عرض الإحالة في "خرائط Google"

عند استخدام شعار "خرائط Google"، يُرجى اتّباع الإرشادات التالية.

  • لا تعدِّل الشعار بأي شكل من الأشكال.
  • يجب الحفاظ على نسبة العرض إلى الارتفاع للشعار لتجنُّب تشويهه.
  • استخدِم الشعار المحدّد على خلفية مزدحمة، مثل خريطة أو صورة.
  • استخدِم الشعار غير المحدّد على خلفية عادية، مثل لون واحد أو تدرج خفيف.

مواصفات حجم الشعار

يُرجى اتّباع مواصفات الحجم التالية لشعار "خرائط Google":
  • الحدّ الأدنى لارتفاع الشعار: 16 بكسل مستقل الكثافة
  • الحد الأقصى لارتفاع الشعار: 19 بكسل مستقل الكثافة
  • الحد الأدنى للمساحة الخالية حول الشعار: 10 بكسل مستقل الكثافة على اليسار واليمين والأعلى، و5 بكسل مستقل الكثافة في الأسفل

لمزيد من المعلومات حول وحدات البكسل المستقلة عن الكثافة، يُرجى الاطّلاع على كثافة البكسل على موقع "التصميم المتعدد الأبعاد" الإلكتروني.

شعار "خرائط Google" يعرض الحد الأدنى للمساحة الفارغة ونطاق الحجم المقبول
مثال على شعار "خرائط Google" يعرض الحد الأدنى للمساحة الفارغة ونطاق الحجم المقبول

تسهيل استخدام الشعار

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

تحديد المصدر النصي

إذا كان حجم واجهتك لا يسمح باستخدام شعار "خرائط Google"، يمكنك كتابة عبارة خرائط Google كنص. اتبع الإرشادات التالية:

الصيغ المقبولة لتحديد المصدر باستخدام نص "خرائط Google"
أمثلة على الصيغ المقبولة لتحديد المصدر النصي في "خرائط Google"
  • لا تعدِّل النص خرائط Google بأي شكل من الأشكال:
    • لا تغيِّر حالة الأحرف في خرائط Google
    • عدم التفاف خرائط Google على أسطر متعددة
    • لا تترجم خرائط Google إلى لغة أخرى.
    • امنع المتصفّحات من ترجمة خرائط Google باستخدام سمة HTML‏ translate="no".
صيغ غير مقبولة من نص الإشارة إلى "خرائط Google"
أمثلة على الصيغ غير المقبولة لتحديد المصدر النصي في "خرائط Google"
  • يمكنك تنسيق نص "خرائط Google" كما هو موضّح في الجدول التالي:

    متطلبات تنسيق النص في "خرائط Google"
    الموقع النمط
    مجموعة الخطوط Roboto: تحميل الخط اختياري.
    مجموعة الخطوط الاحتياطية أي خط أساسي من نوع sans serif مستخدَم في منتجك أو "Sans-Serif" لاستدعاء خط النظام التلقائي
    شكل الخطّ عادي
    سُمك الخط 400
    لون الخط الأبيض أو الأسود (‎#1F1F1F) أو الرمادي (‎#5E5E5E). يجب الحفاظ على نسبة تباين (4.5:1) مع الخلفية لتسهيل الاستخدام.
    حجم الخط الحدّ الأدنى لحجم الخط: 12 بكسل مستقل عن الحجم
    الحدّ الأقصى لحجم الخط: 16 بكسل مستقل عن الحجم
    للتعرّف على البكسل المستقل عن الحجم، يُرجى الاطّلاع على وحدات حجم الخط على موقع Material Design الإلكتروني.
    تباعُد الأحرف عادي

مثال على خدمة CSS

يعرض رمز CSS التالي "خرائط Google" بنمط الطباعة واللون المناسبَين على خلفية بيضاء أو فاتحة.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

المتطلبات المرئية

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

  • يجب تمييز محتوى "منصة خرائط Google" بصريًا عن المحتوى الآخر باستخدام إشارات واجهة المستخدم، مثل الحدود أو لون الخلفية أو الظل أو المساحة الفارغة الكافية.

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

تعرض الأشكال التالية أمثلة على هذه المتطلبات المرئية.

مثال على مصدر "خرائط Google" في أعلى المحتوى وأسفله وإلى جانبه
مثال على نسب المحتوى إلى "خرائط Google" في أعلى المحتوى وأسفله وإلى جانبه

مثال على طريقتَين لتمييز محتوى "خرائط Google" (تقييم المكان) عن المحتوى الآخر
مثال على طريقتَين للتمييز بين محتوى "خرائط Google" (تقييم المكان) والمحتوى الآخر

لا تحجب مصدر "خرائط Google" أو تخلطه بمحتوى من مصادر أخرى
يجب عدم حجب نسب المحتوى إلى "خرائط Google" أو مزجه مع محتوى من مصادر أخرى

مزودو بيانات الجهات الخارجية

بعض البيانات والصور في منتجات الخرائط لدينا تأتي من مقدّمي خدمات غير Google. بالنسبة إلى بعض المنتجات، مثل Map Tiles API، قد نقدّم لك معلومات تحديد المصدر المطلوبة لمزوّد البيانات التابع لجهة خارجية. في هذه الحالة، يجب أن يتضمّن نص الإسناد اسم "خرائط Google" ومقدّمي البيانات ذوي الصلة، مثل "بيانات الخريطة: Google وMaxar Technologies". عندما تقدّم Google إسنادًا إلى جهة خارجية، لا يُعدّ تضمين "خرائط Google" أو شعار Google فقط إسنادًا مناسبًا.

متطلبات إضافية لواجهة Places API

تنطبق المتطلبات التالية على Places API تحديدًا.

الإكمال التلقائي لعناوين المستخدمين النهائيين

عندما يستخدم أحد المستخدمين النهائيين وظيفة "الإكمال التلقائي" ضمن "تطبيق العميل" للكتابة مسبقًا لعنوان شارع، وكان هذا المستخدم النهائي سيقدّم عنوان الشارع هذا بشكل كامل ودقيق بدون "الإكمال التلقائي"، لا يخضع العنوان الذي اختاره المستخدم النهائي لقيود محتوى "خرائط Google" في "اتفاقية منصة خرائط Google". ينطبق هذا الاستثناء فقط على عنوان الشارع الذي يختاره المستخدم النهائي وفقط على معاملة المستخدم النهائي المحددة، ولا ينطبق على قائمة العناوين المقترَحة التي توفّرها وظيفة "الإكمال التلقائي" أو على "محتوى خرائط Google" الآخر. لا ينطبق هذا الاستثناء على أي وظيفة بحث عن نقاط الاهتمام أو العناوين تقدّمها خدمات "منصة خرائط Google" الأخرى.

الإكمال التلقائي لعنوان المستخدم النهائي

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

صور وآراء

نسب كل المحتوى إلى مؤلفه

يجب دائمًا الإشارة إلى المؤلف عند عرض الصور أو المراجعات. تتضمّن كل صورة ومراجعة معلومات عن المؤلف (صورة رمزية للمؤلف واسمه ورابط ملفه الشخصي).

المتطلبات المرئية لتحديد مصدر المحتوى:

  • يجب الإشارة إلى المؤلف باستخدام جميع الموارد المتاحة (الأفاتار والاسم ورابط الملف الشخصي) عندما تسمح المساحة بذلك.
  • بالنسبة إلى المراجعات، إذا كانت المساحة محدودة، يكون الحد الأدنى من المتطلبات هو عرض الصورة الرمزية للمؤلف.
  • بالنسبة إلى الصور، إذا كانت المساحة محدودة (كما هو الحال في معرض الصور أو الصور المصغّرة)، يمكن حذف اسم المؤلف، شرط أن يتمكّن المستخدم من الوصول إلى نسخة أكبر من الصورة تتضمّن اسم المؤلف بالكامل.
  • ضع معلومات المؤلف بحيث تكون مرتبطة بوضوح بصورة المؤلف أو مراجعته.
تتم الإشارة إلى المؤلف في أعلى يمين الصورة والمراجعة
مثال على معلومات المؤلف المعروضة في أعلى يمين الصورة والمراجعة

توفير إمكانية الوصول المباشر إلى المحتوى المصدر على "خرائط Google"

بالنسبة إلى كل صورة ومراجعة، يجب أن يتمكّن المستخدمون النهائيون دائمًا من الاطّلاع على الصورة أو المراجعة المصدر الفردية على "خرائط Google" باستخدام googleMapsUri المقدَّم.

قائمة عمودية تتضمّن روابط لعرض الصورة المصدر أو المراجعة على "خرائط Google"
مثال على قائمة عمودية تتضمّن روابط لعرض الصورة المصدر أو المراجعة على "خرائط Google"

إنّ عرض تاريخ النشر النسبي (على سبيل المثال، "قبل يومَين") للصور والمراجعات باستخدام السمة relativePublishTimeDescription المقدَّمة يزيد من ثقة المستخدمين في المحتوى.

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

المراجعات

وصف كيفية ترتيب المراجعات وفلترتها

يجب تضمين إشعار واضح يصف كيفية ترتيب المراجعات وفلترتها، بما في ذلك أي معايير بحث مطبَّقة. يتم ترتيب المراجعات تلقائيًا حسب مدى صلتها بالموضوع.

إشعار يصف كيفية ترتيب المراجعات
مثال على إشعار يوضّح كيفية ترتيب المراجعات

عرض الشهر والسنة اللذين زار فيهما المراجعون أماكن في فرنسا

عند عرض مراجعات الأماكن في فرنسا والأقاليم الفرنسية، تعرض واجهة برمجة التطبيقات Places API visitDate (الشهر والسنة اللذين زار فيهما المؤلّف المكان)، ويجب عرضه بجانب المحتوى.

تاريخ الزيارة المعروض أسفل مراجعة المستخدم
مثال على تاريخ الزيارة المعروض أسفل مراجعة المستخدم

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

إشعار الترجمة المعروض أسفل مراجعة المستخدم
مثال على إشعار ترجمة يظهر أسفل مراجعة المستخدم

المراجعات ومتوسط التقييم

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

مثال على إشعار يصف سياسة المراجعة في Google
مثال على إشعار يصف سياسة المراجعات في Google

ملخّصات مستندة إلى الذكاء الاصطناعي

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

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

عرض نص الإفصاح عن الملخّصات المستندة إلى الذكاء الاصطناعي

عند عرض ملخّص من أي نوع مستنِد إلى الذكاء الاصطناعي، يجب دائمًا تضمين نص الإفصاح المترجَم (المتوفّر في الحقل disclosureText من نص الردّ) أسفل الملخّص مباشرةً. يجب عدم تعديل نص الإفصاح الذي توفّره واجهة برمجة التطبيقات أو الإضافة إليه.

الإفصاح عن جميع أنواع الملخّصات المستندة إلى الذكاء الاصطناعي
عرض نص الإفصاح بشكل صحيح أسفل كل نوع من أنواع الملخّصات الثلاثة المستندة إلى الذكاء الاصطناعي

متطلبات إضافية لملخّصات الأماكن والمناطق

ملخّصات الأماكن والمناطق المعروضة في تطبيقك يجب أن تكون مصحوبة بالنص التالي والروابط المطلوبة:

نص المتطلبات
لمحة عن هذا الملخّص استخدِم الرابط التالي للانتقال إلى مقالة "كيفية حصول Google على المعلومات في البيانات المحلية واستخدامها لها": https://support.google.com/local-listings/answer/9851099.
الإبلاغ عن ملخّص

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

ملاحظة: تخضع الملخّصات المستندة إلى الذكاء الاصطناعي المقدَّمة من خلال Places API (الإصدار الجديد) لسياسات المحتوى والمنتجات في Google أينما كنت في العالم. عليك إعلام المستخدمين النهائيين بأنّه إذا أرادوا الإبلاغ عن محتوى يجب إزالته من خدمات Google بموجب القوانين السارية، عليهم الإبلاغ عنه باستخدام عنوان URL المقدَّم للإبلاغ عن المحتوى (flagContentUri).

الإفصاح عن ملخّصات الأماكن والمناطق
ملخّص مستنِد إلى الذكاء الاصطناعي يظهر مع الروابط المرتبطة المطلوبة المتاحة للمستخدمين النهائيين من خلال قائمة الكاملة

متطلبات ملخّص المراجعات

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

نص المتطلبات
لمحة عن هذا الملخّص استخدِم الرابط التالي للانتقال إلى مقالة "كيفية حصول Google على المعلومات في البيانات المحلية واستخدامها لها": https://support.google.com/local-listings/answer/9851099
الإبلاغ عن ملخّص

استخدِم الرابط الوارد في الحقل flagContentUri ضمن بيانات الاستجابة.

ملاحظة: تخضع الملخّصات المستندة إلى الذكاء الاصطناعي المقدَّمة من خلال Places API (الإصدار الجديد) لسياسات المحتوى والمنتجات في Google أينما كنت في العالم. عليك إعلام المستخدمين النهائيين بأنّه إذا أرادوا الإبلاغ عن محتوى يجب إزالته من خدمات Google بموجب القوانين السارية، عليهم الإبلاغ عنه باستخدام عنوان URL المقدَّم للإبلاغ عن المحتوى (flagContentUri).

الاطلاع على التعليقات استخدِم الرابط الوارد في الحقل reviewSummary.reviewsUri ضمن بيانات الاستجابة.
الإفصاح عن ملخّصات المراجعات
ملخّص المراجعات المستنِد إلى الذكاء الاصطناعي مع الروابط المرتبطة المطلوبة المتاحة للمستخدمين النهائيين من خلال قائمة الكاملة

إرشادات العرض لحالات الاستخدام في السيارات

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

  • 3 أسطر كحدّ أقصى
  • ‫120 حرفًا أو 24 كلمة أو أقل
  • الحد الأدنى لحجم الخط هو 24 بكسل مستقل الكثافة

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

نتائج البحث عن الأماكن

ضمن تفاعل واحد مع المستخدم، يجب إعلام المستخدمين النهائيين بالعوامل الرئيسية ووزن العوامل الرئيسية التي تحدد ترتيب نتائج البحث.

عند استخدام ترتيب Google غير المعدَّل، يمكنك عرض النص التوضيحي التالي:

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

الإفصاح عن نتائج البحث عن الأماكن
مربّع حوار يوضّح كيف يحدّد محرّك بحث Google ترتيب نتائج البحث

الامتثال للقوانين السارية

عليك الالتزام بجميع القوانين السارية في جميع الأوقات. يُرجى العِلم أنّ الممارسات المصنّفة على أنّها (مُقترَحة) في هذه السياسات قد تظل إلزامية بموجب القانون. علاوة على ذلك، فإن اتباع جميع المتطلبات المذكورة والممارسات الموصى بها لا يضمن الامتثال القانوني الكامل في جميع الولايات القضائية. إذا كانت لديك أسئلة حول حالة الامتثال، عليك طلب الإرشادات من مستشارك القانوني.