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

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

السياسات

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

استثناءات من القيود المفروضة على التخزين المؤقت

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

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

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

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

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

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

عرض مصدر البيانات في "خرائط Google"

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

بيانات المصدر المضمّنة في "خرائط Google"

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

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

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

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

بيانات تحديد مصدر الشعار

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

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

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

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

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

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

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

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

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

شعار "خرائط 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) يسهل الوصول إليها مقارنةً بالخلفية
    حجم الخط الحد الأدنى لحجم الخط: 12sp
    الحد الأقصى لحجم الخط: 16sp
    للتعرّف على sp، يمكنك الاطّلاع على وحدات حجم الخط على موقع التصميم المتعدد الأبعاد الإلكتروني.
    تباعُد الأحرف عادي

مثال على 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 Maps Platform.
  • تأكَّد من أنّ معلومات تحديد المصدر تظهر دائمًا بشكل واضح وقابل للقراءة. لا يجوز إزالة أو إخفاء أو تعتيم أو تعديل هذا الإشعار.

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

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

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

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

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

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

متطلبات أخرى لتحديد المصدر

متطلبات تحديد المصدر التالية خاصة بواجهة Places API.

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

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

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

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

إسناد إلى جهات خارجية

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

استرداد معلومات المصدر من "مكان"

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

يتم تمثيل بيانات المصدر في عنصر Place الخاص بالاستجابة باستخدام عنصر Attribution. لإضافة Attribution إلى الردّ، أدرِج places.attributions (بحث في الجوار وText Search) أو attributions (تفاصيل المكان) في قناع الحقل الخاص بالطلب.

حقول الكائن Attribution هي سلاسل تحتوي على provider وproviderUri الخاصين بالمصدر، أو سلسلة فارغة إذا لم تكن هناك مصادر لعرضها.

عرض معلومات المصدر لصورة

إذا كان تطبيقك يعرض صورًا، عليك عرض معلومات تحديد المصدر لكل صورة تتضمّن هذه المعلومات.

يتم تضمين تفاصيل حول الصورة في مصفوفة photos ضمن كائن Place في الرد. لإضافة مصفوفة photos إلى الردّ، أدرِج places.photos (بحث في الجوار والبحث النصي) أو photos (تفاصيل المكان) في قناع الحقل الخاص بالطلب.

كل عنصر من عناصر مصفوفة photos هو مثيل من Photo، ويحتوي على مصفوفة authorAttributions من النوع AuthorAttribution.

حقول الكائن AuthorAttribution هي سلاسل تحتوي على displayName وuri وphotoUri الخاصة ببيانات تحديد المصدر، أو سلسلة فارغة إذا لم تكن هناك أي بيانات تحديد مصدر لعرضها.

عرض مراجعة

يمكن أن يحتوي عنصر Place في الرد على ما يصل إلى خمس مراجعات. يمكنك عرض هذه المراجعات في تطبيقك إذا أردت ذلك.

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

عرض معلومات تحديد مصدر المؤلّف

تنصح Google أيضًا بعرض طريقة ترتيب المراجعات للمستخدم النهائي.

يتم تمثيل كل مراجعة في كائن Place ضمن استجابة باستخدام كائن Review. لإضافة العنصر Review إلى الردّ، أدرِج places.reviews (البحث في الأماكن القريبة والبحث النصي) أو reviews (تفاصيل المكان) في قناع الحقل الخاص بالطلب.

تحتوي حقول العنصر Review على معلومات تحديد المصدر، أو تكون فارغة إذا لم تكن هناك معلومات تحديد مصدر لعرضها.

سمات نتائج البحث

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

العنوان: حول هذه النتائج

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

الزر 1:مزيد من المعلومات
يجب أن يؤدي نص مزيد من المعلومات إلى مقالة في"مركز المساعدة".

الزر 2: حسنًا

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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