سياسات حزمة تطوير برامج الأماكن لأجهزة Android

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

تقديم بنود الاستخدام وسياسة الخصوصية

إذا كنت تُطوّر حزمة SDK لتطبيق Places على Android، عليك توفير بنود الاستخدام و سياسة الخصوصية مع تطبيقك بما يتوافق مع الإرشادات الموضّحة في الاتفاقية المبرمة بينك وبين Google:

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

يعتمد المكان المُقترَح لتوفير بنود الاستخدام و سياسة الخصوصية على منصة تطبيقك.

تطبيقات الأجهزة الجوّالة

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

تطبيقات الويب

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

جلب المحتوى مسبقًا أو تخزينه أو الاحتفاظ به مؤقتًا في ذاكرة التخزين المؤقت

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

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

عرض نتائج حزمة تطوير برامج الأماكن لأجهزة Android

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

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

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

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

موضع تحديد المصدر في السياسة

يحتوي ملف zip التالي على شعار Google بالحجم الصحيح لتطبيقات أجهزة الكمبيوتر المكتبي وAndroid وiOS. ولا يجوز لك تغيير حجم هذه الشعارات أو تعديلها بأي شكل من الأشكال.

التنزيل: google_logo.zip

عدم تعديل عملية تحديد المصدر لا تزيل معلومات تحديد المصدر أو تحجبها أو تقتطعها. لا يمكنك استخدام شعارات Google مضمّنة (على سبيل المثال، "هذه الخرائط تابعة لـ [Google_logo]").

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

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

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

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

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

استرداد الإسنادات من مكان

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

تعرِض واجهة برمجة التطبيقات عنصرًا 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، يمكن أن يحتوي على أيّ من نوعَي الإحالات التاليَين:

للحصول على الإسنادات النصية لصورة، اتصل بالرقم 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 في CSS وHTML إذا لم تتمكّن من استخدام شعار Google القابل للتنزيل.

المساحة الخالية

يجب أن تكون المساحة الخالية حول الشعار المُقفَل مساوية لارتفاع حرف G في Google أو أكبر منه.

يجب أن تكون المساحة بين نص الإسناد وشعار Google نصف عرض حرف "G".

سهولة القراءة

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

اللون

استخدِم نصًا باللون Google Material Gray 700 على خلفية بيضاء أو فاتحة تستخدم نطاقًا من 0% إلى 40% من الحد الأقصى للون الأسود.

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

على الخلفيات الداكنة، وفوق الصور الفوتوغرافية أو الأنماط غير المعقدة، استخدِم نصًا أبيض للتوقيع و النسبة.

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

الخط

استخدِم خط Roboto.

مثال على ملف CSS

عند تطبيق ملف CSS التالي على النص "Google"، سيتم عرض "Google" باستخدام الخط واللون والتباعد المناسبين على خلفية بيضاء أو فاتحة.

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;