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

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

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

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

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

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

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

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

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

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

جلب المحتوى مسبقًا أو تخزينه أو الاحتفاظ به مؤقتًا في ذاكرة التخزين المؤقت

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

يُرجى العِلم أنّ رقم تعريف المكان المستخدَم لتحديد مكان بشكل فريد معفي من قيود التخزين المؤقت. يتم عرض معرّف المكان في حقل place_id في ردود "حزمة تطوير برامج الأماكن لأجهزة iOS". اطّلِع على كيفية حفظ أرقام تعريف الأماكن وتعديلها وإدارتها في دليل أرقام تعريف الأماكن.

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

يمكنك عرض نتائج حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لأجهزة iOS على إحدى خرائط Google أو بدون خريطة. إذا كنت تريد عرض نتائج حزمة تطوير برامج "الأماكن" لنظام التشغيل iOS على خريطة، يجب عرض هذه النتائج على خريطة Google. يُحظر استخدام بيانات حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" لنظام التشغيل 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". إذا تم الاستشهاد بمقدّمي بيانات خارجيين في الصور، لا يُعدّ تضمين "Google" أو شعار 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 في CSS وHTML إذا لم تتمكّن من استخدام شعار Google القابل للتنزيل.

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

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

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

سهولة القراءة

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

اللون

استخدِم نصًا باللون Google Material Gray 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"، سيتم عرض "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;