یک جزء ناوبری در یک برنامه این قطعه ساده ترین راه برای استفاده از ناوبری در یک برنامه است. این یک بسته بندی در اطراف نمایی از یک نقشه ناوبری است تا به طور خودکار نیازهای چرخه زندگی لازم را انجام دهد. این کامپوننت به عنوان یک قطعه، می تواند به سادگی با XML زیر به فایل طرح بندی یک فعالیت اضافه شود.
<fragment class="com.google.android.libraries.navigation.SupportNavigationFragment" android:layout_width="match_parent" android:layout_height="match_parent"/>
خلاصه سازنده عمومی
خلاصه روش عمومی
دوربین | دریافت دوربین () یک شی دوربین را برمیگرداند که میتوان از آن برای تغییر نمای نقشه استفاده کرد. |
نقشه ناوبری | getMap () شیئی را برمی گرداند که می توان از آن برای افزودن محتوا به نقشه استفاده کرد. |
خالی | onConfigurationChanged (پیکربندی پیکربندی) |
چشم انداز | onCreateView (پرکننده LayoutInflater، محفظه ViewGroup، Bundle savedInstanceState) |
خالی | |
خالی | onLowMemory () |
خالی | در مکث () |
خالی | در ادامه () |
خالی | onSaveInstanceState (Bundle outState) |
خالی | onStart () |
خالی | onStop () |
خالی | setCalloutInfoDisplayModeOverride ( NavigationCalloutDisplayMode calloutInfoDisplayModeOverride) حالت نمایش پیشفرض پیامهای ETA را در حین پیمایش لغو میکند. |
خالی | setCalloutInfoFormatOverride ( RouteCalloutInfoFormat calloutInfoFormatOverride) حالت قالب اطلاعات فراخوان را برای فراخوان های مسیر تنظیم می کند. |
خالی | setCompassEnabled (بولی فعال) تعیین می کند که قطب نما قابل مشاهده باشد یا خیر. |
خالی | setCustomControl (نمایش کنترل، موقعیت CustomControlPosition ) یک نمای کنترل سفارشی را تنظیم می کند که در موقعیت داده شده در رابط کاربری ناوبری ظاهر می شود. |
خالی | setEtaCardEnabled (بولی فعال) تنظیم می کند که آیا کارت ETA در حین پیمایش قابل مشاهده باشد یا خیر. |
خالی | setForceNightMode (int forceNightMode) |
خالی | setHeaderEnabled (بولی فعال) تنظیم می کند که آیا هدر پیمایش گام به گام در حین پیمایش قابل مشاهده باشد یا خیر. |
خالی | setOnNightModeChangedListener ( شنونده NavigationView.OnNightModeChangedListener ) شنونده ای را تنظیم می کند که هنگام ورود یا خروج رابط کاربری از حالت شبانه مطلع می شود. |
خالی | setOnRecenterButtonClickedListener ( شنونده NavigationView.OnRecenterButtonClickedListener ) شنوندهای را تنظیم میکند که با کلیک کردن روی دکمه جدیدتر به او اطلاع داده میشود. |
خالی | setRecenterButtonEnabled (بولی فعال) تنظیم می کند که آیا دکمه مرکز مجدد باید نشان داده شود یا خیر. |
خالی | setSpeedAlertOptions ( SpeedAlertOptions speedAlertOptions) SpeedAlertOptions برای سفارشیسازی آستانههای راهاندازی برای SpeedAlertSeverity تنظیم میکند. |
خالی | setSpeedLimitIconEnabled (بولی فعال) مشخص می کند که آیا نماد محدودیت سرعت نشان داده شود. |
خالی | setSpeedometerIconEnabled (بولی فعال) مشخص می کند که آیا نماد سرعت سنج نشان داده شود یا خیر. |
خالی | setSpeedometerUiOptions ( SpeedometerUiOptions speedAlertUiOptions) پیکربندی سرعت سنج UI SpeedometerUiOptions بر اساس SpeedAlertSeverity تنظیم می کند. |
خالی | setStylingOptions ( StylingOptions stylingOptions) چند گزینه سبک برای رابط کاربری پیمایش تنظیم می کند. |
خالی | setTrafficIncidentCardsEnabled (بولی فعال) تنظیم میکند که کارتهای حوادث ترافیکی زمانی که کاربر روی نماد حادثه ترافیک کلیک میکند نشان داده شود یا خیر. |
خالی | setTrafficPromptsEnabled (بولی فعال) تنظیم میکند که آیا درخواستهای ترافیک باید نشان داده شوند یا خیر. |
خلاصه روش ارثی
سازندگان عمومی
عمومی SupportNavigationFragment ()
روش های عمومی
دوربین عمومی getCamera ()
یک شی دوربین را برمیگرداند که میتوان از آن برای تغییر نمای نقشه استفاده کرد.
برمی گرداند
- شی
Camera
مرتبط با این قطعه
نقشه ناوبری عمومی getMap ()
شیئی را برمی گرداند که می توان از آن برای افزودن محتوا به نقشه استفاده کرد.
public void onConfigurationChanged (پیکربندی پیکربندی)
مولفه های
پیکربندی |
---|
نمای عمومی در CreateView (پرکننده LayoutInflater، محفظه ViewGroup، Bundle savedInstanceState)
مولفه های
باد کردن | |
---|---|
ظرف | |
savedInstanceState |
خلأ عمومی onDestroyView ()
خالی عمومی در LowMemory ()
خلأ عمومی در توقف ()
خالی عمومی در رزومه ()
void عمومی onSaveInstanceState (Bundle outState)
مولفه های
خارج از ایالت |
---|
خالی عمومی در شروع ()
خلأ عمومی onStop ()
مجموعه خالی عمومی CalloutInfoDisplayModeOverride ( NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
حالت نمایش پیشفرض پیامهای ETA را در حین پیمایش لغو میکند. با ارسال null حالت نمایش پیش فرض بازنشانی می شود.
مولفه های
calloutInfoDisplayModeOverride | حالت نمایش دلخواه جدید |
---|
public void setCalloutInfoFormatOverride ( RouteCalloutInfoFormat calloutInfoFormatOverride)
حالت قالب اطلاعات فراخوان را برای فراخوان های مسیر تنظیم می کند. اگر این روش فراخوانی نشود، فراخوانها از رفتاری که توسط RouteCalloutInfoFormat.DEFAULT تعریف شده است، پیروی میکنند.
مولفه های
calloutInfoFormatOverride | فرمت فراخوانی دلخواه جدید |
---|
public void setCompassEnabled (بولی فعال)
تعیین می کند که قطب نما قابل مشاهده باشد یا خیر. این روش فقط باید در رشته UI فراخوانی شود.
مولفه های
فعال شد |
---|
public void setCustomControl (کنترل مشاهده، موقعیت CustomControlPosition )
یک نمای کنترل سفارشی را تنظیم می کند که در موقعیت داده شده در رابط کاربری ناوبری ظاهر می شود. اگر هر کنترل سفارشی از قبل در موقعیت داده شده وجود داشته باشد، جایگزین خواهد شد. فراخوانی این روش با یک مقدار کنترل تهی، کنترل سفارشی را در موقعیت داده شده حذف می کند. اگر کنترل قبلاً در موقعیت دیگری اضافه شده باشد یا قبلاً یک والد داشته باشد، نادیده گرفته می شود. این روش فقط باید در رشته UI فراخوانی شود.
مولفه های
کنترل | نمایی که در رابط کاربری ناوبری قرار می گیرد |
---|---|
موقعیت | تعیین می کند که کنترل سفارشی در UI نسبت به کنترل های داخلی کجا قرار می گیرد. |
public void setEtaCardEnabled (بولی فعال)
تنظیم می کند که آیا کارت ETA در حین پیمایش قابل مشاهده باشد یا خیر. این روش فقط باید در رشته UI فراخوانی شود.
مولفه های
فعال شد |
---|
حالت خالی عمومی setForceNightMode (int forceNightMode)
مولفه های
forceNightMode |
---|
public void setHeaderEnabled (بولی فعال)
تنظیم می کند که آیا هدر پیمایش گام به گام در حین پیمایش قابل مشاهده باشد یا خیر. این روش فقط باید در رشته UI فراخوانی شود.
مولفه های
فعال شد |
---|
public void setOnNightModeChangedListener ( شنونده NavigationView.OnNightModeChangedListener )
شنونده ای را تنظیم می کند که هنگام ورود یا خروج رابط کاربری از حالت شبانه مطلع می شود. این روش فقط باید در رشته UI فراخوانی شود.
توجه: برای جلوگیری از نشت حافظه، setOnNightModeChangedListener(null)
باید زمانی فراخوانی شود که شنونده دیگر مورد نیاز نباشد.
مولفه های
شنونده | شنونده ای که هنگام ورود یا خروج UI از حالت شب مطلع می شود |
---|
public void setOnRecenterButtonClickedListener ( شنونده NavigationView.OnRecenterButtonClickedListener )
شنوندهای را تنظیم میکند که با کلیک کردن روی دکمه جدیدتر به او اطلاع داده میشود. این روش فقط باید در رشته UI فراخوانی شود.
توجه: برای جلوگیری از نشت حافظه، setOnRecenterButtonClickedListener(null)
باید زمانی فراخوانی شود که شنونده دیگر مورد نیاز نباشد.
مولفه های
شنونده | شنونده ای که با کلیک روی دکمه جدیدتر مطلع می شود |
---|
public void setRecenterButtonEnabled (بولی فعال)
تنظیم می کند که آیا دکمه مرکز مجدد باید نشان داده شود یا خیر. این روش فقط باید در رشته UI فراخوانی شود.
مولفه های
فعال شد |
---|
setSpeedAlertOptions با اعتبار عمومی ( SpeedAlertOptions speedAlertOptions)
SpeedAlertOptions
برای سفارشیسازی آستانههای راهاندازی برای SpeedAlertSeverity
تنظیم میکند.
میتوانید از این روش برای سفارشیسازی آستانههای هشدار سرعت در درصد برای هشدارهای MINOR
و MAJOR
استفاده کنید. همچنین می توانید از این روش برای پیکربندی زمان مورد نیاز برای ارتقاء هشدارهای سرعت از MINOR
به MAJOR
بر حسب ثانیه استفاده کنید.
با تنظیم یک SpeedAlertOptions
null
یا عدم تنظیم هیچ، هشدار سرعت پیشفرض NavSDK نمایش داده میشود: هشدار سرعت متن قرمز را در پسزمینه سفید/تاریک برای حالت روز/شب به ترتیب زمانی که سرعت کمتر از 5 مایل در ساعت یا بیش از 10 کیلومتر بر ساعت است نشان میدهد. محدود کنید، و متن سفید را در پسزمینه قرمز هنگام سرعت بیش از 5 مایل در ساعت یا 10 کیلومتر در ساعت نشان میدهد.
مولفه های
speedAlertOptions |
---|
public void setSpeedLimitIconEnabled (بولی فعال)
مشخص می کند که آیا نماد محدودیت سرعت نشان داده شود. این روش را فقط در رشته UI فراخوانی کنید.
هنگامی که فعال باشد، یک نماد محدودیت سرعت که نشان دهنده محدودیت سرعت جاده است، در گوشه شروع پایین هنگام راهنمایی ظاهر می شود. این نماد فقط در مکانهایی ظاهر میشود که دادههای محدودیت سرعت قابل اعتماد در دسترس هستند. هنگامی که نماد سرعت سنج قابل مشاهده است، آنها پیوست می شوند.
اگر دکمه جدیدتر فعال باشد، نماد محدودیت سرعت به طور موقت با نمایش دکمه جدیدتر پنهان می شود.
توجه: رانندگان باید تمام علائم نصب شده در جاده را رعایت کنند و از نماد محدودیت سرعت فقط به عنوان مرجع استفاده کنند. صحت داده های محدودیت سرعت را نمی توان تضمین کرد. میتوانید با تشکیل پرونده در پورتال پشتیبانی Google Cloud، نادرستی در دادههای محدودیت سرعت ما را گزارش کنید.
مولفه های
فعال شد |
---|
عمومی void setSpeedometerIconEnabled (بولی فعال)
مشخص می کند که آیا نماد سرعت سنج نشان داده شود یا خیر. این روش را فقط در رشته UI فراخوانی کنید.
هنگامی که فعال باشد، نماد سرعت سنج که سرعت خودرو را نشان می دهد در گوشه شروع پایین هنگام راهنمایی ظاهر می شود. وقتی نماد محدودیت سرعت قابل مشاهده است، آنها متصل می شوند و سپس سرعت سنج بسته به شدت سرعت می تواند رنگ های مختلفی برای متن و پس زمینه داشته باشد.
فعال کردن نماد سرعت سنج همچنین نماد محدودیت سرعت را به طور کلی فعال می کند، با این حال می توانید از setSpeedLimitIconEnabled(boolean)
برای غیرفعال کردن/فعال کردن نماد محدودیت سرعت به طور جداگانه استفاده کنید.
اگر دکمه جدیدتر فعال باشد، نماد سرعت سنج به طور موقت با نمایش دکمه جدیدتر پنهان می شود.
مولفه های
فعال شد |
---|
مجموعه فضای خالی عمومی SpeedometerUiOptions ( SpeedometerUiOptions speedAlertUiOptions)
پیکربندی سرعت سنج UI SpeedometerUiOptions
بر اساس SpeedAlertSeverity
تنظیم می کند. این روش را فقط در رشته UI فراخوانی کنید.
با تنظیم یک SpeedometerUiOptions
null
، در صورت تنظیم، گزینه قبلی را پاک می کنید. هنگامی که هیچ SpeedometerUiOptions
پیکربندی نشده است، رابط کاربری سرعت سنج به تنظیمات پیشفرض NavSDK برای هشدارهای سرعت SpeedAlertSeverity
مختلف برمیگردد:
مولفه های
speedAlertUiOptions |
---|
public void setStylingOptions ( StylingOptions stylingOptions)
چند گزینه سبک برای رابط کاربری پیمایش تنظیم می کند. این روش فقط باید در رشته UI فراخوانی شود.
مولفه های
گزینه های سبک |
---|
public void setTrafficIncidentCardsEnabled (بولی فعال)
تنظیم میکند که کارتهای حوادث ترافیکی زمانی که کاربر روی نماد حادثه ترافیک کلیک میکند نشان داده شود یا خیر. این روش فقط باید در رشته UI فراخوانی شود.
مولفه های
فعال شد |
---|
public void setTrafficPromptsEnabled (بولی فعال)
تنظیم میکند که آیا درخواستهای ترافیک باید نشان داده شوند یا خیر. اعلانهای ترافیک به صورت دورهای ظاهر میشوند تا کاربر را در مورد شرایط ترافیک در طول مسیریابی بهروزرسانی کنند. این روش فقط باید در رشته UI فراخوانی شود.
مولفه های
فعال شد |
---|