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

عرض مصدر البيانات في "خرائط Google"
يجب اتّباع متطلبات تحديد المصدر في "خرائط Google" عند عرض المحتوى من واجهات Google Maps Platform API في تطبيقك أو موقعك الإلكتروني. لا تحتاج إلى إضافة مصدر إضافي إذا كان المحتوى معروضًا على "خريطة Google" حيث يظهر المصدر.
بيانات المصدر المضمّنة في "خرائط Google"
بالنسبة إلى بيانات المصدر في "خرائط Google" التي توفّرها "منصة خرائط Google" في واجهة المستخدم، مثل Places UI Kit:
- لا تزِل معلومات تحديد المصدر المضمّنة بغض النظر عن مكان عرضها. يجب عدم تعديل معلومات تحديد المصدر أو إخفاؤها أو حجبها، والتأكّد من أنّها ظاهرة بوضوح على الخلفية.
- يجب دائمًا التمييز بصريًا بين "محتوى منصة خرائط Google" والمحتوى الآخر باستخدام إشارات واجهة المستخدم، مثل الحدود أو لون الخلفية أو الظل أو المساحة البيضاء الكافية.
- عند إجراء تعديلات مرئية، يجب الالتزام بجميع متطلبات الإشارة إلى المصدر في "خرائط Google".
شعار "خرائط Google" وإحالة نصية
يجب أن يكون مصدر البيانات على شكل شعار "خرائط Google" كلما أمكن ذلك. في الحالات التي تكون فيها المساحة محدودة، يكون النص خرائط Google مقبولاً. يجب أن يكون واضحًا دائمًا للمستخدمين النهائيين المحتوى الذي توفّره "خرائط Google".

تحديد مصدر الشعار
اتّبِع هذه المتطلبات لاستخدام شعار "خرائط Google" في تطبيقك أو موقعك الإلكتروني.
تنزيل شعارات "خرائط Google"
استخدِم ملفات شعار "خرائط Google" الرسمية. نزِّل الشعارات أدناه واتّبِع الإرشادات الواردة في هذا القسم.
تنزيل مواد العرض الخاصة بالإحالة إلى المصدر في "خرائط Google"عند استخدام شعار "خرائط Google"، يُرجى اتّباع الإرشادات التالية.
- لا تعدّل الشعار بأي شكل من الأشكال.
- يجب الحفاظ على نسبة العرض إلى الارتفاع للشعار لتجنُّب تشوّهه.
- استخدِم الشعار المخطّط على خلفية متعددة التفاصيل، مثل خريطة أو صورة.
- استخدِم الشعار غير المحدّد بخطوط على خلفية بسيطة، مثل لون واحد أو تدرّج لوني خفيف.
مواصفات حجم الشعار
اتّبِع مواصفات الحجم التالية لشعار "خرائط Google":- الحدّ الأدنى لارتفاع الشعار: 16dp
- الحد الأقصى لارتفاع الشعار: 19dp
- الحد الأدنى للمساحة الخالية حول الشعار: 10 وحدات بكسل مستقلة عن الكثافة على اليمين واليسار والأعلى، و5 وحدات بكسل مستقلة عن الكثافة في الأسفل
لمعرفة المزيد عن وحدات البكسل المستقلة الكثافة، يمكنك الاطّلاع على كثافة البكسل على موقع Material Design الإلكتروني.

إمكانية الوصول إلى الشعار
اتّبِع متطلبات تسهيل الاستخدام التالية لشعار "خرائط Google":- الحفاظ على تباين يسهل الوصول إليه بين الشعار والخلفية
- أدرِج تصنيفًا مناسبًا لذوي الاحتياجات الخاصة مع النص خرائط 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 Maps Platform.
- تأكَّد من أنّ مصدر المحتوى يظهر دائمًا بشكل واضح ويمكن قراءته. يجب عدم إزالة الشارة أو إخفائها أو تعتيمها أو تعديلها أبدًا.
تعرض الأشكال التالية أمثلة على هذه المتطلبات المرئية.



مزودو بيانات الجهات الخارجية
تأتي بعض البيانات والصور في منتجات الخرائط من مقدّمي خدمات غير 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
على أحد نوعَي بيانات تحديد المصدر التاليَين:
- السمات، وهي سلسلة سمات يتم الوصول إليها من خلال
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 Maps Platform.
في الصورة السابقة، لا تزال قائمة العناوين على اليمين خاضعة للقيود المفروضة على محتوى "خرائط Google". بعد أن يختار المستخدم النهائي العنوان الذي يريده، لن يخضع هذا العنوان للقيود المفروضة على "محتوى خرائط Google" إلا لغرض المعاملة السارية التي يجريها المستخدم النهائي.