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

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

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

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

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

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

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

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

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

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

الجلب المسبق أو التخزين المؤقت أو التخزين للمحتوى

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

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

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

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

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

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

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

تحديد مصدر السياسة

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

تنزيل: google_logo.zip

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

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

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

عرض مراجعة

يمكن أن يحتوي عنصر 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;