NavigationApi

کلاس نهایی عمومی NavigationApi Object را گسترش می دهد

نقطه ورود به Navigation API. از متدهای استاتیک در این کلاس برای به دست آوردن یک مرجع به Navigator استفاده کنید.

خلاصه کلاس تودرتو

@رابط	NavigationApi.ErrorCode		ErrorCode یک کد وضعیت است که توسط getNavigator(Activity, NavigatorListener) و getNavigator(Application, NavigatorListener) زمانی که یک Navigator با موفقیت به دست نیامد، بازگردانده می شود.
رابط	NavigationApi.NavigatorListener		یک NavigatorListener را با getNavigator(Activity, NavigatorListener) ثبت کنید تا از وضعیت Navigator مذکور مطلع شوید.
رابط	NavigationApi.OnTermsResponseListener		یک OnTermsResponseListener را با showTermsAndConditionsDialog(Activity, String, OnTermsResponseListener) ثبت کنید تا زمانی که کاربر شرایط و ضوابط را پذیرفت یا رد کرد، به شما اطلاع داده شود.

خلاصه روش عمومی

بولی استاتیک	areTermsAccepted (برنامه کاربردی) در صورتی که کاربر قبلاً شرایط و ضوابط ناوبری Google را پذیرفته باشد، true .
فضای خالی ساکن	پاک کردن () وضعیت داخلی اجزای 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 را دریافت می‌کند که می‌تواند برای اشتراک در مکان‌های کاربران جاده‌ای استفاده شود.
Static NavigationTransactionRecorder	getTransactionRecorder (برنامه کاربردی) نمونه ای از NavigationTransactionRecorder را دریافت می کند که می تواند برای ثبت تراکنش های مربوط به ناوبری استفاده شود.
فضای خالی استاتیک همگام شده	initForegroundServiceManager (برنامه کاربردی، شناسه اطلاع رسانی عدد صحیح، پیام پیش فرض رشته، ارائه دهنده NotificationContentProvider ) نمونه ForegroundServiceManager را با آرگومان های ارائه شده راه اندازی می کند.
فضای خالی ساکن	resetTermsAccepted (برنامه کاربردی) بازنشانی شرایط و ضوابط - برای آزمایش.
فضای خالی ساکن	ShowTermsAndConditionsDialog (فعالیت فعالیت، نام شرکت رشته، عنوان رشته، شنونده NavigationApi.OnTermsResponseListener ) گفتگویی را نمایش می‌دهد که کاربر را با استفاده از ظاهر و احساس پیش‌فرض هدایت می‌کند تا شرایط و ضوابط ناوبری Google را بپذیرد.
فضای خالی ساکن	ShowTermsAndConditionsDialog (فعالیت فعالیت، نام شرکت رشته، عنوان رشته، TermsAndConditionsUIParams uiParams، NavigationApi.OnTermsResponseListener شنونده، TermsAndConditionsCheckOption TermsAndConditionsCheckOption) گفتگویی را نمایش می دهد که کاربر را به پذیرش شرایط و ضوابط ناوبری Google هدایت می کند.
فضای خالی ساکن	ShowTermsAndConditionsDialog (فعالیت فعالیت، String companyName، NavigationApi.OnTermsResponseListener شنونده) گفتگویی را نمایش می‌دهد که کاربر را با استفاده از عنوان پیش‌فرض و ظاهر و ظاهر پیش‌فرض هدایت می‌کند تا شرایط و ضوابط ناوبری Google را بپذیرد.

خلاصه روش ارثی

از کلاس java.lang.Object

بولی	برابر است (شیء arg0)
کلاس نهایی<?>	getClass ()
بین المللی	هش کد ()
باطل نهایی	اعلام کردن ()
باطل نهایی	اطلاع رسانی به همه ()
رشته	toString ()
باطل نهایی	صبر کنید (long arg0، int arg1)
باطل نهایی	صبر کنید (طولانی arg0)
باطل نهایی	صبر کن ()

روش های عمومی

بولی استاتیک عمومی areTermsAccepted (برنامه کاربردی)

در صورتی که کاربر قبلاً شرایط و ضوابط ناوبری Google را پذیرفته باشد، true .

می‌توانید از این برای بررسی اینکه آیا باید صفحه نمایش عبارت‌ها را زودتر در برنامه نمایش دهید، به جای زمانی که کاربر می‌خواهد در جایی حرکت کند، استفاده کنید. برای مثال، زمانی که برنامه شما شرایط و ضوابط دیگری را نشان می‌دهد، ممکن است مناسب باشد این مقدار را بررسی کنید تا کاربر بتواند همه شرایط و ضوابط مورد نیاز برنامه را در یک کار بپذیرد.

مولفه های

کاربرد	برنامه فعلی

برمی گرداند

• true اگر شرایط توسط کاربر پذیرفته شده باشد و در غیر این صورت false

پاکسازی فضای خالی استاتیک عمومی ()

وضعیت داخلی اجزای NavSDK را تمیز می کند. اگر یک ناوبر فعلی وجود داشته باشد، راهنمایی متوقف و غیرفعال می شود. هیچ تماسی برای راهنمایی در آینده نمی تواند از این Navigator برقرار شود. زمانی که برنامه شما دیگر به Navigator نیاز ندارد و برنامه شما همه مراجع به Navigator را از بین برده است، این روش را برای بازیابی حافظه فراخوانی کنید. اگر برنامه شما پس از این فراخوانی به Navigator نیاز دارد، از getNavigator() برای ایجاد یک Navigator جدید استفاده کنید. توجه: ایجاد یک Navigator جدید به زمان نیاز دارد. در نظر بگیرید که تأخیر چگونه بر عملکرد برنامه شما در مقابل مزایای حافظه بازیابی شده تأثیر می گذارد.

همگام سازی استاتیک عمومی ForegroundServiceManager getForegroundServiceManager (برنامه کاربردی)

نمونه تکی ForegroundServiceManager را به دست می آورد. اگر initForegroundServiceManager(Application, Integer, String, NotificationContentProvider) قبل از getForegroundServiceManager(Application) فراخوانی نشود، از شناسه اعلان، پیام و ارائه دهنده اعلان پیش فرض استفاده می شود.

مولفه های

کاربرد	Application فعلی

رشته استاتیک عمومی getNavSDKVersion ()

نسخه NavSDK فعلی را برمی‌گرداند.

public void getNavigator (برنامه کاربردی، NavigationApi.NavigatorListener برگشت به تماس)

نمونه Navigator را به دست می آورد.

اگر کاربر هنوز با شرایط و ضوابط موافقت نکرده باشد، پاسخ تماس بلافاصله با کد خطا TERMS_NOT_ACCEPTED فعال می شود.

توجه داشته باشید که Navigator یک تک تن است. اگر این روش را چندین بار فراخوانی کنید، هر تماس همان Navigator را برمی گرداند.

مولفه های

کاربرد	Application فعلی
پاسخ به تماس	یک تماس برگشتی که هنگامی که Navigator آماده باشد فعال می شود یا خطایی رخ می دهد

public void getNavigator (فعالیت فعالیت، پاسخ به تماس NavigationApi.NavigatorListener ، TermsAndConditionsCheckOption TermsCheck)

نمونه Navigator را به دست می آورد.

اگر کاربر هنوز با شرایط و ضوابط موافقت نکرده باشد، این تماس گفتگویی را نشان می دهد که کاربر را به رعایت مقررات محلی تشویق می کند.

اگر termsCheck ENABLED باشد، گفتگو همچنین حاوی پیوندی به شرایط و ضوابط برای Navigation SDK خواهد بود. در صورتی که کاربر این شرایط را نپذیرد، callback با خطای TERMS_NOT_ACCEPTED فراخوانی خواهد شد.

توجه داشته باشید که Navigator یک تک تن است. اگر این روش را چندین بار فراخوانی کنید، هر تماس همان Navigator را برمی گرداند.

مولفه های

فعالیت	Activity برای نشان دادن گفتگوی شرایط و ضوابط، در صورتی که هنوز پذیرفته نشده باشند
پاسخ به تماس	یک تماس برگشتی که هنگامی که Navigator آماده باشد فعال می شود یا خطایی رخ می دهد
شرایط بررسی	نشان می دهد که آیا بررسی شرایط و ضوابط باید نادیده گرفته شود

public void getNavigator (فعالیت فعالیت، پاسخ به تماس NavigationApi.NavigatorListener )

معادل getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED} .

مولفه های

فعالیت
پاسخ به تماس

همچنین ببینید

• getNavigator(Activity, NavigatorListener, TermsAndConditionsCheckOption)

public void getNavigatorNoToS (برنامه کاربردی، NavigationApi.NavigatorListener )

نمونه Navigator را به دست می آورد.

شرایط و ضوابط را دور می زند.

توجه داشته باشید که Navigator یک تک تن است. اگر این روش را چندین بار فراخوانی کنید، هر تماس همان Navigator را برمی گرداند.

مولفه های

کاربرد	Application فعلی
پاسخ به تماس	یک تماس برگشتی که هنگامی که Navigator آماده باشد فعال می شود یا خطایی رخ می دهد.

استاتیک عمومی RoadSnappedLocationProvider getRoadSnappedLocationProvider (برنامه کاربردی)

نمونه‌ای از RoadSnappedLocationProvider را دریافت می‌کند که می‌تواند برای اشتراک در مکان‌های کاربران جاده‌ای استفاده شود. توجه داشته باشید که اشتراک در به‌روزرسانی‌های مکان تصادفی ممکن است باعث تخلیه باتری یا جمع‌آوری ناخواسته داده‌های موقعیت مکانی کاربر در صورت اجرا در پس‌زمینه شود.

قبل از فراخوانی این متد باید یک Navigator با موفقیت به دست آید، در غیر این صورت null برمی‌گرداند.

مولفه های

کاربرد	Application فعلی

عمومی استاتیک NavigationTransactionRecorder getTransactionRecorder (برنامه کاربردی)

نمونه ای از NavigationTransactionRecorder را دریافت می کند که می تواند برای ثبت تراکنش های مربوط به ناوبری استفاده شود.

این کلاس باید در صورت و فقط در صورتی استفاده شود که شرکت شما توسط Google بر اساس هر تراکنش صورت‌حساب دریافت کند.

قبل از فراخوانی این متد باید یک Navigator با موفقیت به دست آید، در غیر این صورت null برمی‌گرداند.

مولفه های

کاربرد	Application فعلی

همگام سازی استاتیک عمومی void initForegroundServiceManager (برنامه کاربردی، شناسه اطلاع رسانی عدد صحیح، پیام پیش فرض رشته، ارائه دهنده NotificationContentProvider )

نمونه ForegroundServiceManager را با آرگومان های ارائه شده راه اندازی می کند.

این فقط در صورتی فراخوانی می شود که بخواهید هر یک از پارامترهای پیش فرض را تغییر دهید. در غیر این صورت، مستقیماً با getForegroundServiceManager(Application) تماس بگیرید. این متد فقط یک بار می تواند فراخوانی شود و باید قبل از getForegroundServiceManager(Application) فراخوانی شود.

مولفه های

کاربرد	Application فعلی
شناسه اطلاع رسانی	شناسه اعلان برای اعلان مداوم
پیام پیش فرض	پیام پیش‌فرض که اگر provider مشخص نشده باشد نشان داده می‌شود
ارائه دهنده	اجرای NotificationContentProvider

بازنشانی پوچ استاتیک عمومی شرایط پذیرفته شد (برنامه کاربردی)

بازنشانی شرایط و ضوابط - برای آزمایش. اگر می‌خواهید گفتگوی شرایط و ضوابط را آزمایش کنید، قبل از هر تماسی با NavigationApi یک تماس به آن اضافه کنید.

مولفه های

کاربرد	برنامه فعلی

public void showTermsAndConditionsDialog (فعالیت فعالیت، نام شرکت رشته، عنوان رشته، شنونده NavigationApi.OnTermsResponseListener )

گفتگویی را نمایش می‌دهد که کاربر را با استفاده از ظاهر و احساس پیش‌فرض هدایت می‌کند تا شرایط و ضوابط ناوبری Google را بپذیرد.

مولفه های

فعالیت
نام شرکت
عنوان
شنونده

همچنین ببینید

• for a description of the different parameters.

Public void showTermsAndConditionsDialog (فعالیت فعالیت، نام شرکت رشته، عنوان رشته، TermsAndConditionsUIParams uiParams، NavigationApi.OnTermsResponseListener شنونده، TermsAndConditionsCheckOption TermsAndConditionsCheck)

گفتگویی را نمایش می دهد که کاربر را به پذیرش شرایط و ضوابط ناوبری Google هدایت می کند. در صورت مشخص شدن، شنونده در رشته UI فراخوانی می شود که نشان می دهد کاربر شرایط و ضوابط را می پذیرد یا خیر.

توجه داشته باشید که حتی اگر کاربر قبلاً پذیرفته باشد، گفتگو ظاهر می شود. این فقط در صورتی باید فراخوانی شود که areTermsAccepted(Application) false باشد، زیرا امکان ندارد کاربر شرایط و ضوابط را نپذیرد.

مولفه های

فعالیت	Activity که دیالوگ در آن نشان داده خواهد شد
نام شرکت	نام شرکت شما، که در گفتگوی شرایط و ضوابط نمایش داده می شود
عنوان	عنوان گفتگو اگر تهی باشد، گفتگو از عنوان پیش فرض استفاده می کند.
uiParams	پارامترهای مورد استفاده برای سفارشی کردن ظاهر و احساس گفتگو. اگر null باشد، از ظاهر و احساس پیش‌فرض استفاده می‌شود.
شنونده	یک تماس برگشتی اختیاری که وقتی کاربر شرایط و ضوابط را بپذیرد یا رد کند، فعال می شود
TermsAndConditionsCheckOption	TermsAndConditionsCheckOption که گزینه هایی را برای بررسی شرایط و ضوابط مشخص می کند

public void showTermsAndConditionsDialog (فعالیت فعالیت، String companyName، NavigationApi.OnTermsResponseListener شنونده)

گفتگویی را نمایش می‌دهد که کاربر را با استفاده از عنوان پیش‌فرض و ظاهر و ظاهر پیش‌فرض هدایت می‌کند تا شرایط و ضوابط ناوبری Google را بپذیرد.

مولفه های

فعالیت
نام شرکت
شنونده

همچنین ببینید

• for a description of the different parameters.