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

يسرد هذا المستند المتطلبات الخاصة بجميع التطبيقات. التي تم تطويرها باستخدام حزمة تطوير برامج الأماكن لأجهزة 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 بالأحجام الصحيحة تطبيقات الكمبيوتر المكتبي و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".

الوضوح

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

اللون

استخدام نص 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;