السياسات وبيانات المصدر الخاصة بحزمة تطوير البرامج Places SDK for iOS

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

السياسات

يوضّح هذا القسم السياسات ذات الصلة بحزمة تطوير البرامج (SDK) الخاصة بـ "الأماكن في iOS". توفّر السياسات إرشادات ومتطلبات عملية للتنفيذ لمساعدتك في استخدام الخدمة بشكل صحيح وبما يتوافق مع توقعات "منصة خرائط Google".

استثناءات من القيود المفروضة على التخزين المؤقت

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

بلدان ومناطق المنطقة الاقتصادية الأوروبية

يخضع هذا المنتج لبنود خدمة مختلفة للعملاء الذين لديهم عنوان فوترة في المنطقة الاقتصادية الأوروبية، وقد يتضمّن أيضًا وظائف مختلفة. قبل البدء في استخدام "منصة خرائط Google"، يُرجى مراجعة البنود والمعلومات التالية الخاصة بالمنطقة الاقتصادية الأوروبية:

• بنود خدمة "منصة خرائط Google" في المنطقة الاقتصادية الأوروبية
• البنود الخاصة بالخدمة في المنطقة الاقتصادية الأوروبية في "منصة خرائط Google"
• الأسئلة الشائعة حول المنطقة الاقتصادية الأوروبية
• متطلبات السلامة على الطرق في "منصة خرائط Google"

إذا لم يكن عنوان إرسال الفواتير في المنطقة الاقتصادية الأوروبية، تسري عليك بنود الخدمة التالية:

• بنود خدمة "منصة خرائط Google"
• البنود الخاصة بالخدمات في "منصة خرائط Google"

متطلبات تحديد المصدر في "خرائط Google"

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

مثال على تحديد المصدر

في ما يلي مثال على تحديد المصدر لحزمة أدوات Places UI Kit.

عرض مصدر البيانات في "خرائط Google"

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

إحالة المصدر إلى "خرائط Google"

بالنسبة إلى بيانات المصدر في "خرائط Google" التي توفّرها "منصة خرائط Google" في واجهة المستخدم، مثل Places UI Kit:

• لا تزِل معلومات تحديد المصدر المضمّنة بغض النظر عن مكان عرضها. لا يجوز تعديل معلومات تحديد المصدر أو إخفاؤها أو حجبها، ويجب التأكّد من أنّها ظاهرة بوضوح على الخلفية.
• يجب دائمًا التمييز بصريًا بين "محتوى منصة خرائط Google" والمحتوى الآخر باستخدام إشارات واجهة المستخدم، مثل الحدود أو لون الخلفية أو الظل أو المساحة البيضاء الكافية.
• عند إجراء تعديلات مرئية، يجب الالتزام بجميع متطلبات الإشارة إلى المصدر في "خرائط Google".

شعار "خرائط Google" وتحديد المصدر باستخدام نص

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

تحديد مصدر الشعار

تنزيل شعارات "خرائط Google"

استخدِم ملفات شعار "خرائط Google" الرسمية. نزِّل الشعارات أدناه واتّبِع الإرشادات الواردة في هذا القسم.

عند استخدام شعار "خرائط Google"، يُرجى اتّباع الإرشادات التالية.

• لا تعدّل الشعار بأي شكل من الأشكال.
• يجب الحفاظ على نسبة العرض إلى الارتفاع للشعار لتجنُّب تشوّهه.
• استخدِم الشعار المخطّط على خلفية متعددة التفاصيل، مثل خريطة أو صورة.
• استخدِم الشعار غير المحدّد بخطوط على خلفية عادية، مثل لون واحد أو تدرّج ألوان بسيط.

مواصفات حجم الشعار

• الحدّ الأدنى لارتفاع الشعار: 16dp
• الحد الأقصى لارتفاع الشعار: 19dp
• المساحة الخالية الدنيا حول الشعار: 10 وحدات بكسل مستقلة عن الكثافة على اليمين واليسار والأعلى، و5 وحدات بكسل مستقلة عن الكثافة في الأسفل

لمعرفة المزيد عن وحدات البكسل المستقلة الكثافة، يمكنك الاطّلاع على كثافة البكسل على موقع Material Design الإلكتروني.

إمكانية الوصول إلى الشعار

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

تحديد مصدر النص

إذا كان حجم واجهتك لا يتيح استخدام شعار "خرائط Google"، يمكنك كتابة خرائط Google كنص. اتبع الإرشادات التالية:

• لا تعدّل النص خرائط Google بأي شكل من الأشكال:
  
  • لا تغيِّر حالة الأحرف في خرائط Google
  • لا تلتف خرائط Google على أسطر متعددة
  • لا تقلم خرائط Google إلى لغة أخرى.
  • يمكنك منع المتصفحات من ترجمة خرائط Google باستخدام سمة HTML translate="no".

• يمكنك تنسيق نص "خرائط Google" كما هو موضّح في الجدول التالي:

  متطلبات تنسيق النصوص في "خرائط Google"
  الموقع	النمط
  مجموعة الخطوط	Roboto تحميل الخط اختياري.
  مجموعة الخطوط الاحتياطية	أي خط sans serif مستخدَم حاليًا في منتجك أو "Sans-Serif" لاستخدام خط النظام التلقائي
  شكل الخطّ	عادي
  سُمك الخط	400
  لون الخط	أبيض أو أسود (#1F1F1F) أو رمادي (#5E5E5E) الحفاظ على نسبة تباين (4.5:1) يسهل الوصول إليها مقارنةً بالخلفية
  حجم الخط	الحد الأدنى لحجم الخط: 12sp الحد الأقصى لحجم الخط: 16sp للتعرّف على sp، يمكنك الاطّلاع على وحدات حجم الخط على موقع Material Design الإلكتروني.
  تباعُد الأحرف	عادي

مثال على CSS

تعرض ورقة الأنماط المتتالية (CSS) التالية "خرائط Google" مع نمط الطباعة واللون المناسبَين على خلفية بيضاء أو فاتحة.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

متطلبات المرئيات

• ضَع معلومات تحديد المصدر بالقرب من أعلى المحتوى أو أسفله، وضِمن الحاوية المرئية نفسها. بالنسبة إلى سطر واحد من المحتوى، يمكن وضع مصدر المحتوى على اليمين أو اليسار.

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

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

تعرض الأشكال التالية أمثلة على هذه المتطلبات المرئية.

مزودو بيانات الجهات الخارجية

تأتي بعض البيانات والصور في منتجات الخرائط من مقدّمي خدمات غير Google. بالنسبة إلى بعض المنتجات، مثل Map Tiles API، قد نقدّم لك معلومات تحديد المصدر المطلوبة لمزوّد البيانات التابع لجهة خارجية. وفي هذه الحالة، يجب أن يتضمّن نص الإشارة إلى المصدر الاسم "خرائط Google" ومزوّدي البيانات المعنيين، مثل "بيانات الخرائط: Google وMaxar Technologies". عندما تقدّم 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.

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

[[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 أيضًا بعرض طريقة ترتيب المراجعات للمستخدم النهائي.

للوصول إلى المراجعات، اتّبِع الخطوات التالية:

// 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.

  }
})

// 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.

...
  self.attributionTextView.delegate = self
...

// MARK: - UITextViewDelegate

func textView(textView: UITextView, shouldInteractWithURL URL: NSURL,
  inRange characterRange: NSRange) -> Bool {
  // Make links clickable.
  return true
}
    

...
  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". لا ينطبق هذا الاستثناء إلا على عنوان الشارع الذي يختاره المستخدم النهائي ولغرض المعاملة المحددة التي يجريها هذا المستخدم فقط، ولا ينطبق على قائمة العناوين المقترَحة التي توفّرها وظيفة "الإكمال التلقائي" أو على "محتوى خرائط Google" الآخر. ولا ينطبق هذا الاستثناء على أي وظائف بحث عن نقاط اهتمام أو عناوين تقدّمها خدمات أخرى من Google Maps Platform.

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