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

تدرج هذه المستندات متطلبات التطبيقات التي تم تطويرها باستخدام Places Aggregate API. يُرجى العِلم أنّ استخدام Places Aggregate API يخضع لـ اتفاقيتك مع Google.

السياسات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عند استخدام شعار "خرائط Google"، اتّبِع هذه الإرشادات.

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

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

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

للتعرّف على dp، يُرجى الاطّلاع على كثافة البكسل على موقع Material Design الإلكتروني.

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

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

يجب تحديد مصدر Google إذا كنت تستخدم محتوى "خرائط Google" من Places Aggregate API كمقياس مستقل في تطبيقك أو كإدخال في قيمك. يجب تحديد مصدر Google لمحتوى "خرائط Google" فقط، وليس لقيمك. تعني "قيمك" المحتوى الذي يتم إنشاؤه من خلال الجمع بين أعداد نقاط الاهتمام وبيانات الجهات الخارجية أو مقياس تنشئه باستخدام منطق المؤسسة الخاص، والذي يتم تحويله بشكلٍ كبير وفقًا لـ الأحكام الخاصة بخدمة "منصة خرائط Google" لـ Places Aggregate API.