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

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

السياسات

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

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

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

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

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

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

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

• الحد الأدنى لارتفاع الشعار: 16dp
• الحد الأقصى لارتفاع الشعار: 19dp
• الحد الأدنى للمساحة البيضاء حول الشعار: 10dp على اليمين واليسار والأعلى، و5dp في الأسفل

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

إمكانية الوصول إلى الشعار

• حافظ على تباين مناسب بين الشعار والخلفية.
• أدرِج تصنيفًا لإمكانية الوصول يتضمّن النص خرائط Google.

معلومات تحديد المصدر النصية

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

• لا تُعدِّل النص خرائط Google بأي طريقة:
  
  • لا تُغيِّر حالة الأحرف في خرائط Google
  • لا تنقل خرائط Google إلى أسطر متعددة
  • لا تُترجِم خرائط Google إلى لغة أخرى.
  • امنع المتصفّحات من ترجمة خرائط Google باستخدام سمة HTML‏ translate="no".

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

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

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

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

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

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

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، يمكن أن يحتوي على أحد نوعَي معلومات تحديد المصدر:

• معلومات تحديد المصدر، وهي سلسلة معلومات تحديد مصدر يتم الوصول إليها من خلال 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" النتائج المحلية. تم استخدام عدة عوامل معًا للمساعدة في العثور على أفضل النتائج لما تبحث عنه. وتشمل هذه العوامل في المقام الأول مدى الصلة بموضوع البحث والمسافة عن موقعك الجغرافي ومدى شهرة المكان.

الزر 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" لغرض المعاملة السارية لهذا المستخدم النهائي فقط.