مرجع الفصل الدراسي GMSSecurityServices


نظرة عامة

خدمات تتيح التحكم في دخول الجوال إلى تطبيق SDK للتنقل في خرائط Google لنظام التشغيل iOS.

دوال الأعضاء العامة الثابتة

(BOOL) + areTermsAndConditionsAccepted
 بالنسبة إلى الإصدارات >= 5.5.0، تشير إلى ما إذا كان المستخدم قد وافق على البنود والشروط أم لا.
(void) + showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback:
 يعرض مربّع حوار مشروط إذا لم يقبل مستخدم التطبيق أحكام وشروط حزمة تطوير البرامج (SDK) للتنقّل.
(void) + showTermsAndConditionsDialogIfNeededWithTitle:companyName:callback:
 تعرِض هذه السمة مربّع حوار الأحكام والشروط باستخدام الشكل والأسلوب التلقائيَين.
(void) + showTermsAndConditionsDialogIfneededWithCompanyName:callback:
 يعرض مربّع حوار الأحكام والشروط باستخدام العنوان والشكل والمظهر التلقائيَين.
(void) + resetTermsAndConditionsAccepted
 إعادة ضبط الأحكام والشروط على الحالة "غير مقبولة".
(void) + setAbnormal EndReportingEnabled:
 تمكِّن هذه السياسة من الإبلاغ عن عمليات الإغلاق غير الطبيعية لحزمة SDK، مثل أعطال التطبيق عندما لا تزال حزمة SDK قيد التشغيل.
(GMSNavigationSession* قابل للقيم الفارغة)+ createNavigationSession
 ينشئ جلسة تنقّل جديدة غير مرتبطة بوضع الخريطة.
(NSString *)+ openSourceLicenseInfo
 لعرض معلومات ترخيص البرنامج مفتوح المصدر لحزمة أدوات التنقل (SDK) الخاصة بالتنقل من Google لنظام التشغيل iOS.
(NSString *)+ navSDKVersion
 لعرض إصدار هذا الإصدار من حزمة SDK للتنقل لنظام التشغيل iOS.

المواقع

قيمة منطقيةshouldOnlyShowDriverAwarenesssDisclaimer
 تشير هذه السمة إلى ما إذا كان يجب عرض بيان إخلاء المسؤولية بشأن الوعي السائق فقط في showTermsAndConditionsDialogIfNeededWithCompanyName:callback:.

(يُرجى العلم أنّ هذه الدوال ليست أعضاء.)

typedef false(^ GMSTermsResponseCallback )(مقبولة بنود BOOL)
 يتم استدعاؤه عند قبول المستخدم للأحكام والشروط أو رفضها.

وثائق وظائف الأعضاء

بالنسبة إلى الإصدارات >= 5.5.0، تشير إلى ما إذا كان المستخدم قد وافق على البنود والشروط أم لا.

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

في حال اختيار القيمة "false"، ستوقف الخدمات الوصول إلى واجهات التنقل.

+ (إبطال) showTermsAndConditionsDialogIfneededWithTitle: (nullable NSString *)  title
اسم الشركة: (NSString *) companyName
مَعلمات واجهة المستخدم: (GMSNavigationTermsDialogUIParams *) قابلة للقيم UIParams
معاودة الاتصال: (GMSTermsResponseCallback) معاودة الاتصال

يعرض مربّع حوار مشروط إذا لم يقبل مستخدم التطبيق أحكام وشروط حزمة تطوير البرامج (SDK) للتنقّل.

يتم إرسال رد الاتصال في قائمة الانتظار الرئيسية مع استجابة المستخدم.

إذا سبق للمستخدم قبول الأحكام والشروط، لن يظهر أي مربّع حوار، وتحتوي معاودة الاتصال على termsAccepted = YES.

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

عليك استدعاء هذه الطريقة من سلسلة التعليمات الرئيسية. المكالمات المتعددة بدون انتظار الرد لا يكون لها أي تأثير.

المَعلمات:
titleعنوان مربّع الحوار إذا كانت title فارغة، سيستخدم مربع الحوار العنوان التلقائي.
ملاحظة:
بالنسبة إلى العناوين المخصّصة، يحتاج المتصل بهذه الطريقة إلى ترجمة هذه المعلَمة. تتم ترجمة العنوان التلقائي بواسطة الخدمات تلقائيًا.
المَعلمات:
companyNameاسم الشركة التي أصدرت التطبيق والموقّعة في الاتفاقية مع Google لمشاركة بيانات الموقع الجغرافي.
UIParamsمعلَمات تحدّد شكل مربّع الحوار ومظهره. وإذا لم يتم إدخال قيمة، سيستخدم مربع الحوار الشكل والأسلوب التلقائيين.
معاودة الاتصالتم إرسال الحظر في قائمة الانتظار الرئيسية مع رد المستخدم.
+ (إبطال) showTermsAndConditionsDialogIfneededWithTitle: (nullable NSString *)  title
اسم الشركة: (NSString *) companyName
معاودة الاتصال: (GMSTermsResponseCallback) معاودة الاتصال

تعرِض هذه السمة مربّع حوار الأحكام والشروط باستخدام الشكل والأسلوب التلقائيَين.

يُرجى الاطّلاع على +showTermsAndConditionsDialogIf NeededWithTitle:companyName:UIParams:callback: للحصول على التفاصيل، بما في ذلك وصف المَعلمتَين وcompanyName وcallback.

+ (إبطال) showTermsAndConditionsDialogIf neededWithCompanyName: (NSString *) companyName
معاودة الاتصال: (GMSTermsResponseCallback) معاودة الاتصال

يعرض مربّع حوار الأحكام والشروط باستخدام العنوان والشكل والمظهر التلقائيَين.

يُرجى الاطّلاع على +showTermsAndConditionsDialogIf NeededWithTitle:companyName:UIParams:callback: للحصول على التفاصيل، بما في ذلك وصف المَعلمة companyName وcallback.

إعادة ضبط الأحكام والشروط على الحالة "غير مقبولة".

بعد استدعاء هذه الطريقة، ستعرض areTermsAndConditionsAccepted "لا"، وسيعرض #if SDK_BUILD_CONFIG(EnableNavSDKسكيToSOptions) showTermsAndConditionsDialogIfNeededWithOptions:callback: و #endif showTermsAndConditionsDialogIfNeededWithCompanyName:callback: مربّع حوار الأحكام والشروط. ستتم إعادة ضبط السمة navigationEnabled لأيّ من مثيلات GMSMapView الحالية إلى "لا".

+ (ملء) setAbnormalPositionReportingEnabled: (BOOL)  abnormalTerminationReportingEnabled

تمكِّن هذه السياسة من الإبلاغ عن عمليات الإغلاق غير الطبيعية لحزمة SDK، مثل أعطال التطبيق عندما لا تزال حزمة SDK قيد التشغيل.

ويسمح هذا الإجراء لشركة Google بتحسين ثبات حزمة SDK عند الاقتضاء. القيمة التلقائية هي YES، ويجب تعديل القيمة قبل إعداد مثيل الخدمات.

يجب ضبط هذه السمة من سلسلة التعليمات الرئيسية.

ينشئ جلسة تنقّل جديدة غير مرتبطة بوضع الخريطة.

يخصص هذا جلسة تنقل جديدة ويعرضها. قد يتم تعيين نقاط الطريق والخيارات في الجلسة، وقد تتم إضافة مستمعين إليها.

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

يمكنك ربط هذه الجلسة بخريطة بعد إنشائها باستخدام طريقة GMSMapView -enableNavigationWithSession:. الجلسات هي عناصر ثقيلة تستهلك الذاكرة والبيانات والبطارية، لذا يجب تخصيصها فقط إذا كانت جلسة تنقّل دائمة ميزة رئيسية في التطبيق. وللسبب ذاته، إذا أنشأ تطبيقك واجهة مستخدم للتنقُّل بعد إنشاء جلسة تنقُّل، تأكَّد من بدء واجهة مستخدِم التنقّل بجلسة التنقّل الحالية بدلاً من إنشاء جلسة تنقّل جديدة.

تخضع فترة عمل جلسة التنقل للدلالة العادية لـ Objective-C. ولذلك، يجب أن يحفظ المتصل بسلسلة الإجراءات هذه مرجعًا إلى الجلسة.

+ (NSString *) openSourceLicenseInfo

لعرض معلومات ترخيص البرنامج مفتوح المصدر لحزمة أدوات التنقل (SDK) الخاصة بالتنقل من Google لنظام التشغيل iOS.

يجب أن تتوفّر هذه المعلومات في طلبك.

+ (NSString *) navSDKVersion

لعرض إصدار هذا الإصدار من حزمة SDK للتنقل لنظام التشغيل iOS.


- (typedef mut(^ GMSTermsResponseCallback)(BOOL لكي يتم قبول البنود)) [related]

يتم استدعاؤه عند قبول المستخدم للأحكام والشروط أو رفضها.

في الإصدارات >= 5.5.0، ستكون قيمة termsAccepted دائمًا "نعم".


وثائق العقارات

- (BOOL) shouldOnlyShowDriverAwarenesssDisclaimer [read, write, assign]

تشير هذه السمة إلى ما إذا كان يجب عرض بيان إخلاء المسؤولية بشأن الوعي السائق فقط في showTermsAndConditionsDialogIfNeededWithCompanyName:callback:.

القيمة التلقائية هي NO، ويظهر بيان إخلاء المسؤولية بالإضافة إلى البنود والخدمات التلقائية التي يتم توفيرها مع حزمة تطوير البرامج (SDK) للتنقّل. اضبط القيمة على YES للإشارة إلى أنّه يجب عرض بيان إخلاء المسؤولية بشأن الوعي السائق فقط.

وإذا كان يجب أن يعرض المشروع مربّع الحوار "الأحكام والشروط"، لن يكون لضبط هذا المتغيّر على YES أي تأثير. بالإضافة إلى ذلك، تعرض طريقة getter دائمًا الدالة NO .

يجب ضبط هذه السمة أو قراءتها من سلسلة التعليمات الرئيسية.