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

السياسات وبيانات المصدر الخاصة بحزمة تطوير البرامج Places SDK لأجهزة Android

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

السياسات

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

تخزين البيانات والتخزين المؤقت واستخراج البيانات

عند استخدام محتوى "خرائط Google" في تطبيقك، يجب اتّباع متطلبات معالجة البيانات الواردة في الفقرة 3.2.3 من بنود خدمة "منصة خرائط Google" والبنود الخاصة بخدمة "منصة خرائط Google":

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

لتقليل وقت الاستجابة وتكاليف الفوترة بدون تخزين البيانات المحظورة مؤقتًا، استخدِم أقنعة الحقول أو قوائم الحقول لطلب الحقول التي تحتاجها واجهة المستخدم فقط. تخزين المعرّفات المستثناة، مثل رقم تعريف المكان، لجلب تفاصيل جديدة عندما يتفاعل المستخدم مع مكان معيّن

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

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

تمنح الأحكام الخاصة بخدمة "منصة خرائط Google" الاستثناءات المحدودة التالية للتخزين المؤقت:

أرقام تعريف الأماكن: رقم تعريف المكان، الذي يُستخدَم لتحديد مكان بشكل فريد، مُعفى من قيود التخزين المؤقت. وبالتالي، يمكنك تخزين قيم أرقام تعريف الأماكن إلى أجل غير مسمى. يتم عرض أرقام تعريف الأماكن في الحقل id أو place_id في الردود من واجهة برمجة التطبيقات. تعرَّف على كيفية حفظ أرقام تعريف الأماكن وإعادة تحميلها وإدارتها في دليل أرقام تعريف الأماكن.
إحداثيات خطوط العرض والطول: يمكنك تخزين قيم خطوط العرض (latitude) وخطوط الطول (longitude) مؤقتًا لمدة تصل إلى 30 يومًا تقويميًا متتاليًا، وبعد ذلك يجب حذف الإحداثيات المخزنة مؤقتًا، وذلك عند استخدام الخدمات التي تمنح هذا الاستثناء في البنود المحددة لخدمة "منصة خرائط Google":
- ‫Routes API وRoute Optimization API وDirections API (القديمة) وRoads API
- ‫Geocoding API وGeolocation API وAddress Validation API
- ‫Places API وحزمة أدوات "خرائط Google" الجاهزة للأماكن وحزمة تطوير البرامج (SDK) للتنقّل
فترات التخزين المؤقت الخاصة بالخدمة: تحدّد البنود الخاصة بخدمة "منصة خرائط Google" أيضًا فترات التخزين المؤقت الخاصة بالحقول والأغراض المسموح بها لكل من Address Validation API وAir Quality API وPollen API وSolar API وWeather API وPlaces Aggregate API.

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

يخضع هذا المنتج لبنود خدمة مختلفة للعملاء الذين لديهم عنوان إرسال فواتير في المنطقة الاقتصادية الأوروبية (EEA)، وقد يتضمّن أيضًا وظائف مختلفة. قبل إنشاء التطبيقات باستخدام "منصة خرائط 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"، اتّبِع الإرشادات التالية.

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

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

يُرجى اتّباع مواصفات الحجم التالية لشعار "خرائط Google":

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

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

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

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

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

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

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

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

تعرض واجهة برمجة التطبيقات عنصر Place. لاسترداد معلومات تحديد المصدر من العنصر Place، يمكنك استدعاء Place.getAttributions(). يعرض الإجراء List من عناصر String، أو قيمة فارغة في حال عدم توفّر أي معلومات مصدر لعرضها.

String placeId = "INSERT_PLACE_ID_HERE";
List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME);
FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
  Place place = response.getPlace();
  textView.append("Place found: " + place.getName());
  List<String> attributions = place.getAttributions();
  if (attributions != null) {
    StringBuilder stringBuilder = new StringBuilder("Attributions: ");
    for (String attribution : attributions) {
      stringBuilder.append(attribution).append("\n");
    }
    textView.append(stringBuilder.toString());
  }}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
      // Handle the error.
    }
  }
);

عرض معلومات ملكية صورة

إذا كان تطبيقك يعرض صور الأماكن، يجب عرض معلومات تحديد المصدر لكل صورة تتضمّنها. PhotoMetadata، يمكن أن يحتوي على أي من نوعَي الإحالات:

Attributions: سلسلة تحديد المصدر التي يتم الوصول إليها من خلال PhotoMetadata.getAttributions().
‫AuthorAttributions: هو عنصر AuthorAttributions يتم الوصول إليه من خلال PhotoMetadata.getAuthorAttributions().

للحصول على معلومات مصدر السلسلة لصورة معيّنة، يمكنك استدعاء PhotoMetadata.getAttributions(). تعرض الطريقة تسلسل أحرف HTML أو سلسلة فارغة في حال عدم توفّر أي معلومات مصدر لعرضها.

// Get the photo metadata from the Place object.
PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0);

// Get the attribution text.
String attributions = photoMetadata.getAttributions();

للحصول على معلومات تحديد المصدر لصورة معيّنة، يمكنك استدعاء PhotoMetadata.getAuthorAttributions(). تعرض الطريقة عنصر AuthorAttributions. يحتوي هذا العنصر على List من عناصر AuthorAttribution، واحد لكل مؤلف.

// Get the photo metadata from the Place object.
PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0);

// Get the author attributions object.
AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions();
List<AuthorAttribution> authorAttributionList = authorAttributions.asList();

نسب المحتوى إلى Google في نتائج البحث

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

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

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

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

الزر 2: حسنًا

عرض مراجعة

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

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

عرض معلومات المؤلف

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

للوصول إلى المراجعات، استخدِم Place.getReviews():

// Specify the fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.REVIEWS);

// Construct a request object, passing the place ID and fields array.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance("INSERT_PLACE_ID_HERE", placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
    Place place = response.getPlace();
    List<Review> reviews = place.getReviews();
    // For loop for iterating over the List
    for (int i = 0; i < reviews.size(); i++) {
      // For each review, get the Review object.
        Review placeReview = reviews.get(i);

      // Get any attribution and author attribution.
        String reviewAttribution = placeReview.getAttribution();
        AuthorAttribution authorAttribution = placeReview.getAuthorAttribution();

        // Display the review contents and attributions as necessary.
    }
}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
        // Handle the error.
    }
});

عرض معلومات تحديد المصدر التابعة لجهات خارجية

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

تنشئ واجهة برمجة التطبيقات معلومات المصدر لجميع الأماكن التي يستخدمها التطبيق، ويتم توفيرها لكل طلب بيانات من واجهة برمجة التطبيقات، وليس لكل مكان.

يمكن عرض معلومات تحديد المصدر باستخدام TextView. على سبيل المثال:

TextView attributionsText = (TextView) findViewById(R.id.attributions);
String thirdPartyAttributions = place.getAttributions();
attributionsText.setText(thirdPartyAttributions);

مثال على تحديد المصدر من خلال جهة خارجية

Listings by <a href="https://www.example.com/">Example Company</a>

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

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

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

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

السياسات وبيانات المصدر الخاصة بحزمة تطوير البرامج Places SDK لأجهزة Android تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.