يسرد هذا المستند المتطلبات الخاصة بجميع التطبيقات التي تم تطويرها باستخدام حزمة تطوير البرامج (SDK) للأماكن لنظام التشغيل iOS، بما في ذلك خدمة "الإكمال التلقائي للأماكن" التي تشكّل جزءًا من واجهة برمجة التطبيقات هذه. يمكن العثور على مزيد من المعلومات العامة لمطوّري "خرائط Google" في بنود خدمة "منصة خرائط Google".
السياسات
يصف هذا القسم السياسات ذات الصلة بحزمة "SDK للأماكن" لنظام التشغيل iOS. توفّر السياسات إرشادات ومتطلبات عملية للتنفيذ من أجل مساعدتك في استخدام "الخدمة" بشكل صحيح وبما يتوافق مع توقعات "منصة خرائط Google".
استثناءات من قيود التخزين المؤقت
يُرجى العِلم أنّ رقم تعريف المكان، الذي يُستخدَم لتحديد مكان بشكل فريد، مُعفى من قيود التخزين المؤقت.
وبالتالي، يمكنك تخزين قيم أرقام تعريف الأماكن إلى أجل غير مسمى.
يتم عرض رقم تعريف المكان في الحقل place_id في الردود من واجهة برمجة التطبيقات. تعرَّف على كيفية حفظ أرقام تعريف الأماكن وإعادة تحميلها وإدارتها في دليل أرقام تعريف الأماكن.
بلدان المنطقة الاقتصادية الأوروبية وأقاليمها
يخضع هذا المنتج لبنود خدمة مختلفة للعملاء الذين لديهم عنوان إرسال فواتير في المنطقة الاقتصادية الأوروبية، وقد يتضمّن أيضًا وظائف مختلفة. قبل إنشاء التطبيقات باستخدام "منصة خرائط 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 باستخدام سمة HTML
translate="no".
يمكنك تنسيق نص "خرائط 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. بالنسبة إلى بعض المنتجات، مثل Map Tiles API، قد نقدّم لك معلومات تحديد المصدر المطلوبة لمزوّد البيانات التابع لجهة خارجية. في هذه الحالة، يجب أن يتضمّن نص الإسناد اسم "خرائط Google" ومقدّمي البيانات ذوي الصلة، مثل "بيانات الخريطة: Google وMaxar Technologies". عندما تقدّم Google إسنادًا إلى جهة خارجية، لا يُعدّ تضمين "خرائط Google" أو شعار Google فقط إسنادًا مناسبًا.
متطلبات أخرى لتحديد المصدر
تحتوي الإسنادات إلى مقدّمي الخدمات الخارجيين على محتوى وروابط يجب عرضها للمستخدم بالتنسيق الذي يتم تقديمها به. تنصح Google بأن يعرض تطبيقك هذه المعلومات أسفل تفاصيل المكان.
لا تتضمّن معلومات المصدر التابعة لجهات خارجية التي تعرضها واجهة برمجة التطبيقات معلومات المصدر من Google. يجب تضمين هذه الإشارة بنفسك، كما هو موضّح في عرض شعار Google ومصادر البيانات.
اتّبِع هذه التعليمات لاسترداد معلومات المصدر التابعة لجهات خارجية لمكان واحد أو مجموعة من الأماكن.
استرداد معلومات المصدر لمكان واحد
عند استرداد مكان من خلال الحصول على مكان باستخدام رقم التعريف، يمكنك استرداد معلومات المصدر لذلك المكان من السمة attributions في GMSPlace.
يتم توفير attributions كعنصر NSAttributedString.
استرداد معلومات المصدر لمجموعة من الأماكن
إذا كان تطبيقك يعرض معلومات تم الحصول عليها من خلال طلب المكان الحالي للجهاز، يجب أن يعرض التطبيق معلومات المصدر التابعة لجهات خارجية لتفاصيل المكان المعروضة. يمكنك استرداد
المصادر لجميع الأماكن التي تم استردادها في الطلب، من
سمة attributions في
GMSPlaceLikelihoodList.
يتم توفير attributions كعنصر NSAttributedString، ويمكنك الوصول إليه وعرضه بالطريقة نفسها التي يتم بها عرض attributions في مكان واحد، كما هو موضّح أعلاه.
مصادر نتائج البحث
في أوروبا، عند استخدام ترتيب Google غير المعدَّل، يجب أن تتضمّن منتجات البحث نصًا توضيحيًا لا يبعد أكثر من نقرة واحدة يصف العوامل الرئيسية ووزن العوامل الرئيسية التي تحدّد ترتيب نتائج البحث. النص التوضيحي:
العنوان: لمحة عن هذه النتائج
النص: عندما تبحث عن مؤسسات أو أماكن بالقرب من موقع جغرافي معيّن، سيعرض لك تطبيق "خرائط Google" النتائج المحلية. وتم استخدام عدة عوامل معًا للمساعدة في العثور على أفضل النتائج لما تبحث عنه. وتشمل هذه العوامل في المقام الأول مدى الصلة بموضوع البحث والمسافة عن موقعك الجغرافي ومدى شهرة المكان.
الزر 1: مزيد من المعلومات
يجب أن يؤدي نص "مزيد من المعلومات" إلى مقالة في "مركز المساعدة".
الزر 2: حسنًا
عرض معلومات ملكية صورة
إذا كان تطبيقك يعرض
صورًا، يجب
عرض أي attributions وauthorAttributions لكل
صورة تحتوي عليهما.
- للوصول إلى أي نَسب، استخدِم
GMSPlacePhotoMetadata.attributions. هذه السمة هيNSAttributedStringأوnilفي حال عدم توفّر أي معلومات عن المصدر لعرضها. - للوصول إلى أيّ معلومات عن المؤلفين، استخدِم
GMSPlacePhotoMetadata.authorAttributions. تحتوي هذه السمة على مصفوفة من عناصرGMSPlaceAuthorAttribution.
Swift
GMSPlacesClient.sharedClient().lookUpPhotosForPlaceID(placeID) { (photos, error) -> Void in if let error = error { // TODO: handle the error. print("Error: \(error.description)") } else { // Get attribution for the first photo in the list. if let photo = photos?.results.first { let attributions = photo.attributions } } }
Objective-C
[[GMSPlacesClient sharedClient] lookUpPhotosForPlaceID:placeID callback:^(GMSPlacePhotoMetadataList *_Nullable photos, NSError *_Nullable error) { if (error) { // TODO: handle the error. NSLog(@"Error: %@", [error description]); } else { // Get attribution for the first photo in the list. if (photos.results.count > 0) { GMSPlacePhotoMetadata *photo = photos.results.firstObject; NSAttributedString *attributions = photo.attributions; } } }];
عرض مراجعة
يمكن أن يحتوي عنصر GMSPlace على ما يصل إلى خمس مراجعات، حيث يتم تمثيل كل مراجعة بعنصر GMSPlaceReview. يمكنك اختياريًا عرض هذه المراجعات في تطبيقك.
عند عرض المراجعات التي ساهم بها مستخدمو Google، يجب وضع اسم المؤلف على مقربة منها. عندما يكون حقل تحديد هوية المؤلف متاحًا في عنصر GMSPlaceReview، ننصحك بتضمين صورة المؤلف ورابط يؤدي إلى ملفه الشخصي أيضًا. تعرض الصورة التالية مثالاً
لمراجعة حديقة:
تنصح Google أيضًا بعرض كيفية ترتيب المراجعات للمستخدم النهائي.
للوصول إلى المراجعات:
Swift
// Define a Place ID. let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs" // Specify the place data types to return. let myProperties: [GMSPlaceProperty] = [.name, .website, .reviews] // Create the GMSFetchPlaceRequest object. let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties) client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: { (place: GMSPlace?, error: Error?) in if let error = error { print("An error occurred: \(error.localizedDescription)") return } if let place = place { let firstReview: GMSPlaceReview = place.reviews![0] // Use firstReview to access review text, authorAttribution, and other fields. } })
Objective-C
// Define a Place ID. NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs"; // Specify the place data types to return, including reviews. NSArray<GMSPlaceProperty *> *myProperties = @[GMSPlacePropertyName, GMSPlacePropertyWebsite,GMSPlacePropertyReviews]; GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: myProperties]; [placesClient fetchPlaceWithRequest: fetchPlaceRequest, callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) { if (error) { // TODO: handle the error. NSLog(@"Error: %@", [error description]); } else { // Get first review. GMSPlaceReview *firstReview = [place reviews][0]; // Use firstReview to access review text, authorAttribution, and other fields. } }];
عرض نصوص تحديد المصدر التابعة لجهات خارجية
يتم تقديم معلومات تحديد المصدر لمقدّمي الخدمات التابعين لجهات خارجية كعناصر NSAttributedString تحتوي على محتوى وروابط يجب الاحتفاظ بها وعرضها للمستخدم.
الطريقة المقترَحة لعرض معلومات المساهمين هي باستخدام UITextView، لأنّ الروابط في معلومات المساهمين يجب أن تعمل.
لضمان عمل الروابط، يجب ضبط مفوَّض على UITextView وضبط طريقة shouldInteractWithURL في UITextViewDelegate لعرض YES.
Swift
... self.attributionTextView.delegate = self ... // MARK: - UITextViewDelegate func textView(textView: UITextView, shouldInteractWithURL URL: NSURL, inRange characterRange: NSRange) -> Bool { // Make links clickable. return true }
Objective-C
... self.attributionTextView.delegate = self; ... #pragma mark - UITextViewDelegate - (BOOL)textView:(UITextView *)textView shouldInteractWithURL:(NSURL *)url inRange:(NSRange)characterRange { // Make links clickable. return YES; }
مثال على تحديد المصدر من خلال جهة خارجية
يتكوّن عادةً مصدر البيانات التابع لجهة خارجية من نص يتضمّن رابطًا. على سبيل المثال:
قوائم من Example Company
في المثال أعلاه، يغطي نطاق النص Example Company سمة NSLink.
الإكمال التلقائي لعناوين المستخدمين النهائيين
عندما يستخدم أحد المستخدمين النهائيين وظيفة "الإكمال التلقائي" ضمن "تطبيق العميل" للكتابة مسبقًا لعنوان شارع، وكان هذا المستخدم النهائي سيقدّم عنوان الشارع هذا بشكل كامل ودقيق بدون "الإكمال التلقائي"، لا يخضع العنوان الذي اختاره المستخدم النهائي لقيود محتوى "خرائط Google" في "اتفاقية منصة خرائط Google". ينطبق هذا الاستثناء فقط على عنوان الشارع الذي يختاره المستخدم النهائي وفقط على معاملة المستخدم النهائي المحددة، ولا ينطبق على قائمة العناوين المقترَحة التي توفّرها وظيفة "الإكمال التلقائي" أو على "محتوى خرائط Google" الآخر. لا ينطبق هذا الاستثناء على أي وظيفة بحث عن نقاط الاهتمام أو العناوين تقدّمها خدمات "منصة خرائط Google" الأخرى.
في الصورة السابقة، لا تزال قائمة العناوين على اليمين خاضعة للقيود المفروضة على محتوى "خرائط Google". بعد أن يختار المستخدم النهائي العنوان الذي يريده، لا يخضع هذا العنوان للقيود المفروضة على "محتوى خرائط Google"، وذلك فقط لغرض المعاملة السارية التي يجريها هذا المستخدم النهائي.