הפניה לכיתה של GMSNavigator

הוספת מאזינים.

ההאזנה מוחזקת עם הפניה חלשה.

פרמטרים:

listener

אובייקט שתואם לפרוטוקול GMSNavigatorListener.

הסרת מאזינים.

פרמטרים:

listener

אובייקט שתואם לפרוטוקול GMSNavigatorListener.

החזרות:

חוזרת 'כן' אם המאזינים הוסר. מחזירה NO אם האובייקט לא היה listener.

הגדרת מספר יעדים לניווט תוך ביטול כל היעדים שהוגדרו בעבר.

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

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

הגדרת מספר יעדים לניווט תוך ביטול כל היעדים שהוגדרו בעבר.

המסלולים שהוחזרו מחושבים באמצעות אפשרויות ניתוב.

פרמטרים:

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

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

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

כשמשתמשים באסימון המסלול להתחלת סשן ניווט, יש תמיכה רק ב-GMSNavigationTravelModeDriving וב-GMSNavigationTravelModeTwoWheeler. הגדרת מצב הנסיעה על ידי הגדרת travelMode. אם מצב הנסיעה הנוכחי לא נתמך, השיחה תיכשל ותחזיר GMSRouteStatusTravelModeUnsupported בקריאה החוזרת (callback).

פרמטרים:

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

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

השיטה הזו זמינה רק ללקוחות שירותי ניידות שמחויבים על ידי Google על בסיס עסקה. מחזירה את הערך 'nil' אם לפרויקט אין הרשאה לקרוא ל-API הזה.

פרמטרים:

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

הוצא משימוש.

צריך להפעיל במקום זאת את אחת מהשיטות -setDestinations:... עם רשימת היעדים החדשה.

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

החזרות:

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

הערה:

הכלים האלה הוצאו משימוש. במקום זאת, השתמשו באחת מהשיטות -setDestinations:... .

מחיקה של כל היעדים שהוגדרו בעבר והסרה של כל המסלולים שחושבו מהמפה.

אם ההנחיה פעילה, היא תעצור אותה באופן אוטומטי.

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

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

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

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

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

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

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

מזהי העסקאות ינוקו בסיום סשן הניווט. השיטה הזו זמינה רק ללקוחות שירותי ניידות שמחויבים על ידי Google על בסיס עסקה. מחזירה את הערך 'nil' אם לפרויקט אין הרשאה לקרוא ל-API הזה.

פרמטרים:

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

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

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

פרמטרים:

routeInfo

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

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

לקבלת פרטים נוספים, אפשר לעיין במסמכי התיעוד של ה-API.

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

ברירת המחדל היא NO.

האם להימנע מכבישי אגרה כשיוצרים מסלולים ליעדים.

ברירת המחדל היא NO.

האם להימנע ממעבורות בזמן יצירת מסלולים ליעדים.

ברירת המחדל היא 'כן'.

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

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

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

האם הדרכה מפורטת מופעלת כרגע.

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

האם ההנחיות אמורות להפסיק אוטומטית כשמתבצעת קריאה של -navigator:didReachAtWaypoint: .

אם הערך הוא 'לא', הכותרת העליונה והכותרת התחתונה של הניווט ימשיכו להופיע אחרי ההגעה. בכותרת הניווט תמשיך להופיע שלב ההדרכה הסופי, והכותרת התחתונה של הניווט תמשיך לעדכן את הזמן שנותר ואת המרחק עד שתגיעו ל-0 או זמן/מרחק של 0. בנוסף, נמשיך לעדכן את העדכונים -navigator:didUpdateנשאריםוזמן ו--navigator:didUpdateUpdate ניתוחים שנשארים. כדי להפסיק את ההנחיות ואת עדכוני הזמן/המרחק, צריך להגדיר במפורש את guidanceActive כ'לא'.

אם האפשרות guidanceActive תוגדר אוטומטית ל'לא' עם ההגעה.

ברירת המחדל היא 'כן'.

השינוי המינימלי בזמן המשוער ליעד הבא שיגרום להפעלת השיטה navigator:didUpdateRemainingTime:.

אם המדיניות הזו מוגדרת לערך NSTimeIntervalMax, הקריאה החוזרת (callback) של עדכון הזמן תושבת. אם מוגדר ערך שלילי, המערכת תשתמש בסף ברירת המחדל של שנייה אחת. ברירת המחדל היא שנייה אחת.

הערה:

אם אין מאזינים שמטמיעים את navigator:didUpdateRemainingTime:, המערכת תתעלם מהערך הזה.

השינוי המינימלי במרחק המשוער ליעד הבא שיפעילו את שיטת הקריאה navigator:didUpdateRemainingDistance:.

אם הערך שהוגדר הוא CLLocationFieldMax, הקריאות החוזרות (callback) של עדכון המרחק יושבתו. אם מוגדר ערך שלילי, המערכת תשתמש בסף ברירת המחדל של מטר אחד. ברירת המחדל היא מטר אחד.

הערה:

אם אין מאזינים שמטמיעים את navigator:didUpdateRemainingDistance:, המערכת תתעלם מהערך הזה.

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

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

הפונקציה מחזירה את CLTimeIntervalMax אם אין מסלול זמין.

הפונקציה מחזירה את המרחק המשוער עד ליעד הבא.

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

הפונקציה מחזירה את CLLocationFieldMax אם אין מסלול זמין.

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

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

הפונקציה מחזירה GMSNavigationDelayCategoryNoData אם אין מסלול זמין או אם נתוני התנועה לא זמינים.

החלק הנוכחי של המסע.

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

מערך של רגלי מסלול כאשר כל רגל תואמת ליעד שהוגדר.

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

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

הערה:

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

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

ברירת המחדל היא GMSNavigationVoiceGuidanceAlertsAndGuidance.

ההגדרה קובעת באילו התקני אודיו ניתן להשמיע את ההנחיות הקוליות.

ברירת המחדל היא GMSVoiceGuidanceAudioDeviceTypeBluetooth.

הגדרה זו קובעת אם המכשיר גם ירטוט כאשר התראות קוליות מושמעות.

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

ברירת המחדל היא 'כן'.

מצב התאורה המוצע על סמך השעה ביום ומיקום המכשיר.

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

ברירת המחדל היא 'כן'.

GMSNavigationSpeedAlertOptions להתאמה אישית של ערכי הסף להפעלה של GMSNavigationspeedAlertSeverity.

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

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