السياسات وبيانات المصدر الخاصة بخدمة Geocoding API

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

السياسات

يوضّح هذا القسم السياسات ذات الصلة بـ Geocoding 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 باستخدام سمة 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".

عرض نص الإفصاح عن الملخّصات من إنشاء الذكاء الاصطناعي

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

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

متطلبات ملخّص الوصول

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

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

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

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

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

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

  • 3 أسطر كحدّ أقصى
  • 120 حرفًا أو 24 كلمة أو أقل
  • الحد الأدنى لحجم الخط: 24dp

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