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

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

السياسات

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

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

رقم تعريف المكان، الذي يُستخدم لتحديد مكان بشكلٍ فريد، مستثنى من قيد التخزين المؤقت. وبالتالي، يمكنك تخزين قيم أرقام تعريف الأماكن إلى أجل غير مسمّى. يتم عرض قيم أرقام تعريف الأماكن في الـ placeId حقل الـ ترميز جغرافي سمة في الردّ من Address Validation API.

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

يتضمّن هذا المنتج بنود خدمة مختلفة للعملاء الذين لديهم عنوان إرسال فواتير في الـ منطقة الاقتصادية الأوروبية (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 فقط تحديد مصدر مناسبًا.