ניווט

ממשק ציבורי Navigator

סינגלטון שמספק שיטות לשליטה בניווט.

כל השיטות יהיו בטוחות לשרשורים, למעט ההגדרות setAudioGuidance ו-setHeadsUpNotificationEnabled שחובה להפעיל אותן בשרשור של ממשק המשתמש.

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

משופר	Navigator.ArrivalListener		מגדירה חתימות לשיטות שמופעלות כשהנהג מגיע לציוני דרך.
@interface	Navigator.AudioGuidance		AudioGuidance הוא קבוצת דגלים שמציינים את סוגי ההתראות וההנחיות הקוליות שישמשו את הניווט.
משופר	Navigator.RemainingTimeOrDistanceChangedListener		מגדירה חתימות ל-methods שמופעלות כשהזמן שנותר או המרחק עד ליעד הבא משתנה.
משופר	Navigator.RouteChangedListener		הגדרת חתימות ל-methods שמופעלות כשהמסלול משתנה.
טיפוסים בני מנייה (enum)	Navigator.RouteStatus		RouteStatus הוא קוד סטטוס שמייצג את התוצאה של חישוב מסלול, שהגישה אליו מתבצעת דרך 'עתיד' שמוחזר על ידי setDestination(Waypoint).

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

מופשט בטל	cleanup() ניקוי המצב הפנימי של הניווט.
מופשט בטל	clearDestinations() הפעולה הזו מוחקת את כל היעדים שהוגדרו בעבר ומסירה את המסלולים המחושבים מהמפה.
מופשט בטל	clearLicensePlateRestrictionInfo() מחיקת פרטי לוחית הרישוי של הנהג הנוכחי.
מופשט בטל	clearRemainingTimeOrDistanceChangedListener() ניקוי הכלי מאזין לשינויים בזמן או במרחק שנותר.
מופשט נקודת יעד	continueToNextDestination() הסרת היעד הנוכחי.
מופשט ListenableResultFuture<RouteInfo>	fetchRouteInfo(נקודת ציון של Waypoint, RoutingOptions routerOptions) הפונקציה מחזירה את פרטי המסלול עבור מסלולים המבוססים על כל ערך של RoutingOptions.RoutingStrategy.
מופשט RouteSegment	getCurrentRouteSegment() מחזירה את הקטע הנוכחי של התהליך.
מופשט TimeAndDistance	getCurrentTimeAndDistance() מחזירה את הזמן והמרחק המשוערים מהמיקום הנוכחי ליעד הנוכחי.
מופשט רשימה<RouteSegment>	getRouteSegments() מחזירה רשימה של קטעי מסלול.
מופשט סימולטור	getSimulator() מחזירה אובייקט סימולטור לשימוש במהלך בדיקה.
מופשט רשימה<TimeAndDistance>	getTimeAndDistanceList() מחזירה רשימה של זמנים ומרחקים בהתאם לכל יעד במסלול הנוכחי. מייצגת את הזמן והמרחק המשוערים מהמיקום הנוכחי לכל יעד.
מופשט רשימה<LatLng>	getTraveledRoute() מחזירה את המסלול שעבר עד עכשיו בפעילות ההנחיה הזו (מאז הקריאה האחרונה ל-startGuidance()).
מופשט בוליאני	isGuidanceRunning() הפונקציה מחזירה את הערך true אם ההנחיה פועלת כרגע.
מופשט בטל	setArrivalListener(Navigator.ArrivalListener listener) רישום האזנה לאירועי הגעה.
מופשט בטל	setAudioGuidance(הדרכה למשתמשים) הגדרה זו קובעת אילו סוגים של הנחייה קולית (כולל רטט) יופעלו.
מופשט ListenableResultFuture<Navigator.RouteStatus>	setDestination(יעד Waypoint, RoutingOptions routerOptions, DisplayOptions displayOptions) מגדירה יעד יחיד לניווט, תוך ביטול כל היעדים שהוגדרו בעבר.
מופשט ListenableResultFuture<Navigator.RouteStatus>	setDestination(יעד Waypoint, אפשרויות RoutingOptions) מגדירה יעד יחיד לניווט, תוך ביטול כל היעדים שהוגדרו בעבר.
מופשט ListenableResultFuture<Navigator.RouteStatus>	setDestination(יעד Waypoint) מגדירה יעד יחיד לניווט, תוך ביטול כל היעדים שהוגדרו בעבר.
מופשט ListenableResultFuture<Navigator.RouteStatus>	setDestinations(רשימה<Waypoint> יעדים, אפשרויות RoutingOptions) מגדירה יעדים מרובים לניווט, תוך ביטול כל היעדים שהוגדרו בעבר.
מופשט ListenableResultFuture<Navigator.RouteStatus>	setDestinations(רשימה<Waypoint> יעדים, RoutingOptions routerOptions, DisplayOptions displayOptions) מגדירה יעדים מרובים לניווט, תוך ביטול כל היעדים שהוגדרו בעבר.
מופשט ListenableResultFuture<Navigator.RouteStatus>	setDestinations(רשימה<Waypoint> יעדים) מגדירה יעדים מרובים לניווט, תוך ביטול כל היעדים שהוגדרו בעבר.
מופשט בטל	setHeadsUpNotificationEnabled(מופעלת בוליאנית) הגדרה זו קובעת אם להציג התראות 'שימו לב'.
מופשט בטל	setLicensePlateRestrictionInfo(int RAWLicensePlateLastDigit, String LicensePlateCountryCode) הגדרת פרטי לוחית הרישוי של הנהג הנוכחי.
מופשט בטל	setRemainingTimeOrDistanceChangedListener(int timeChange thresholdSeconds, int betweentChangeChangeRates, Navigator.RemainingTimeOrDistanceChangedListener listener) הפונקציה הזו מתעדת מאזין למקרים שבהם הזמן שנותר או המרחק ליעד משתנה בשיעור גבוה יותר מהסף שצוין.
מופשט בטל	setRouteChangedListener(Navigator.RouteChangedListener listener) רושם מאזין לאירועים שהמסלול שלהם השתנה.
מופשט בטל	setSpeedingListener(SpeedingListener SpeedingListener) רישום SpeedingListener לאחוז שחורג ממגבלת המהירות שבה הנהג נוסע עכשיו.
מופשט בטל	startGuidance (Intent סרט חדש (Intent) זהה ל-startGuidance(), אבל ציון כוונה שאפשר להשתמש בה כדי להמשיך את האפליקציה מהתראת שורת הסטטוס של הניווט.
מופשט בטל	startGuidance() אם הוגדר יעד וחישוב מסלול מתבצע עבורו, המערכת מפעילה את הנחיות הניווט של המסלול המפורט.
מופשט בטל	stopGuidance() הפסקת הניווט המפורט.

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

Public מופשט void ניקוי ()

ניקוי המצב הפנימי של הניווט.

הערה: קריאה לפעולת השירות הזו תבטל את כל הבקשות הממתינות אל setDestinations(List).

ציבורי מופשט בטל clearDestinations ()

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

ציבורי מופשט בטל clearLicensePlateRestrictionInfo ()

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

ציבורי מופשט void clearRemainingTimeOrDistanceChangedListener ()

ניקוי הכלי מאזין לשינויים בזמן או במרחק שנותר.

ציבורי תקציר Waypoint continueToNextDestination ()

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

החזרות

• ההנחיות של ציון הדרך בדרך אל, או הערך null אם לא נותרו ציוני דרך

ציבורי מופשט ListenableResultFuture<RouteInfo> fetchRouteInfo (ציון דרך, RoutingOptions routerOptions)

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

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

פרמטרים

נקודת ציון	את ציון הדרך של היעד במסלול
routingOptions	האפשרויות המשמשות לאחזר את פרטי המסלול

החזרות

• העתיד המוחזר

ציבורי תקציר RouteSegment getCurrentRouteSegment ()

מחזירה את הקטע הנוכחי של התהליך. נקודת ההתחלה של קטע הנתיב הזה מוגדרת בתור המיקום האחרון הידוע (המצב שנצמד לכביש) של המכשיר.

החזרות

• אובייקט של קטע מסלול, או null אם אין מסלול נוכחי

ציבורי מופשט TimeAndDistance getCurrentTimeAndDistance ()

מחזירה את הזמן והמרחק המשוערים מהמיקום הנוכחי ליעד הנוכחי.

החזרות

• אובייקט של זמן ומרחק, או null אם לא קיים מסלול כרגע

Public תקציר רשימה<RouteSegment> getRouteSegments ()

מחזירה רשימה של קטעי מסלול. היעד של כל פלח שמוחזר יתאים ליעד שהוגדר על ידי setDestination(s).

Public תקציר סימולטור getSimulator ()

מחזירה אובייקט סימולטור לשימוש במהלך בדיקה.

Public מופשט רשימה<TimeAndDistance> getTimeAndDistanceList ()

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

ציבורי תקציר רשימה<LatLng> getTraveledRoute ()

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

Public מופשט בוליאני isGuidanceRunning ()

הפונקציה מחזירה את הערך true אם ההנחיה פועלת כרגע. לתשומת ליבך, ההנחיות יפעלו רק לאחר חישוב המסלול ליעד ובוצעה קריאה ל-startGuidance().

Public מופשט void setArrivalListener (Navigator.ArrivalListener listener)

רישום האזנה לאירועי הגעה. האפליקציה מבטלת פונקציות listener שנרשמו בעבר.

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

פרמטרים

listener	המאזין כדי לרשום. ניתן להגדיר את הערך כ-null כדי למחוק מעבד (listener) שנרשם בעבר.

ציבורי מופשט בטל setAudioGuidance (הנחיות int)

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

חובה לקרוא לשיטה הזו ב-thread של ממשק המשתמש.

פרמטרים

הנחיה	שילוב של דגלי Navigator.AudioGuidance המציינים אילו סוגים של הנחיות אודיו יש להפעיל

ציבורי תקציר ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint destination, RoutingOptions routerOptions, DisplayOptions displayOptions)

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

פרמטרים

חשבון יעד	היעד החדש שצריך להגדיר
routingOptions	האפשרויות שבהן המערכת תשתמש כדי ליצור את המסלול
displayOptions	האפשרויות שישמשו להצגת המסלול

החזרות

• העתיד המוחזר

קליעות

NullPointerException	אם היעד הנתון הוא null

Public תקציר ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint destination, RoutingOptions options)

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

פרמטרים

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

החזרות

• העתיד המוחזר

קליעות

NullPointerException	אם היעד הנתון הוא null

Public תקציר ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint destination)

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

פרמטרים

חשבון יעד	היעד החדש שצריך להגדיר

החזרות

• העתיד המוחזר

קליעות

NullPointerException	אם היעד הנתון הוא null

Public תקציר ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Waypoint> יעדים, RoutingOptions אפשרויות)

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

פרמטרים

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

החזרות

• העתיד המוחזר

Public תקציר ListenableResultFuture<Navigator.RouteStatus> setDestinations (רשימה<Waypoint> יעדים, RoutingOptions routerOptions, DisplayOptions displayOptions){/17

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

פרמטרים

יעדים גיאוגרפיים	רשימת היעדים החדשה להגדרה
routingOptions	האפשרויות שבהן המערכת תשתמש כדי ליצור את המסלול
displayOptions	האפשרויות שישמשו להצגת המסלול

החזרות

• העתיד המוחזר

Public תקציר ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Waypoint> יעדים)

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

פרמטרים

יעדים גיאוגרפיים	רשימת היעדים החדשה להגדרה

החזרות

• העתיד המוחזר

Public מופשט void setHeadsUpNotificationEnabled (boolean enabled)

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

חובה לקרוא לשיטה הזו ב-thread של ממשק המשתמש.

פרמטרים

פעיל	דגל שמציין אם יש להפעיל התראות 'שימו לב'

Public מופשט void setLicensePlateRestrictionInfo (int RAWLicensePlateLastDigit, String LicensePlateCountryCode)

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

פרמטרים

rawLicensePlateLastDigit	הספרה האחרונה של לוחית הרישוי (חייבת להיות מספר בין 0 ל-9).
licensePlateCountryCode	כרגע אנחנו תומכים באינדונזיה (ID) ובברזיל (BZ) בעתיד. ייתכן שתמיכה במדינות אחרות תהיה זמינה, ואפשר לספק את המידע הזה באופן יזום.

Public מופשט void setRemainingTimeOrDistanceChangedListener (int timeChangeChangeSeconds, int נוהגChangeMeters, Navigator.RemainingTimeOrDistanceChangedListener אוזן)

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

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

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

פרמטרים

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

Public מופשט void setRouteChangedListener (Navigator.RouteChangedListener listener)

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

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

פרמטרים

listener	המאזין כדי לרשום. ניתן להגדיר את הערך כ-null כדי למחוק מעבד (listener) שנרשם בעבר.

ציבורי מופשט void setSpeedingListener (SpeedingListener SpeedingListener)

רישום SpeedingListener לאחוז שחורג ממגבלת המהירות שבה הנהג נוסע עכשיו.

אם מגדירים SpeedingListener של null או לא קובעים שום הגדרה, לא יתקבלו נתוני פיד לגבי מהירות מופרזת.

פרמטרים

speedingListener

Public מופשט בטל startGuidance (Intent נשלחה ל-Intent)

זהה ל-startGuidance(), אבל ציון כוונה שאפשר להשתמש בה כדי להמשיך את האפליקציה מהתראת שורת הסטטוס של הניווט. בלי ה-Intent הזה, לא ניתן להמשיך את הצגת האפליקציה משורת הסטטוס.

פרמטרים

resumeIntent	כוונה להמשיך את השימוש באפליקציה. ברוב המקרים, הערך שיוחזר על ידי android.app.Activity#getIntent() יתאים.

Public מופשט בטל startGuidance ()

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

צריך לבצע קריאה מפורשת ל-stopGuidance() כדי להפסיק את שירות הניווט. שירות הניווט לא יופסק באופן אוטומטי עם ההגעה. כדי להפסיק את שירות הניווט בזמן ההגעה, צריך לקרוא ל-stopGuidance() ב-NavArrivalListener.

הערה: השיטה הזו לא משנה את המיקום של Camera.

ציבורי מופשט בטל stopGuidance ()

הפסקת הניווט המפורט.