ناوبر

Navigator رابط عمومی

تک‌تنه‌ای که روش‌هایی را برای کنترل ناوبری ارائه می‌دهد.

همه متدها به جز setAudioGuidance و setHeadsUpNotificationEnabled که باید در رشته UI فراخوانی شوند، تضمین شده است که از نظر رشته ای ایمن هستند.

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

رابط	Navigator.ArrivalListener		امضاهایی را برای متدهایی تعریف می کند که هنگام رسیدن راننده به یک ایستگاه بین راه فراخوانی می شوند.
@رابط	Navigator.AudioGuidance		AudioGuidance مجموعه‌ای از پرچم‌ها است که برای تعیین انواع هشدارها و راهنمایی‌های صوتی در طول مسیریابی استفاده می‌شوند.
رابط	Navigator.RemainingTimeOrDistanceChangedListener		امضاها را برای متدهایی تعریف می کند که با تغییر زمان یا مسافت باقی مانده تا مقصد بعدی فراخوانی می شوند.
رابط	Navigator.RouteChangedListener		برای متدهایی که هنگام تغییر مسیر فراخوانی می شوند، امضاها را تعریف می کند.
enum	Navigator.RouteStatus		RouteStatus یک کد وضعیت است که نتیجه محاسبه مسیر را نشان می دهد که از طریق Future برگردانده شده توسط setDestination(Waypoint) قابل دسترسی است.

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

خلأ انتزاعی	پاک کردن () وضعیت داخلی Navigator را تمیز می کند.
خلأ انتزاعی	clearDestinations () تمام مقصدهای تعیین شده قبلی را پاک می کند و مسیرهای محاسبه شده را از نقشه حذف می کند.
خلأ انتزاعی	clearLicensePlateRestrictionInfo () اطلاعات پلاک را در مورد راننده فعلی پاک می کند.
خلأ انتزاعی	clearRemainingTimeOrDistanceChangedListener () شنونده را برای تغییرات در زمان یا مسافت باقیمانده پاک می کند.
نقطه راه انتزاعی	ادامه به مقصد بعدی () مقصد فعلی را حذف می کند.
چکیده ListenableResultFuture < RouteInfo >	fetchRouteInfo ( نقطه بین راه ، RoutingOptions RoutingOptions) اطلاعات مسیر را برای مسیرها بر اساس هر مقدار RoutingOptions.RoutingStrategy برمی‌گرداند.
RouteSegment انتزاعی	getCurrentRouteSegment () مرحله فعلی سفر را برمی‌گرداند.
زمان و فاصله انتزاعی	getCurrentTimeAndDistance () زمان و فاصله تخمینی از موقعیت فعلی تا مقصد فعلی را برمی‌گرداند.
فهرست چکیده < RouteSegment >	getRouteSegments () فهرستی از بخش‌های مسیر را برمی‌گرداند.
شبیه ساز انتزاعی	getSimulator () یک شی شبیه ساز را برای استفاده در طول آزمایش برمی گرداند.
فهرست انتزاعی< TimeAndDistance >	getTimeAndDistanceList () فهرستی از زمان‌ها و مسافت‌های مربوط به هر مقصد در مسیر فعلی را برمی‌گرداند که نشان‌دهنده زمان و فاصله تخمینی از موقعیت فعلی تا هر مقصد است.
فهرست چکیده < LatLng >	getTraveledRoute () مسیری را که تا کنون طی این جلسه راهنمایی طی شده است (از آخرین تماس با startGuidance() برمی گرداند.
بولی انتزاعی	isGuidanceRunning () اگر راهنما در حال اجرا باشد، true برمی‌گردد.
خلأ انتزاعی	setArrivalListener ( شنونده Navigator.ArrivalListener ) یک شنونده را برای رویدادهای ورود ثبت می کند.
خلأ انتزاعی	setAudioGuidance (راهنمای int) نوع هدایت صوتی (از جمله لرزش) را تنظیم می کند.
چکیده ListenableResultFuture < Navigator.RouteStatus >	setDestination (مقصد نقطه راه ، RoutingOptions routingOptions، DisplayOptions displayOptions) یک مقصد واحد را برای پیمایش تعیین می‌کند و هر مقصدی را که قبلاً تنظیم شده بود، لغو می‌کند.
چکیده ListenableResultFuture < Navigator.RouteStatus >	setDestination (مقصد نقطه راه ، گزینه‌های RoutingOptions ) یک مقصد واحد را برای پیمایش تعیین می‌کند و هر مقصدی را که قبلاً تنظیم شده بود، لغو می‌کند.
چکیده ListenableResultFuture < Navigator.RouteStatus >	setDestination (مقصد نقطه راه ) یک مقصد واحد را برای پیمایش تعیین می‌کند و هر مقصدی را که قبلاً تنظیم شده بود، لغو می‌کند.
چکیده ListenableResultFuture < Navigator.RouteStatus >	setDestinations (List< Waypoint > مقصدها، گزینه های RoutingOptions ) چندین مقصد را برای پیمایش تنظیم می‌کند، و هر مقصدی را که قبلاً تنظیم شده بود، لغو می‌کند.
چکیده ListenableResultFuture < Navigator.RouteStatus >	setDestinations (List< Waypoint > مقصدها، RoutingOptions RoutingOptions، DisplayOptions displayOptions) چندین مقصد را برای پیمایش تنظیم می‌کند، و هر مقصدی را که قبلاً تنظیم شده بود، لغو می‌کند.
چکیده ListenableResultFuture < Navigator.RouteStatus >	setDestinations (List< Waypoint > مقاصد) چندین مقصد را برای پیمایش تنظیم می‌کند، و هر مقصدی را که قبلاً تنظیم شده بود، لغو می‌کند.
خلأ انتزاعی	setHeadsUpNotification Enabled (بولی فعال) تنظیم می‌کند که اعلان‌های هدآپ نشان داده شوند یا خیر.
خلأ انتزاعی	setLicensePlateRestrictionInfo (int rawLicensePlateLastDigit، رشته LicensePlateCountryCode) اطلاعات پلاک را در مورد راننده فعلی تنظیم می کند.
خلأ انتزاعی	setRemainingTimeOrDistanceChangedListener (int timeChangeThresholdSeconds، int distanceChangeThresholdMeters، Navigator.RemainingTimeOrDistanceChangedListener ) شنونده را برای زمانی که زمان یا مسافت باقی مانده تا مقصد بیش از یک آستانه مشخص تغییر می کند، ثبت می کند.
خلأ انتزاعی	setRouteChangedListener (شنونده Navigator.RouteChangedListener ) شنونده را برای رویدادهای تغییر مسیر ثبت می کند.
خلأ انتزاعی	setSpeedingListener ( SpeedingListener speedingListener) یک SpeedingListener را برای درصدی بالاتر از حد مجاز سرعتی که راننده در حال حاضر با آن رانندگی می کند، ثبت می کند.
خلأ انتزاعی	startGuidance (Intent ResumeIntent) همان startGuidance() است، اما یک intent را مشخص می کند که می تواند برای از سرگیری برنامه از اعلان نوار وضعیت ناوبر استفاده شود.
خلأ انتزاعی	راهنمای شروع () اگر مقصدی تعیین شده باشد و مسیری برای آن محاسبه شده باشد، راهنمای ناوبری گام به گام برای مسیر شروع می شود.
خلأ انتزاعی	stopGuidance () راهنمای ناوبری گام به گام را متوقف می کند.

روش های عمومی

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

وضعیت داخلی Navigator را تمیز می کند.

توجه: فراخوانی این متد، درخواست‌های معلق به setDestinations(List ) را لغو می‌کند setDestinations(List ) .

انتزاعی عمومی void clearDestinations ()

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

چکیده عمومی void clearLicensePlateRestrictionInfo ()

اطلاعات پلاک را در مورد راننده فعلی پاک می کند. این فقط برای تماس‌های setDestination که پس از تنظیم این مقدار انجام می‌شوند اعمال می‌شود.

انتزاع عمومی void clearRemainingTimeOrDistanceChangedListener ()

شنونده را برای تغییرات در زمان یا مسافت باقیمانده پاک می کند.

نقطه راه انتزاعی عمومی continueToNextDestination ()

مقصد فعلی را حذف می کند. پس از این تماس، راهنمایی به سمت مقصد بعدی خواهد بود و اطلاعاتی در مورد مقصد قدیمی در دسترس نیست.

برمی گرداند

• راهنمای نقطه راه اکنون به سمت مسیر حرکت می کند، یا اگر نقطه دیگری باقی نمانده بود، باطل می شود

چکیده عمومی ListenableResultFuture < RouteInfo > fetchRouteInfo ( مسیر نقطه، RoutingOptions routingOptions)

اطلاعات مسیر را برای مسیرها بر اساس هر مقدار RoutingOptions.RoutingStrategy برمی‌گرداند. RoutingOptions.RoutingStrategy نادیده گرفته می شود زیرا این روش اطلاعات مسیر را برای همه استراتژی های مسیریابی برمی گرداند.

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

مولفه های

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

برمی گرداند

• آینده بازگشتی

انتزاعی عمومی RouteSegment getCurrentRouteSegment ()

مرحله فعلی سفر را برمی‌گرداند. این RouteSegment موقعیت شروع خود را به عنوان آخرین موقعیت شناخته شده (جاده ای) دستگاه خواهد داشت.

برمی گرداند

• یک شی قطعه مسیر، یا اگر مسیر فعلی وجود نداشته باشد، null

چکیده عمومی TimeAndDistance getCurrentTimeAndDistance ()

زمان و فاصله تخمینی از موقعیت فعلی تا مقصد فعلی را برمی‌گرداند.

برمی گرداند

• یک شی زمان و فاصله، یا اگر مسیر فعلی وجود نداشته باشد، null

فهرست انتزاعی عمومی< RouteSegment > getRouteSegments ()

فهرستی از بخش‌های مسیر را برمی‌گرداند. مقصد هر بخش برگشتی با مقصدی که توسط setDestination (های) تنظیم شده است مطابقت دارد.

شبیه ساز انتزاعی عمومی getSimulator ()

یک شی شبیه ساز را برای استفاده در طول آزمایش برمی گرداند.

فهرست انتزاعی عمومی< TimeAndDistance > getTimeAndDistanceList ()

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

فهرست انتزاعی عمومی< LatLng > getTraveledRoute ()

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

بولین انتزاعی عمومی isGuidanceRunning ()

اگر راهنما در حال اجرا باشد، true برمی‌گردد. توجه داشته باشید که راهنمایی تنها زمانی اجرا می شود که مسیری به مقصد محاسبه شده و startGuidance() فراخوانی شود.

انتزاع عمومی void setArrivalListener ( شنونده Navigator.ArrivalListener )

یک شنونده را برای رویدادهای ورود ثبت می کند. تمام شنوندگان ثبت شده قبلی را لغو می کند.

توجه: برای جلوگیری از نشت حافظه، setNavArrivalListener(null) باید زمانی فراخوانی شود که شنونده دیگر مورد نیاز نباشد.

مولفه های

شنونده	شنونده برای ثبت نام برای پاک کردن شنونده ثبت شده قبلی، می توان آن را روی null تنظیم کرد.

انتزاعی عمومی void setAudioGuidance (int guidance)

نوع هدایت صوتی (از جمله لرزش) را تنظیم می کند. به طور پیش‌فرض، لرزش، صدا و صدا از طریق بلوتوث (در صورت وجود) فعال هستند.

این متد باید در رشته UI فراخوانی شود.

مولفه های

راهنمایی	ترکیبی از پرچم‌های Navigator.AudioGuidance که مشخص می‌کند کدام نوع هدایت صوتی باید فعال شود

چکیده عمومی ListenableResultFuture < Navigator.RouteStatus > setDestination (مقصد نقطه راه ، RoutingOptions routingOptions، DisplayOptions displayOptions)

یک مقصد واحد را برای پیمایش تعیین می‌کند و هر مقصدی را که قبلاً تنظیم شده بود، لغو می‌کند. اگر مسیری از مکان کاربر به مقصد مشخص شده پیدا شود، آینده برگشتی روی OK تنظیم می شود.

مولفه های

مقصد	مقصد جدیدی که قرار است تعیین شود
گزینه های مسیریابی	گزینه هایی که برای ایجاد مسیر مورد استفاده قرار خواهند گرفت
نمایش گزینه ها	گزینه هایی که برای نمایش مسیر استفاده خواهند شد

برمی گرداند

• آینده بازگشتی

پرتاب می کند

NullPointerException	اگر مقصد داده شده صفر باشد

چکیده عمومی ListenableResultFuture < Navigator.RouteStatus > setDestination (مقصد نقطه راه ، گزینه های RoutingOptions )

یک مقصد واحد را برای پیمایش تعیین می‌کند و هر مقصدی را که قبلاً تنظیم شده بود، لغو می‌کند. اگر مسیری از مکان کاربر به مقصد مشخص شده پیدا شود، آینده برگشتی روی OK تنظیم می شود. از DisplayOptions پیش فرض برای نمایش مسیر استفاده می شود.

مولفه های

مقصد	مقصد جدیدی که قرار است تعیین شود
گزینه ها	گزینه هایی که برای ایجاد مسیر مورد استفاده قرار خواهند گرفت

برمی گرداند

• آینده بازگشتی

پرتاب می کند

NullPointerException	اگر مقصد داده شده صفر باشد

چکیده عمومی ListenableResultFuture < Navigator.RouteStatus > setDestination (مقصد نقطه راه )

یک مقصد واحد را برای پیمایش تعیین می‌کند و هر مقصدی را که قبلاً تنظیم شده بود، لغو می‌کند. اگر مسیری از مکان کاربر به مقصد مشخص شده پیدا شود، آینده برگشتی روی OK تنظیم می شود. برای یافتن مسیر RoutingOptions پیش‌فرض و برای نمایش آن از DisplayOptions پیش‌فرض استفاده می‌شود.

مولفه های

مقصد	مقصد جدیدی که قرار است تعیین شود

برمی گرداند

• آینده بازگشتی

پرتاب می کند

NullPointerException	اگر مقصد داده شده صفر باشد

چکیده عمومی ListenableResultFuture < Navigator.RouteStatus > setDestinations (List< Waypoint > مقاصد، گزینه های RoutingOptions )

چندین مقصد را برای پیمایش تنظیم می‌کند، و هر مقصدی را که قبلاً تنظیم شده بود، لغو می‌کند. اگر مسیری از مکان کاربر به مقصد مشخص شده پیدا شود، آینده برگشتی روی OK تنظیم می شود. از DisplayOptions پیش فرض برای نمایش مسیر استفاده می شود.

مولفه های

مقاصد	لیست مقصد جدیدی که قرار است تنظیم شود
گزینه ها	گزینه هایی که برای ایجاد مسیر مورد استفاده قرار خواهند گرفت

برمی گرداند

• آینده بازگشتی

چکیده عمومی ListenableResultFuture < Navigator.RouteStatus > setDestinations (List< Waypoint > مقصدها، RoutingOptions RoutingOptions، DisplayOptions displayOptions)

چندین مقصد را برای پیمایش تنظیم می‌کند، و هر مقصدی را که قبلاً تنظیم شده بود، لغو می‌کند. اگر مسیری از مکان کاربر به مقصد مشخص شده پیدا شود، آینده برگشتی روی OK تنظیم می شود.

مولفه های

مقاصد	لیست مقصد جدیدی که قرار است تنظیم شود
گزینه های مسیریابی	گزینه هایی که برای ایجاد مسیر مورد استفاده قرار خواهند گرفت
نمایش گزینه ها	گزینه هایی که برای نمایش مسیر استفاده خواهند شد

برمی گرداند

• آینده بازگشتی

چکیده عمومی ListenableResultFuture < Navigator.RouteStatus > setDestinations (List< Waypoint > مقصدها)

چندین مقصد را برای پیمایش تنظیم می‌کند، و هر مقصدی را که قبلاً تنظیم شده بود، لغو می‌کند. اگر مسیری از مکان کاربر به مقصد مشخص شده پیدا شود، آینده برگشتی روی OK تنظیم می شود. برای یافتن مسیر RoutingOptions پیش‌فرض و برای نمایش آن از DisplayOptions پیش‌فرض استفاده می‌شود.

مولفه های

مقاصد	لیست مقصد جدیدی که قرار است تنظیم شود

برمی گرداند

• آینده بازگشتی

انتزاع عمومی void setHeadsUpNotification Enabled (بولی فعال)

تنظیم می‌کند که اعلان‌های هدآپ نشان داده شوند یا خیر. به طور پیش فرض، اعلان فعال است. رویدادهای Heads-up رویدادهای راهنمایی مانند چرخش و غیره هستند که زمانی نمایش داده می شوند که هیچ نقشه ای قابل مشاهده نباشد.

این متد باید در رشته UI فراخوانی شود.

مولفه های

فعال شد	یک پرچم برای نشان دادن اینکه آیا اعلان‌های heads-up باید فعال شوند یا خیر

چکیده عمومی void setLicensePlateRestrictionInfo (int rawLicensePlateLastDigit، رشته مجوزPlateCountryCode)

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

مولفه های

rawLicensePlateLastDigit	آخرین رقم پلاک (باید بین 0 تا 9 باشد).
LicensePlateCountryCode	در حال حاضر ما از اندونزی (ID) و برزیل (BZ) پشتیبانی می کنیم. ممکن است در آینده از سایرین پشتیبانی شود و شما آزاد هستید که این اطلاعات را فعالانه ارائه دهید.

مجموعه خلأ انتزاعی عمومی RemainingTimeOrDistanceChangedListener (int timeChangeThresholdSeconds، int distanceChangeThresholdMeters، Navigator.RemainingTimeOrDistanceChangedListener )

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

شنونده را می توان در نتیجه (مثلا) حرکت کاربر، تغییر در شرایط ترافیکی، تغییر مسیر، تغییر در مقصد، یا زمانی که زمان و مسافت باقی مانده برای اولین بار مشخص شد فراخوانی کرد.

توجه: برای جلوگیری از نشت حافظه، زمانی که شنونده دیگر مورد نیاز نیست clearNavProgressionListener() باید فراخوانی شود.

مولفه های

timeChangeThresholdSeconds	اگر تغییر مطلق در زمان باقیمانده در ثانیه بیشتر یا مساوی این مقدار باشد، شنونده فراخوانی می شود. این آستانه نباید منفی باشد.
distanceChangeThresholdMeters	اگر تغییر مطلق در فاصله باقیمانده بر حسب متر بزرگتر یا مساوی این مقدار باشد، شنونده فراخوانی می شود. این آستانه نباید منفی باشد.
شنونده	شنونده برای ثبت نام نباید null باشد .

انتزاعی عمومی void setRouteChangedListener ( شنونده Navigator.RouteChangedListener )

شنونده را برای رویدادهای تغییر مسیر ثبت می کند. همه شنوندگان ثبت شده قبلی را لغو می کند.

توجه: برای جلوگیری از نشت حافظه، setNavRouteChangeListener(null) باید زمانی فراخوانی شود که شنونده دیگر مورد نیاز نباشد.

مولفه های

شنونده	شنونده برای ثبت نام برای پاک کردن شنونده ثبت شده قبلی، می توان آن را روی null تنظیم کرد.

انتزاع عمومی void setSpeedingListener ( SpeedingListener speedingListener)

یک SpeedingListener را برای درصدی بالاتر از حد مجاز سرعتی که راننده در حال حاضر با آن رانندگی می کند، ثبت می کند.

با تنظیم یک SpeedingListener null یا عدم تنظیم هیچ، هیچ داده فید سرعتی دریافت نخواهید کرد.

مولفه های

سرعت شنونده

راهنمای شروع خالی انتزاعی عمومی (Intent ResumeIntent)

همان startGuidance() است، اما یک intent را مشخص می کند که می تواند برای از سرگیری برنامه از اعلان نوار وضعیت ناوبر استفاده شود. بدون این هدف، امکان از سرگیری برنامه از نوار وضعیت وجود ندارد.

مولفه های

resumeIntent	قصد از سرگیری برنامه در اکثر موارد مقدار بازگردانده شده توسط android.app.Activity#getIntent() مناسب خواهد بود.

راهنمای شروع خلأ انتزاعی عمومی ()

اگر مقصدی تعیین شده باشد و مسیری برای آن محاسبه شده باشد، راهنمای ناوبری گام به گام برای مسیر شروع می شود. اگر مسیری هنوز محاسبه نشده باشد، راهنمایی گام به گام پس از محاسبه شروع می شود.

برای توقف سرویس ناوبری باید به طور صریح stopGuidance() را فراخوانی کنید. سرویس ناوبری به صورت خودکار پس از ورود متوقف نمی شود. اگر می خواهید سرویس ناوبری را به محض ورود متوقف کنید، باید با stopGuidance() در NavArrivalListener تماس بگیرید.

توجه: این روش موقعیت Camera را تغییر نمی دهد.

راهنمای خلأ انتزاعی عمومی ()

راهنمای ناوبری گام به گام را متوقف می کند.