يسرد هذا المستند المتطلبات الخاصة بجميع التطبيقات. التي تم تطويرها باستخدام حزمة تطوير برامج الأماكن لأجهزة iOS، بما في ذلك ميزة الإكمال التلقائي للأماكن التي تشكل جزءًا من واجهة برمجة التطبيقات هذه. مزيد من المعلومات العامة عن "خرائط Google" مطوري البرامج في بنود خدمة Google Maps Platform
تقديم بنود الاستخدام وسياسة الخصوصية
إذا كنت قد طورت حزمة تطوير برامج الأماكن لأجهزة iOS، فيجب عليك إتاحة البنود للاستخدام الخصوصية السياسة المتَّبعة في تطبيقك على أن يتوافق مع الإرشادات الموضحة في اتفاقيتك مع Google:
- يجب أن تكون بنود الاستخدام وسياسة الخصوصية علنية. المتوفرة.
- يجب أن تذكر صراحةً في بنود الاستخدام الخاصة بتطبيقك ما يلي: باستخدام تطبيقك، يضمن المستخدمون بنود خدمة Google الخدمة.
- عليك إعلام المستخدمين في سياسة الخصوصية التي تستخدمها. واجهات برمجة التطبيقات لخرائط Google ودمجها بالإشارة إلى سياسة خصوصية Google:
المكان المقترَح لإتاحة بنود الاستخدام تعتمد سياسة الخصوصية على النظام الأساسي لتطبيقك.
تطبيقات الأجهزة الجوّالة
في حال تطوير تطبيق للأجهزة الجوّالة، ننصحك بتقديم رابط بنود الاستخدام وسياسة الخصوصية في صفحة التنزيل في متجر التطبيقات ذي الصلة وفي إعدادات التطبيق القائمة.
تطبيقات الويب
في حال تطوير تطبيق ويب، ننصحك بتقديم رابط إلى بنود الاستخدام وسياسة الخصوصية في تذييل موقعك الإلكتروني.
الجلب المسبق أو التخزين المؤقت أو التخزين للمحتوى
وتجدر الإشارة إلى أن التطبيقات التي تستخدم حِزمة تطوير البرامج (SDK) للأماكن لنظام التشغيل iOS تخضع لبنود الاتفاقية مع Google. وفقًا لبنود "الاتفاقية"، يجب عدم لجلب أي محتوى مسبقًا أو فهرسته أو تخزينه أو تخزينه مؤقتًا، ما لم يكن ضمن والشروط المنصوص عليها في البنود.
تجدر الإشارة إلى أنّ رقم تعريف المكان المستخدَم لتحديد مكان بشكلٍ فريد هو من قيود التخزين المؤقت. يتم عرض رقم تعريف المكان في الحقل "place_id" في حزمة تطوير برامج الأماكن للردود على أجهزة iOS. اطّلِع على كيفية حفظ أرقام تعريف الأماكن وإعادة تحميلها وإدارتها في دليل أرقام تعريف الأماكن.
عرض نتائج حزمة تطوير البرامج (SDK) للأماكن لتطبيقات iOS
يمكنك عرض نتائج حزمة تطوير برامج الأماكن لنظام التشغيل iOS على خريطة Google أو بدون خريطة. إذا كنت ترغب في عرض نتائج حزمة تطوير برامج الأماكن لأجهزة iOS على الخريطة، فينبغي عندئذٍ عرض هذه النتائج على خريطة Google. يُحظر استخدام حزمة تطوير برامج الأماكن لبيانات iOS على خريطة ليست من خرائط 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=19&hl=ar)
للاستخدام على خلفية فاتحة | للاستخدام على خلفية داكنة |
---|---|
![]() |
![]() |
يحتوي الملف المضغوط التالي على شعار Google بالأحجام الصحيحة تطبيقات الكمبيوتر المكتبي وAndroid وiOS. لا يجوز لك تغيير حجم هذه العناصر أو تعديلها الشعارات بأي شكل من الأشكال.
تنزيل: google_logo.zip
لا تعدِّل الإحالة. عدم إزالة الإحالة أو حجبها أو اقتصاصها المعلومات. ولا يمكنك استخدام شعارات Google بشكل مضمّن (على سبيل المثال، "هذه الخرائط من [Google_logo]").
إبقاء الإحالة قريبة: في حالة استخدام لقطات شاشة لصور Google خارج تضمين الإحالة القياسية كما يظهر في الصورة. إذا لزم الأمر، يمكنك تخصيص نمط وموضع نص الإحالة، طالما أن النص قريبة من المحتوى وواضحة للمشاهد العادي أو القارئ العادي لا يجوز لك نقل الإسناد بعيدًا عن المحتوى، كنهاية الكتاب مثلاً المساهمون في ملفاتك أو عرضك، أو تذييل موقعك الإلكتروني.
تضمين مزوِّدي البيانات التابعين لجهات خارجية: بعض البيانات والصور في عملية الربط منتجات تأتي من مقدّمي خدمات غير Google. في حالة استخدام مثل هذه الصور، فإن نص يجب أن يذكر الإسناد الاسم "Google" ومزود(مقدمي البيانات) المعنيين، مثل "بيانات الخريطة: Google، تقنيات Maxar". عند ذكر موفري بيانات من أطراف ثالثة مع الصور، بما في ذلك "Google" فقط أو أن شعار Google ليس إحالة صحيحة.
إذا كنت تستخدم "منصة خرائط Google" على جهاز لا يمكن عرض الإحالة عمليًا، من فضلك للتواصل مع فريق مبيعات Google لمناقشة التراخيص المناسبة لحالة استخدامك.
متطلبات أخرى لتحديد المصدر
تتضمّن عمليات تحديد المصدر إلى مقدّمي الخدمات التابعين لجهات خارجية محتوًى وروابط يجب أن تظهر للمستخدم بالتنسيق الذي تم تقديمها به. Google يقترح التطبيق أن يعرض هذه المعلومات أسفل تفاصيل المكان.
إحالات الطرف الثالث التي تم عرضها بواسطة لا تتضمّن واجهة برمجة التطبيقات تحديد المصدر على Google. يجب ضمِّن هذه الإسناد بنفسك، كما هو موضّح في عرض شعار Google ومصادرها:
اتّبِع هذه التعليمات لاسترداد عمليات تحديد مصدر من جهة خارجية مكان أو مجموعة من الأماكن.
استرداد عمليات تحديد المصدر لمكان واحد
عند استرداد مكان من خلال الحصول على
وضعها حسب رقم التعريف،
استرداد الإحالات الناجحة لذلك المكان من
فندق واحد (attributions
) في
GMSPlace
يتم توفير attributions
على شكل
كائن NSAttributedString
.
استرداد عمليات تحديد المصدر لمجموعة من الأماكن
إذا كان تطبيقك يعرض معلومات تم الحصول عليها من خلال طلب
المكان الحالي، يجب أن يعرض التطبيق
إحالات الطرف الثالث لتفاصيل المكان المعروضة. يمكنك استرداد
إحالات جميع الأماكن التي تم استردادها في الطلب، من
فندق واحد (attributions
) في
GMSPlaceLikelihoodList
يتم توفير attributions
على شكل
كائن NSAttributedString
، الذي يمكنك الوصول إليه وعرضه
تمامًا مثل attributions
من مكان واحد، كما هو موضح
أعلاه.
عرض المساهمين في صورة
إذا كان تطبيقك يعرض
photos، عليك
عرض أي 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 من خلال
السمة 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=19&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;