רכיב ניווט באפליקציה. המקטע הזה הוא הדרך הפשוטה ביותר להשתמש בניווט באפליקציה. זהו 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 |
onPause()
|
void |
onResume()
|
void |
onSaveInstanceState(Bundle outState)
|
void |
onStart()
|
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 | |
void |
setTrafficIncidentCardsEnabled(מופעל בוליאני)
המדיניות הזו קובעת אם הכרטיסים של אירועי התנועה יוצגו כשהמשתמשים לוחצים על הסמל
של אירוע תנועה.
|
void |
setTrafficPromptsEnabled(מופעל בוליאני)
הגדרה זו קובעת אם להציג הודעות לגבי תנועת גולשים.
|
סיכום שיטות שעברו בירושה
בניינים ציבוריים
ציבורי SupportNavigationFragment ()
שיטות ציבוריות
ציבורי מצלמה getCamera ()
מחזירה אובייקט מצלמה שניתן להשתמש בו כדי לשנות את אזור התצוגה של המפה.
החזרות
- האובייקט
Camera
המשויך למקטע הזה
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
שונים:
פרמטרים
speedAlertUiOptions |
---|
ציבורי void setStylingOptions (StylingOptions סרגל עיצוב)
מגדירה כמה אפשרויות סגנון לממשק הניווט. צריך להפעיל את השיטה הזו רק ב-thread של ממשק המשתמש.
פרמטרים
stylingOptions |
---|
Public void setTrafficIncidentCardsEnabled (boolean enabled)
המדיניות הזו קובעת אם הכרטיסים של אירועי התנועה יוצגו כשהמשתמשים לוחצים על הסמל של אירוע תנועה. יש לקרוא לשיטה הזו רק ב-thread של ממשק המשתמש.
פרמטרים
פעיל |
---|
Public void setTrafficPromptsEnabled (boolean enabled)
הגדרה זו קובעת אם להציג הודעות לגבי תנועת גולשים. מדי פעם מופיעות הודעות לגבי מצב התנועה כדי לעדכן את המשתמשים לגבי מצב התנועה במהלך הניווט. צריך להפעיל את השיטה הזו רק ב-thread של ממשק המשתמש.
פרמטרים
פעיל |
---|