תמיכה בניווט

מחלקה ציבורית SupportNavigationFragment מרחיב את Fragment

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

 <fragment
    class="com.google.android.libraries.navigation.SupportNavigationFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

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

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

מצלמה
getCamera()
מחזירה אובייקט מצלמה שניתן להשתמש בו כדי לשנות את אזור התצוגה של המפה.
NavigationMap
getMap()
מחזירה אובייקט שניתן להשתמש בו כדי להוסיף תוכן למפה.
void
onConfigurationChanged(הגדרת תצורה)
מעבר למצב תצוגה
onCreateView(LayoutInflater Predictionr, מאגר ViewGroup, Bundle savedInstanceState)
void
void
void
void
void
onSaveInstanceState(Bundle outState)
void
void
onStop()
void
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode הסברInfoDisplayModeOverride)
ההגדרה הזו מבטלת את מצב התצוגה המוגדר כברירת מחדל עבור נכסי יתרונות מרכזיים של מודעות טקסט מורחבות במהלך הניווט.
void
setCalloutInfoFormatOverride(RouteCalloutInfoFormat InfoFormatOverride)
מגדיר את מצב הפורמט של פרטי היתרונות המרכזיים עבור נכסי יתרונות מרכזיים של מסלול.
void
setCompassEnabled(אפשרות בוליאנית)
קובעת אם המצפן גלוי.
void
setCustomControl(פקד תצוגה, מיקום CustomControlPosition)
מגדיר תצוגת בקרה מותאמת אישית שתופיע במיקום הנתון בממשק המשתמש של הניווט.
void
setEtaCardEnabled(מופעל בוליאני)
הגדרה זו קובעת אם כרטיס זמן ההגעה המשוער יהיה גלוי במהלך הניווט.
void
setForceNightMode(int 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 SpeedAlertUiOptions)
ההגדרה האישית של ממשק המשתמש של מד המהירות SpeedometerUiOptions מבוססת על SpeedAlertSeverity.
void
setStylingOptions(StylingOptions עיצובאפשרויות)
מגדירה כמה אפשרויות סגנון לממשק הניווט.
void
setTrafficIncidentCardsEnabled(מופעל בוליאני)
המדיניות הזו קובעת אם הכרטיסים של אירועי התנועה יוצגו כשהמשתמשים לוחצים על הסמל של אירוע תנועה.
void
setTrafficPromptsEnabled(מופעל בוליאני)
הגדרה זו קובעת אם להציג הודעות לגבי תנועת גולשים.

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

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

ציבורי SupportNavigationFragment ()

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

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

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

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

Public NavigationMap getMap ()

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

Public void onConfigurationChanged (Configuration config)

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

Public View onCreateView (LayoutInflaterוףd, ViewGroup container, Bundle savedInstanceState)

פרמטרים
מנופחת
מאגר
savedInstanceState

Public void onDestroyView ()

Public void onLowMemory ()

Public void onPause ()

Public void onResume ()

Public void onSaveInstanceState (Bundle outState)

פרמטרים
outState

Public void onStart ()

Public void onStop ()

ציבורי 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 forceNightMode)

פרמטרים
forceNightMode

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 SpeedAlertUiOptions)

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

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

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

פרמטרים
speedAlertUiOptions

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

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

פרמטרים
stylingOptions

Public void setTrafficIncidentCardsEnabled (boolean enabled)

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

פרמטרים
פעיל

Public void setTrafficPromptsEnabled (boolean enabled)

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

פרמטרים
פעיל