תצוגת ניווט

מחלקה ציבורית NavigationView מרחיבה את הפריסה היחסית

תצוגה שמציגה מפה לצורך ניווט.

המשתמשים בכיתה הזו חייבים להעביר את כל השיטות של מחזור החיים מ-Activity או מ-Fragment שמכילים את התצוגה המפורטת הזו, אל השיטות המקבילות במחלקה הזו. באופן ספציפי, אתם צריכים לבצע העברה בשיטות הבאות:

אם תוסיפו את NavView אחרי שההורה Activity או Fragment כבר קיים את מחזור החיים של היצירה, צריך להפעיל את onCreate(Bundle), onStart() ו-onResume() באופן ידני כדי לאתחל אותו בצורה תקינה. באופן דומה, אם NavView מנותק מההורה Activity או Fragment שלו, צריך להפעיל ידנית את onPause(), onStop() ו-onDestroy() כדי למנוע דליפות.

הערה: מומלץ לא להוסיף ילדים לתצוגה הזו.

כל הקריאות ל-NavView צריכות להתבצע ב-thread של ממשק המשתמש.

סיכום של הכיתה המוצבת

משופר NavigationView.OnNightModeChangedListener ממשק עבור מאזין שיקבל התראה כשממשק המשתמש ייכנס ל'מצב לילה' או יצא ממנו.
משופר NavigationView.OnRecenterButtonClickedListener ממשק עבור מאזין שיקבל הודעה כשלוחצים על לחצן המרכז. 

סיכום של ערכים קבועים בירושה

סיכום שדות שעברו בירושה

סיכום של הבנייה הציבורית

NavigationView(הקשר לפי הקשר)
NavigationView(הקשר הקשר, מאפיין AttributeSet attrs)
NavigationView(הקשר הקשר, AttributeSet attrs, int defStyleAttr)

סיכום אמצעי תשלום ציבורי

מצלמה
getCamera()
מחזירה אובייקט מצלמה שניתן להשתמש בו כדי לשנות את אזור התצוגה של המפה.
NavigationMap
getMap()
מחזירה אובייקט שניתן להשתמש בו כדי להוסיף תוכן למפה.
void
onConfigurationChanged(הגדרת תצורה)
void
onCreate(Bundle savedInstanceState)
void
void
void
void
onSaveInstanceState(Bundle outState)
void
void
onStop()
void
onTrimMemory(רמת in)
void
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode הסברInfoDisplayModeOverride)
ההגדרה הזו מבטלת את מצב התצוגה המוגדר כברירת מחדל עבור נכסי יתרונות מרכזיים של מודעות טקסט מורחבות במהלך הניווט.
void
setCalloutInfoFormatOverride(RouteCalloutInfoFormat InfoFormatOverride)
מגדיר את מצב הפורמט של פרטי היתרונות המרכזיים עבור נכסי יתרונות מרכזיים של מסלול.
void
setCompassEnabled(אפשרות בוליאנית)
קובעת אם המצפן גלוי.
void
setCustomControl(פקד תצוגה, מיקום CustomControlPosition)
מגדיר תצוגת בקרה מותאמת אישית שתופיע במיקום הנתון בממשק המשתמש של הניווט.
void
setEtaCardEnabled(מופעל בוליאני)
הגדרה זו קובעת אם כרטיס זמן ההגעה המשוער יהיה גלוי במהלך הניווט.
void
setForceNightMode(int NightMode)
הגדרת הערך הנוכחי של ForceNightMode.
void
setHeaderEnabled(מופעל בוליאני)
הגדרה זו קובעת אם כותרת הניווט עם המסלול המפורט תוצג במהלך הניווט.
void
setOnNightModeChangedListener(NavigationView.OnNightModeChangedListener listener)
הגדרת מאזין שיקבל התראה מיידית על המצב הנוכחי של 'מצב לילה', ובכל פעם שממשק המשתמש נכנס ל'מצב לילה' או יוצא ממנו.
void
setOnRecenterButtonClickedListener(NavigationView.OnRecenterButtonClickedListener מאזין)
הגדרת מאזין שיקבל הודעה כשלוחצים על לחצן החזרה.
void
setRecenterButtonEnabled(מופעלת בוליאנית)
מגדירה אם הלחצן למרכז מחדש יוצג.
void
setSpeedAlertOptions(SpeedAlertOptions SpeedAlertOptions)
מגדיר את SpeedAlertOptions להתאמה אישית של ערכי הסף להפעלה עבור SpeedAlertSeverity.
void
setSpeedLimitIconEnabled(מופעלת בוליאנית)
מציינת אם סמל מגבלת המהירות מוצג.
void
setSpeedometerIconEnabled(מופעל בוליאני)
מציינת אם סמל מד המהירות מוצג.
void
setSpeedometerUiOptions(SpeedometerUiOptions SpeedometerUiOptions)
ההגדרה האישית של ממשק המשתמש של מד המהירות SpeedometerUiOptions מבוססת על SpeedAlertSeverity.
void
setStylingOptions(StylingOptions עיצובאפשרויות)
מגדירה כמה אפשרויות סגנון לממשק הניווט.
void
setTrafficIncidentCardsEnabled(מופעל בוליאני)
המדיניות הזו קובעת אם הכרטיסים של אירועי התנועה יוצגו כשהמשתמשים לוחצים על הסמל של אירוע תנועה.
void
setTrafficPromptsEnabled(מופעל בוליאני)
הגדרה זו קובעת אם להציג הודעות לגבי תנועת גולשים.

סיכום שיטות שעברו בירושה

בניינים ציבוריים

Public NavigationView (הקשר לפי הקשר)

פרמטרים
context

Public NavigationView (הקשר הקשר, נתוני מאפיין מסוג AttributeSet)

פרמטרים
context
attrs

Public NavigationView (Contextcontext, AttributeSet attrs, int defStyleAttr)

פרמטרים
context
attrs
defStyleAttr

שיטות ציבוריות

ציבורי מצלמה getCamera ()

מחזירה אובייקט מצלמה שניתן להשתמש בו כדי לשנות את אזור התצוגה של המפה. יש לקרוא לשיטה הזו רק ב-thread של ממשק המשתמש.

החזרות
  • האובייקט Camera המשויך לתצוגה המפורטת הזו

Public NavigationMap getMap ()

מחזירה אובייקט שניתן להשתמש בו כדי להוסיף תוכן למפה. צריך לקרוא לשיטה הזו רק ב-thread של ממשק המשתמש.

Public void onConfigurationChanged (Configuration config)

פרמטרים
הגדרה

Public void onCreate (Bundle savedInstanceState)

פרמטרים
savedInstanceState

Public void onDestroy ()

Public void onPause ()

Public void onResume ()

Public void onSaveInstanceState (Bundle outState)

פרמטרים
outState

Public void onStart ()

Public void onStop ()

Public void onTrimMemory (int level)

פרמטרים
רמה

ציבורי void setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayModeInfoDisplayModeOverride)

ההגדרה הזו מבטלת את מצב התצוגה המוגדר כברירת מחדל עבור נכסי יתרונות מרכזיים של מודעות טקסט מורחבות במהלך הניווט. הזנת ערך null מאפסת את מצב התצוגה שמוגדר כברירת מחדל.

פרמטרים
calloutInfoDisplayModeOverride את מצב התצוגה החדש הרצוי.

Public void setCalloutInfoFormatOverride (RouteCalloutInfoFormatInfoFormatOverride)

מגדיר את מצב הפורמט של פרטי היתרונות המרכזיים עבור נכסי יתרונות מרכזיים של מסלול. אם לא תתבצע קריאה לשיטה הזו, נכסי היתרונות המרכזיים יפעלו לפי ההתנהגות שהוגדרה על ידי RouteCalloutInfoFormat.DEFAULT.

פרמטרים
calloutInfoFormatOverride פורמט היתרונות המרכזיים החדש הרצוי.

Public void setCompassEnabled (boolean enabled)

קובעת אם המצפן גלוי. יש לקרוא לשיטה הזו רק ב-thread של ממשק המשתמש.

פרמטרים
פעיל

Public void setCustomControl (פקד תצוגה, מיקום CustomControlPosition)

מגדיר תצוגת בקרה מותאמת אישית שתופיע במיקום הנתון בממשק המשתמש של הניווט. אם כבר קיימת אמצעי בקרה בהתאמה אישית במיקום הנתון, היא תוחלף. הפעלת השיטה הזו עם ערך פקד ריק תגרום להסרת הפקד המותאם אישית במיקום הנתון. אם אמצעי הבקרה כבר נוסף במיקום אחר או שכבר יש לו הורה, המערכת תתעלם ממנו. יש לקרוא לשיטה הזו רק ב-thread של ממשק המשתמש.

פרמטרים
בקרה תצוגה מפורטת שתמוקם בממשק המשתמש של הניווט
position קובעת את המיקום של הפקד בהתאמה אישית בממשק המשתמש ביחס לפקדים המובנים.

Public void setEtaCardEnabled (boolean enabled)

הגדרה זו קובעת אם כרטיס זמן ההגעה המשוער יהיה גלוי במהלך הניווט. יש להפעיל את השיטה הזו רק ב-thread של ממשק המשתמש.

פרמטרים
פעיל

Public void setForceNightMode (int NightMode)

הגדרת הערך הנוכחי של ForceNightMode.

פרמטרים
nightMode

Public void setHeaderEnabled (boolean enabled)

הגדרה זו קובעת אם כותרת הניווט עם המסלול המפורט תוצג במהלך הניווט. יש לקרוא לשיטה הזו רק ב-thread של ממשק המשתמש.

פרמטרים
פעיל

ציבורי void setOnNightModeChangedListener (NavigationView.OnNightModeChangedListener listener)

הגדרת מאזין שיקבל התראה מיידית על המצב הנוכחי של 'מצב לילה', ובכל פעם שממשק המשתמש נכנס ל'מצב לילה' או יוצא ממנו. צריך להפעיל את השיטה הזו רק ב-thread של ממשק המשתמש.

הערה: כדי למנוע דליפות זיכרון, צריך להפעיל את setOnNightModeChangedListener(null) כשאין יותר צורך ב-listener.

פרמטרים
listener מאזינים שיקבלו התראה כשממשק המשתמש ייכנס למצב לילה או יוצא ממנו

Public void setOnRecenterButtonClickedListener (NavigationView.OnRecenterButtonClickedListener Listener)

הגדרת מאזין שיקבל הודעה כשלוחצים על לחצן החזרה. יש לקרוא לשיטה הזו רק ב-thread של ממשק המשתמש.

הערה: כדי למנוע דליפות זיכרון, צריך להפעיל את setOnRecenterButtonClickedListener(null) כשאין יותר צורך ב-listener.

פרמטרים
listener מאזין שיקבל הודעה לאחר לחיצה על לחצן המרכז

Public void setRecenterButtonEnabled (boolean enabled)

מגדירה אם הלחצן למרכז מחדש יוצג. צריך להפעיל את השיטה הזו רק ב-thread של ממשק המשתמש.

פרמטרים
פעיל

ציבורי void setSpeedAlertOptions (SpeedAlertOptions SpeedAlertOptions)

מגדיר את SpeedAlertOptions להתאמה אישית של ערכי הסף להפעלה עבור SpeedAlertSeverity.

אפשר להשתמש בשיטה הזו כדי להתאים אישית את ערכי הסף באחוזים להפעלת התראות המהירות גם בהתראות MINOR וגם בהתראות MAJOR. אפשר גם להשתמש בשיטה הזו כדי להגדיר את הזמן בשניות לשדרוג ההתראות על מהירות מ-MINOR ל-MAJOR.

אם מגדירים null SpeedAlertOptions או לא מגדירים שום התראה, תוצג התראת המהירות שמשמשת כברירת מחדל ב-NabSDK: הצגת טקסט אדום ברקע לבן/כהה למצב יום/לילה, בהתאמה, כשהמהירות נמוכה מ-10 קמ"ש או גבוהה מ-10 קמ"ש מעל מגבלת המהירות. בנוסף, יוצג טקסט לבן ברקע אדום כשמדובר במהירות של יותר מ-5 קמ"ש או 10 קמ"ש.

פרמטרים
speedAlertOptions

Public void setSpeedLimitIconEnabled (boolean enabled)

מציינת אם סמל מגבלת המהירות מוצג. יש לקרוא לשיטה הזו רק ב-thread של ממשק המשתמש.

כשהמדיניות מופעלת, סמל מגבלת מהירות שמציין את מגבלת המהירות מופיע בפינה התחתונה במהלך ההפעלה במהלך ההנחיה. הסמל מופיע רק במיקומים שבהם יש נתונים אמינים לגבי מגבלת המהירות. כשסמל מד המהירות מופיע, הם מצורפים.

אם לחצן מרכוז מחדש מופעל, סמל מגבלת המהירות מוסתר באופן זמני כשלחצן מרכוז מחדש מוצג.

הערה: הנהגים חייבים לעקוב אחרי כל התמרורים שפורסמו בכביש, ולהשתמש בסמל מגבלת המהירות רק בתור הפניה. לא ניתן להבטיח את הדיוק של הנתונים על מגבלת המהירות. כדי לדווח על אי-דיוקים בנתוני מגבלת המהירות, אפשר לשלוח פנייה בפורטל התמיכה של Google Cloud.

פרמטרים
פעיל

Public void setSpeedometerIconEnabled (boolean enabled)

מציינת אם סמל מד המהירות מוצג. יש לקרוא לשיטה הזו רק ב-thread של ממשק המשתמש.

כשהאפשרות מופעלת, מופיע סמל של מד מהירות שמציין את מהירות הרכב בפינה התחתונה של ההתנעה בזמן ההנחיה. כשסמל מגבלת המהירות מופיע, הם מצורפים ואז למד המהירות יכולים להיות צבעים שונים לטקסט ולרקע, בהתאם לחומרת המהירות.

הפעלה של סמל מד המהירות מפעילה גם את סמל מגבלת המהירות, אבל אפשר להשתמש ב-setSpeedLimitIconEnabled(boolean) כדי להשבית או להפעיל את סמל הגבלת המהירות בנפרד.

אם לחצן המרכוז מופעל, סמל מד המהירות מוסתר באופן זמני כשלחצן מרכוז מחדש מוצג.

פרמטרים
פעיל

ציבורי void setSpeedometerUiOptions (SpeedometerUiOptions SpeedometerUiOptions)

ההגדרה האישית של ממשק המשתמש של מד המהירות SpeedometerUiOptions מבוססת על SpeedAlertSeverity. יש לקרוא לשיטה הזו רק ב-thread של ממשק המשתמש.

הגדרה של SpeedometerUiOptions null תגרום למחיקה של הערך הקודם, אם היא מוגדרת. אם לא הוגדר SpeedometerUiOptions, ממשק המשתמש של מד המהירות חוזר להגדרות ברירת המחדל של NavSDK כדי לקבל התראות מהירות לגבי SpeedAlertSeverity שונים:

  • התראת מהירות של MINOR במצב יום: טקסט אדום ברקע לבן
  • התראה על מהירות MINOR במצב לילה: טקסט אדום ברקע כהה
  • התראת מהירות של MAJOR במצב יום: טקסט לבן ברקע אדום
  • התראת מהירות של MAJOR במצב לילה: טקסט לבן ברקע אדום

פרמטרים
speedometerUiOptions

ציבורי void setStylingOptions (StylingOptions סרגל עיצוב)

מגדירה כמה אפשרויות סגנון לממשק הניווט. צריך להפעיל את השיטה הזו רק ב-thread של ממשק המשתמש.

פרמטרים
stylingOptions

Public void setTrafficIncidentCardsEnabled (boolean enabled)

המדיניות הזו קובעת אם הכרטיסים של אירועי התנועה יוצגו כשהמשתמשים לוחצים על הסמל של אירוע תנועה. יש לקרוא לשיטה הזו רק ב-thread של ממשק המשתמש.

חשוב לדעת: כשהניווט המודרך פועל, הפרטים של אירוע התנועה מוצגים בהודעות. כדי להשבית את הפרטים של אירוע תנועה במהלך הניווט, צריך להשתמש במקום זאת ב-setTrafficPromptsEnabled(boolean).

פרמטרים
פעיל

Public void setTrafficPromptsEnabled (boolean enabled)

הגדרה זו קובעת אם להציג הודעות לגבי תנועת גולשים. מדי פעם מופיעות הודעות לגבי מצב התנועה כדי לעדכן את המשתמשים לגבי מצב התנועה במהלך הניווט. צריך להפעיל את השיטה הזו רק ב-thread של ממשק המשתמש.

פרמטרים
פעיל