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

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

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

إذا كنت بصدد تطوير حزمة تطوير برامج (SDK) لأماكن Google على نظام التشغيل iOS، عليك توفير بنود الاستخدام وسياسة الخصوصية مع طلبك الذي يستوفي الإرشادات الموضّحة في الاتفاقية مع Google:

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

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

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

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

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

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

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

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

عرض نتائج حزمة تطوير البرامج (SDK) لأماكن Google على نظام التشغيل iOS

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

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

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

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

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

تنزيل: google_logo.zip

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

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

تضمين مقدّمي البيانات التابعين لجهات خارجية: تأتي بعض البيانات والصور على منتجات الربط من موفّري خدمة غير Google. في حال استخدام مثل هذه الصور، يجب أن يشير نص الإحالة إلى الاسم "Google"وموفّر البيانات ذي الصلة، مثل "الخريطة: بيانات Google: Maxar Technologies.&quot. عندما يتم اقتباس البيانات من مقدّمي بيانات من أطراف ثالثة باستخدام الصور، بما في ذلك "quot;Google" أو شعار Google ليس الإحالة الصحيحة.

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

متطلبات الإحالة الأخرى

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

لا تشمل إحالات الجهات الخارجية التي تعرضها واجهة برمجة التطبيقات إحالة Google. عليك تضمين هذه الإحالة بنفسك، كما هو موضّح في عرض شعار Google وإحالاته.

اتّبِع هذه التعليمات لاسترداد إحالات الجهات الخارجية لمكان واحد أو لمجموعة من الأماكن.

استرداد الإحالات لمكان واحد

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

ويتم توفير attributions ككائن NSAttributedString.

استرداد الإحالات لمجموعة من الأماكن

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

يتم توفير attributions كعنصر NSAttributedString، يمكنك الوصول إليه وعرضه بالطريقة نفسها التي يستخدمها attributions في مكان واحد، كما هو موضّح أعلاه.

عرض أسماء المساهمين في صورة معيّنة

إذا كان تطبيقك يعرض صورًا، يجب أن تعرض إحالات لكل صورة تحتوي عليها. للحصول على إحالات لصورة، اطلب GMSPlacePhotoMetadata.attributions. وتكون هذه السمة هي NSAttributedString أو nil في حال عدم توفّر إحالات لعرضها.

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;
                      }
                    }
                  }];

عرض الإحالات من جهات خارجية

يتم تقديم الإحالات إلى مقدّمي الخدمات من الجهات الخارجية كعناصر 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

في المثال أعلاه، يغطي نطاق النص مثال للشركة سمة NSLink.

يُرجى العِلم بأن رقم تعريف المكان، الذي يُستخدَم لتحديد مكان فريد، يتم إعفاءه من قيد التخزين المؤقت. وبالتالي يمكنك تخزين قيم معرّف المكان إلى أجل غير مسمى. يتم عرض رقم تعريف المكان في الحقل place_id في Places Places لاستجابات iOS.

إرشادات النمط للإحالة إلى Google

إليك إرشادات الأسلوب الخاصة بإحالات Google في CSS وHTML إذا لم تتمكن من استخدام شعار Google القابل للتنزيل.

المساحة الخالية

يجب أن يكون مقدار المساحة الخالية حول الشعار الكامل مساويًا لارتفاع عامل التشغيل &quot&G" أو أكبر منه في Google.

يجب أن تكون المساحة بين نسخة الإحالة وشعار Google نصف عرض "&&;;&".

القابلية للقراءة

يجب أن يكون السطر الذي يبيّن اسم المؤلف واضحًا ومقروءًا دائمًا، كما يجب أن يظهر بخيارات الألوان المناسبة للخلفية المحدّدة. احرص دائمًا على توفير تباين كافٍ لصيغة الشعار التي تختارها.

اللون

يمكنك استخدام نص Google رمادي اللون على الجزء 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&&;;quot;"Google&quot؛ مع الخط واللون والمسافات المناسبة على خلفية بيضاء أو فاتحة اللون.

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;