يسرد هذا المستند المتطلبات الخاصة بجميع التطبيقات التي تم تطويرها باستخدام "حزمة تطوير البرامج للأماكن" لنظام التشغيل iOS، بما في ذلك خدمة "الإكمال التلقائي" للأماكن التي تشكّل جزءًا من واجهة برمجة التطبيقات هذه. يمكن العثور على مزيد من المعلومات العامة لمطوِّري "خرائط Google" في بنود خدمة "منصة خرائط Google".
تقديم بنود الاستخدام وسياسة الخصوصية
إذا طوّرت حزمة تطوير برامج الأماكن لأجهزة iOS، عليك إتاحة بنود الاستخدام وسياسة الخصوصية في تطبيقك بما يتوافق مع الإرشادات الموضّحة في اتفاقيتك مع Google:
- يجب أن تكون بنود الاستخدام وسياسة الخصوصية متاحة للجميع.
- يجب أن تذكر صراحةً في بنود الاستخدام الخاصة بتطبيقك أنّه عند استخدام تطبيقك، يلتزم المستخدمون ببنود خدمة Google.
- يجب إعلام المستخدمين في سياسة الخصوصية بأنّك تستخدم واجهات Google Maps API وتدمجها سياسة خصوصية Google كمرجع.
يعتمد المكان المقترَح لتوفير بنود الاستخدام وسياسة الخصوصية على النظام الأساسي للتطبيق.
تطبيقات الأجهزة الجوّالة
عند تطوير تطبيق للأجهزة الجوّالة، ننصحك بتقديم رابط يؤدي إلى بنود الاستخدام وسياسة الخصوصية على صفحة تنزيل التطبيق في متجر التطبيقات ذي الصلة وفي قائمة إعدادات التطبيق.
تطبيقات الويب
في حال تطوير تطبيق ويب، ننصحك بتقديم رابط يؤدي إلى بنود الاستخدام وسياسة الخصوصية في تذييل موقعك الإلكتروني.
الجلب المسبق أو التخزين المؤقت أو التخزين للمحتوى
تخضع التطبيقات التي تستخدم حزمة تطوير برامج الأماكن لأجهزة iOS لبنود الاتفاقية المبرمة مع Google. ووفقًا لبنود هذه الاتفاقية، يجب عدم جلب أي محتوى مسبقًا أو فهرسته أو تخزينه أو تخزينه مؤقتًا إلا بموجب الشروط المحدودة المنصوص عليها في البنود.
يُرجى العِلم أنّ رقم تعريف المكان المستخدَم لتحديد مكان بشكل فريد معفي من قيود التخزين المؤقت. يتم عرض رقم تعريف المكان في الحقل "place_id" في حزمة تطوير البرامج (SDK) للأماكن لردود نظام التشغيل iOS. اطّلِع على كيفية حفظ أرقام تعريف الأماكن وإعادة تحميلها وإدارتها في دليل أرقام تعريف الأماكن.
عرض نتائج حزمة تطوير البرامج (SDK) للأماكن لتطبيقات iOS
يمكنك عرض نتائج حزمة تطوير برامج الأماكن لنظام التشغيل iOS على خريطة Google أو بدون خريطة. إذا كنت تريد عرض نتائج "حزمة تطوير البرامج بالاستناد إلى الأماكن" لتطبيقات iOS على خريطة ما، يجب عرض هذه النتائج على "خرائط Google". يُحظر استخدام حزمة تطوير برامج الأماكن لبيانات iOS على خريطة ليست من خرائط Google.
عرض شعار Google ومصادرها
إذا كان تطبيقك يعرض بيانات على إحدى "خرائط Google"، سيتم تضمين شعار Google ولا يجوز تغييره. ولا يُشترَط على التطبيقات التي تعرض بيانات المستخدم على Google على الشاشة نفسها مثل "خرائط Google" نسب المعلومات إلى Google بشكل إضافي.
إذا كان تطبيقك يعرض بيانات على صفحة أو طريقة عرض لا تعرض أيضًا "خرائط Google"، يجب إظهار شعار Google مع هذه البيانات. على سبيل المثال، إذا كان تطبيقك يعرض بيانات المستخدم على Google في علامة تبويب واحدة، وخريطة من "خرائط Google" تتضمّن هذه البيانات في علامة تبويب أخرى، يجب أن تعرض علامة التبويب الأولى شعار Google. إذا كان تطبيقك يستخدم حقول البحث مع ميزة الإكمال التلقائي أو بدونها، يجب عرض الشعار بشكل مضمّن.
يجب وضع شعار Google أسفل الزاوية اليسرى من الخريطة، مع وضع معلومات الإسناد في أسفل الزاوية اليسرى، وكلاهما يجب أن يكون على الخريطة ككل، وليس أسفل الخريطة أو مكان آخر داخل التطبيق. يعرض مثال الخريطة التالي شعار Google في الجزء السفلي الأيسر من الخريطة، والإسناد في أسفل اليسار.
![تحديد مصدر السياسة](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/policies_attribution_placement.png?authuser=7&hl=ar)
للاستخدام على خلفية فاتحة | للاستخدام على خلفية داكنة |
---|---|
![]() |
![]() |
يحتوي ملف ZIP التالي على شعار Google بالأحجام الصحيحة لتطبيقات أجهزة الكمبيوتر المكتبي وAndroid وiOS. لا يمكنك تغيير حجم هذه الشعارات أو تعديلها بأي شكل من الأشكال.
لتنزيل الملف: google_logo.zip
لا تعدِّل الإحالة. احرص على عدم إزالة معلومات الإحالة أو حجبها أو اقتصاصها. ولا يمكنك استخدام شعارات Google مضمّنة (على سبيل المثال، "هذه الخرائط مأخوذة من [Google_logo]").
إبقاء الإحالة قريبة: في حال استخدام لقطات شاشة من صور Google في عمليات تضمين مباشرة، احرص على تضمين السمة العادية كما يظهر في الصورة. وإذا لزم الأمر، يمكنك تخصيص نمط وموضع نص الإحالة، شرط أن يكون النص على مقربة من المحتوى وأن يكون مقروءًا للمشاهد أو القارئ العادي. لا يجوز لك نقل النَسب بعيدًا عن المحتوى، كنهاية الكتاب مثلاً أو إلى الجزء الذي تمت فيه إضافة النسب إلى العرض أو إلى تذييل موقعك الإلكتروني.
تضمين مزوِّدي البيانات التابعين لجهات خارجية: نحصل على بعض البيانات والصور في منتجات الخرائط من مقدّمي خدمات غير Google. في حال استخدام هذه الصور، يجب أن يشير نص الإحالة إلى الاسم "Google" ومقدّمي البيانات المعنيين، مثل "بيانات الخرائط: Google, Maxar Technologies". في حال ذكر بعض مزوّدي بيانات الجهات الخارجية في الصور، لا يتم تحديد المصدر بشكل صحيح عند تضمين "Google" أو شعار Google فقط.
إذا كنت تستخدم "منصة خرائط Google" على جهاز حيث يكون عرض معلومات الإسناد غير عملي، يُرجى التواصل مع فريق مبيعات Google لمناقشة التراخيص المناسبة لحالة الاستخدام لديك.
متطلبات أخرى لتحديد المصدر
وتتضمّن الإشارات إلى مقدّمي الخدمات التابعين لجهات خارجية محتوى وروابط يجب عرضها للمستخدم بالتنسيق الذي تم تقديمها به. تنصح Google بأن يعرض تطبيقك هذه المعلومات أسفل تفاصيل المكان.
لا تتضمّن إحالات الطرف الثالث التي تعرضها واجهة برمجة التطبيقات الإحالة إلى Google. عليك تضمين هذه الإسناد بنفسك، كما هو موضّح في عرض شعار Google ومصادرها.
اتّبِع التعليمات التالية لاسترداد إحالات الطرف الثالث إلى مكان واحد أو مجموعة من الأماكن.
استرداد عمليات تحديد المصدر لمكان واحد
عند استرداد مكان من خلال الحصول على
مكان حسب رقم التعريف، يمكنك
استرداد سمات هذا المكان من
السمة attributions
على
GMSPlace
.
تتوفر السمة attributions
باعتبارها كائن NSAttributedString
.
استرداد عمليات تحديد المصدر لمجموعة من الأماكن
إذا كان تطبيقك يعرض معلومات تم الحصول عليها من خلال طلب
المكان الحالي للجهاز، يجب أن يعرض التطبيق
معلومات عن المكان المعروض من خلال جهات خارجية. يمكنك استرداد
معلومات تحديد المصدر لجميع الأماكن التي تم استردادها في الطلب،
من السمة attributions
على
GMSPlaceLikelihoodList
.
يتم توفير attributions
على أنّه عنصر NSAttributedString
، ويمكنك الوصول إليه وعرضه بالطريقة نفسها التي تستخدمها attributions
في مكان واحد على النحو الموضّح
أعلاه.
عرض المساهمين في صورة
إذا كان تطبيقك يعرض
الصور، عليك
عرض أيّ من 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 في CSS وHTML إذا لم تتمكن من استخدام شعار Google القابل للتنزيل.
المساحة الخالية
يجب أن تكون المساحة الخالية حول الشعار الكامل مساوية لارتفاع "G" في Google أو أكبر منه.
يجب أن تكون المسافة بين نسخة الإحالة وشعار Google نصف عرض "G".
![](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/policies_spacing.png?authuser=7&hl=ar)
الوضوح
يجب أن يكون سطر اسم المؤلف دائمًا واضحًا ومقروءًا وبالألوان المناسبة لخلفية معيّنة. احرص دائمًا على توفير تباين كافٍ لصيغة الشعار التي تختارها.
اللون
استخدِم نص Google Material Gray 700 على خلفية بيضاء أو فاتحة اللون تتراوح بين 0% و40% الحد الأقصى لدرجة اللون الأسود.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
في الخلفيات الداكنة، فوق التصوير الفوتوغرافي أو الأنماط غير المشغولة، استخدم نصًا أبيض لسطر الاسم والإحالة.
#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;