التنقل عبر واجهة برمجة التطبيقات

الفئة النهائية العامة NavigationApi يوسِّع الكائن

نقطة الدخول إلى واجهة برمجة تطبيقات التنقّل استخدِم الطرق الثابتة في هذه الفئة للحصول على مرجع إلى Navigator.

ملخص الفئة المدمَجة

@interface	NavigationApi.ErrorCode		رمز الخطأ هو رمز حالة يعرضه getNavigator(Activity, NavigatorListener) وgetNavigator(Application, NavigatorListener) عندما يتعذّر الحصول على Navigator بنجاح.
واحدة	NavigationApi.NavigatorListener		عليك تسجيل NavigatorListener لدى getNavigator(Activity, NavigatorListener) ليتم إعلامك بحالة Navigator المذكورة.
واحدة	NavigationApi.OnTermsResponseListener		سجِّل OnTermsResponseListener لدى "showTermsAndConditionsDialog(Activity, String, OnTermsResponseListener)" لتلقّي إشعار عند قبول المستخدم للأحكام والشروط أو رفضها.

ملخّص الطريقة العلنية

قيمة منطقية ثابتة	areTermsAccepted(تقديم طلب الانضمام إلى البرنامج) تعرض true إذا سبق للمستخدم قبول أحكام وشروط التنقّل في Google.
قيمة فارغة	cleanup() تنظِّف الحالة الداخلية لمكوّنات NavSDK.
متزامن ثابت ForegroundServiceManager	getForegroundServiceManager(تطبيق التطبيق) يمكن الحصول على مثيل ForegroundServiceManager المفرد.
ثابتة سلسلة	getNavSDKVersion() تعرض إصدار NavSDK الحالي.
قيمة فارغة	getNavigator(تطبيق التطبيق، معاودة الاتصال NavigationApi.NavigatorListener) يمكن الحصول على مثيل Navigator.
قيمة فارغة	getNavigator(نشاط النشاط، معاودة الاتصال NavigationApi.NavigatorListener و TermsAndConditionsCheckOption termsCheck) يمكن الحصول على مثيل Navigator.
قيمة فارغة	getNavigator(نشاط النشاط، معاودة الاتصال NavigationApi.NavigatorListener) هذا الرمز مكافئ للرمز getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}.
قيمة فارغة	getNavigatorNoToS(تطبيق التطبيق، معاودة الاتصال NavigationApi.NavigatorListener) يمكن الحصول على مثيل Navigator.
ثابت RoadSnappedLocationProvider	getRoadSnappedLocationProvider(تطبيق التطبيق) يمكن الحصول على مثيل من RoadSnappedLocationProvider يمكن استخدامه للاشتراك في المواقع الجغرافية للمستخدمين التي تم التقاط صور لها على الطريق.
ثابت NavigationTransactionRecorder	getTransactionRecorder(تطبيق التطبيق) الحصول على مثيل من NavigationTransactionRecorder يمكن استخدامه لتسجيل المعاملات ذات الصلة بالتنقل
متزامن ثابت فارغ	initForegroundServiceManager(تطبيق التطبيق، معرِّف عدد صحيح، معرِّف السلسلة التلقائي، مزوّد NotificationContentProvider) لتهيئة النسخة الافتراضية ForegroundServiceManager مع الوسيطات المقدمة.
قيمة فارغة	resetTermsAccepted(طلب الانضمام إلى التطبيق) إعادة ضبط الأحكام والشروط للاختبار.
قيمة فارغة	showTermsAndConditionsDialog(نشاط النشاط، اسم شركة السلسلة، عنوان السلسلة، أداة معالجة البيانات NavigationApi.OnTermsResponseListener) تعرض مربع حوار يوجّه المستخدم إلى قبول أحكام وشروط التنقّل في Google، باستخدام الشكل والأسلوب التلقائيَين.
قيمة فارغة	showTermsAndConditionsDialog(نشاط النشاط، اسم الشركة ذات السلسلة، عنوان السلسلة، TermsAndConditionsUIParams uiParams، وNavigationApi.OnTermsResponseListener، ومستمع TermsAndConditionsCheckOption termsAndConditionsCheckOption) تعرض مربّع حوار يوجّه المستخدم إلى قبول أحكام وشروط التنقّل في Google.
قيمة فارغة	showTermsAndConditionsDialog(نشاط النشاط، اسم الشركة الأصلية، NavigationApi.OnTermsResponseListener) تعرض مربّع حوار يوجّه المستخدم إلى قبول أحكام وشروط التنقّل في Google، باستخدام العنوان التلقائي والشكل والأسلوب التلقائيَين.

ملخّص الطريقة المكتسبة

من الفئة java.lang.Object

boolean	equals(كائن arg0)
last الفئة<?>	getClass()
int	hashCode()
أخير ملغي	notify()
أخير ملغي	notifyAll()
سلسلة	toString()
أخير ملغي	انتظار(long arg0, int arg1)
أخير ملغي	انتظار(طول طويل arg0)
أخير ملغي	نحن()

الطرق العامة

عامة ثابتة منطقية areTermsAccepted (طلب الانضمام إلى البرنامج)

تعرض true إذا سبق للمستخدم قبول أحكام وشروط التنقّل في Google.

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

المَعلمات

التطبيق	التطبيق الحالي

المرتجعات

• true إذا قبل المستخدم البنود، وfalse بخلاف ذلك

عامة ثابتة إلغاء تنظيف ()

تنظِّف الحالة الداخلية لمكوّنات NavSDK. في حال وجود مستكشف حالي، يتم إيقاف الإرشادات وإيقافها. لا يمكن إجراء أي طلبات في المستقبل للحصول على إرشادات من هذا المستكشف. وعليك باستدعاء هذه الطريقة لاسترداد الذاكرة إذا لم يعُد تطبيقك يتطلب Navigator وكان تطبيقك قد دمّر جميع الإشارات إلى Navigator. إذا كان تطبيقك يتطلب Navigator بعد هذه المكالمة، يمكنك استخدام getNavigator() لإنشاء واحد جديد. ملاحظة: يستغرق إنشاء برنامج مستكشف جديد بعض الوقت، ولكن عليك مراعاة كيفية تأثير التأخير في أداء تطبيقك وفي مزايا الذاكرة التي يتم استردادها.

عامة ثابتة تمت مزامنتها ForegroundServiceManager getForegroundServiceManager (تطبيق التطبيق)

يمكن الحصول على مثيل ForegroundServiceManager المفرد. إذا لم يتم استدعاء initForegroundServiceManager(Application, Integer, String, NotificationContentProvider) قبل getForegroundServiceManager(Application)، سيتم استخدام معرّف الإشعار التلقائي والرسالة والإشعارات.

المَعلمات

التطبيق	قيمة Application الحالية

public static سلسلة getNavSDKVersion ()

تعرض إصدار NavSDK الحالي.

public static إلغاء getNavigator (طلب معاودة الاتصال بتطبيق التطبيق NavigationApi.NavigatorListener)

يمكن الحصول على مثيل Navigator.

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

يُرجى العِلم أنّ Navigator هي عملية فردية من نوع واحد، وإذا استدعيت هذه الطريقة عدة مرات، ستعرض كل عملية طلب أداة المستكشف نفسها.

المَعلمات

التطبيق	قيمة Application الحالية
رد الاتصال	معاودة الاتصال التي سيتم تنشيطها عندما تكون Navigator جاهزة أو عند حدوث خطأ

public static باطلة getNavigator (نشاط النشاط، ومعاودة الاتصال NavigationApi.NavigatorListener، وTermsAndConditionsCheckOption التحقّق من البنود)

يمكن الحصول على مثيل Navigator.

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

إذا كان termsCheck هو ENABLED، سيحتوي مربع الحوار أيضًا على رابط إلى الأحكام والشروط لحزمة تطوير البرامج (SDK) للتنقل. وسيتم استدعاء callback مع عرض الخطأ TERMS_NOT_ACCEPTED إذا لم يوافق المستخدم على هذه الأحكام.

يُرجى العِلم أنّ Navigator هي عملية فردية من نوع واحد، وإذا استدعيت هذه الطريقة عدة مرات، ستعرض كل عملية طلب أداة المستكشف نفسها.

المَعلمات

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

public static إلغاء getNavigator (نشاط نشاط، معاودة الاتصال بـ NavigationApi.NavigatorListener)

هذا الرمز مكافئ للرمز getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}.

المَعلمات

النشاط
رد الاتصال

راجِع أيضًا

• getNavigator(Activity, NavigatorListener, TermsAndConditionsCheckOption)

public static إلغاء getNavigatorNoToS (طلب استدعاء التطبيق NavigationApi.NavigatorListener)

يمكن الحصول على مثيل Navigator.

يتجاوز الأحكام والشروط.

يُرجى العِلم أنّ Navigator هي عملية فردية من نوع واحد، وإذا استدعيت هذه الطريقة عدة مرات، ستعرض كل عملية طلب أداة المستكشف نفسها.

المَعلمات

التطبيق	قيمة Application الحالية.
رد الاتصال	معاودة الاتصال التي سيتم تنشيطها عندما تكون Navigator جاهزة أو عند حدوث خطأ.

public static RoadSnappedLocationProvider getRoadSnappedLocationProvider (تطبيق التطبيق)

يمكن الحصول على مثيل من RoadSnappedLocationProvider يمكن استخدامه للاشتراك في المواقع الجغرافية للمستخدمين التي تم التقاط صور لها على الطريق. وتجدُر الإشارة إلى أنّ الاشتراك في تحديثات الموقع الجغرافي التي تم التقاطها على الطريق قد يتسبّب في استنزاف البطارية أو جمع بيانات الموقع الجغرافي للمستخدم بشكل غير مقصود في حال تركها قيد التشغيل في الخلفية.

يجب الحصول على Navigator بنجاح قبل استدعاء هذه الطريقة، وإلا سيتم عرض null.

المَعلمات

التطبيق	قيمة Application الحالية

public static NavigationTransactionRecorder getTransactionRecorder (تطبيق التطبيق)

الحصول على مثيل من NavigationTransactionRecorder يمكن استخدامه لتسجيل المعاملات ذات الصلة بالتنقل

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

يجب الحصول على Navigator بنجاح قبل استدعاء هذه الطريقة، وإلا سيتم عرض null.

المَعلمات

التطبيق	قيمة Application الحالية

عامة ثابتة إلغاء متزامنة initForegroundServiceManager (تطبيق التطبيق، معرّف الإشعار الصحيح، القيمة التلقائية للسلسلة، موفِّر خدمة NotificationContentProvider)

لتهيئة النسخة الافتراضية ForegroundServiceManager مع الوسيطات المقدمة.

ويجب طلب هذا الإجراء فقط إذا أردت تعديل أيّ من المَعلمات التلقائية. وبخلاف ذلك، يمكنك الاتصال بـ "getForegroundServiceManager(Application)" مباشرةً. يمكن طلب هذه الطريقة مرة واحدة فقط ويجب طلبها قبل getForegroundServiceManager(Application).

المَعلمات

التطبيق	قيمة Application الحالية
notificationId	رقم تعريف الإشعار للإشعار الدائم
defaultMessage	الرسالة التلقائية التي سيتم عرضها إذا لم يتم تحديد provider
provider	تنفيذ NotificationContentProvider

متاح للجميع ثابت لاغٍ resetTermsAccepted (طلب الانضمام إلى البرنامج)

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

المَعلمات

التطبيق	التطبيق الحالي

public static void showTermsAndConditionsDialog (نشاط النشاط، اسم الشركة المصنّعة، عنوان السلسلة، أداة معالجة البيانات NavigationApi.OnTermsResponseListener)

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

المَعلمات

النشاط
companyName
العنوان
أداة معالجة الحدث

راجِع أيضًا

• for a description of the different parameters.

public static void showTermsAndConditionsDialog (النشاط، String companyName، String title، TermsAndConditionsUIParams uiParams، NavigationApi.OnTermsResponseListener مستمع، TermsAndConditionsCheckOption termsAnd3ConditionsCheckOption){/1

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

تجدر الإشارة إلى أنّ مربّع الحوار سيظهر حتى إذا وافق المستخدم في السابق. ويجب طلب هذا الإجراء فقط إذا كانت قيمة السمة areTermsAccepted(Application) هي false، لأنّه من غير الممكن أن يرفض المستخدم الأحكام والشروط.

المَعلمات

النشاط	Activity الذي سيظهر عليه مربّع الحوار
companyName	اسم شركتك الذي سيظهر في مربّع حوار الأحكام والشروط
العنوان	عنوان مربع الحوار. إذا كانت فارغة، سيستخدم مربّع الحوار العنوان التلقائي.
uiParams	المعلمات المستخدمة لتخصيص شكل ومظهر مربع الحوار. وإذا كانت قيمة هذه السمة فارغة، يتم استخدام المظهر والأسلوب التلقائيَين.
أداة معالجة الحدث	معاودة الاتصال الاختيارية التي سيتم تنشيطها عندما يقبل المستخدم الأحكام والشروط أو يرفضها
termsAndConditionsCheckOption	TermsAndConditionsCheckOption التي تحدّد خيارات التحقّق من الأحكام والشروط

public static باطلة showTermsAndConditionsDialog (نشاط النشاط، وسلسلة اسم الشركة، وNavigationApi.OnTermsResponseListener)

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

المَعلمات

النشاط
companyName
أداة معالجة الحدث

راجِع أيضًا

• for a description of the different parameters.