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

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

דף זה תורגם על ידי Cloud Translation API.

שאלות נפוצות

פרטי המוצר

איך צריך להציג את ההודעה על התנאים וההגבלות של Navigation SDK?: האפליקציה שלכם חייבת ליישם תיבת דו-שיח עם הודעה על התנאים וההגבלות של Navigation SDK, שכל משתמש צריך לאשר. תיבת הדו-שיח הזו מאפשרת למשתמש לאשר את התנאים וההגבלות. קובץ טקסט של התנאים מצורף ל-Navigation SDK. משתמשים ב-method‏ NavigationApi.showTermsAndConditionsDialog כדי להציג את תיבת הדו-שיח שמכילה את התנאים.
באילו שפות יש תמיכה בהנחיות הקוליות?: כל השפות שנתמכות במפות Google לנייד זמינות באופן אוטומטי ל-Navigation SDK. למכשיר יש שפת מערכת ברירת מחדל, ואפליקציה לא יכולה לשנות את ההגדרה הזו. עם זאת, לאפליקציה יש גישה ליותר מ-70 שפות.
האם המיקום נשמר כשהמשתמש יוצא ממצב הניווט?: כן. אחרי שמתחילים את הפקודה, היא ממשיכה לפעול ברקע.LocationListener האפליקציה ממשיכה לכוונן את המיקום לדרך ולשמור על המיקום.
האם קווים פוליגונליים זמינים כשמתחילים מסלול או משנים אותו?: כן. כשיוצרים או משנים מסלול, השדה RouteChangeListener מספק קווים פוליגונים.
האם משתמשי האפליקציה צריכים להתקין את אפליקציית מפות Google לנייד?: לא, כדי להשתמש ב-Navigation SDK לא צריך להתקין את אפליקציית מפות Google לנייד במכשיר.
האם Navigation SDK יכול לזהות מקומות חנייה ליד מסעדות ומקומות מעניינים אחרים?: לא, בשלב הזה אין תמיכה בתכונה הזו ב-Navigation SDK.
האם Navigation SDK מציג את כיוון התנועה בנתיב כשמתקרבים לנקודת פנייה?: כן. כיוון התנועה זמין ומוצג כברירת מחדל.
באילו גרסאות של JDK יש תמיכה ב-Navigation SDK?: Navigation SDK תומך בגרסאות LTS של Java SE שנתמכות באופן פעיל על ידי Oracle. הגרסאות האלה מפורטות כגרסאות עם תמיכת Premier בתוכנית התמיכה של Oracle Java SE.

רשתות וקישוריות

איך מערכת Navigation SDK מטפלת בחיבור לא יציב לרשת?

ה-Navigation SDK מאחסן מראש את המסלול לכל נסיעה. המידע שנשמר במטמון מראש כולל מידע על מסלולים ל-15-20 דקות, וחלופות למסלולים למקרה שהמשתמש יחרוג מהמסלול. ‏Navigation SDK משער את המיקום באמצעות חיישני המכשיר ו-GPS.

איך Navigation SDK מטפל באותות GPS חלשים או חסרים?

אחרי שהניווט מתחיל ו-Navigation SDK מקבל אות GPS לפחות פעם אחת, תוצג ההודעה 'חיפוש GPS…' במצבים הבאים:

אם חלפו יותר מ-10 שניות מאז קבלת האות האחרון מ-GPS.
אם מיקום הניתוב עבר יותר מ-500 מ' מאז קבלת אות ה-GPS האחרון.

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

האם יש מצב אופליין?

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

נתונים

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

כן. כדי לאחזר את המסלול, צריך להפעיל את הפונקציה Navigator.getRouteSegments().

האם מסלול מפורט זמין בתחילת המסלול?

כן. ‏Navigation SDK מספק רשימה של קטעי מסלול. בנוסף, המשתמש יכול להחליק על כרטיס ההוראות בכותרת כדי לראות כל פנייה.

איך זמן האספקה המשוער מועבר למשתמשים באפליקציה?

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

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

האם אפשר להשתמש ב-RoadSnappedLocationProvider כדי לקבל את המיקום הנוכחי של המשתמש, אם הניווט לא נמצא בחזית?

כן. כברירת מחדל, הפקודה RoadSnappedLocationProvider פועלת ברקע.

האם Navigation SDK תומך בגיאופינינג?

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

אפשר לקבל הערכה של התכונה הזו באמצעות remainingTimeOrdistanceChangeListener.

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

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

אפשר להשבית את ההתראות כשאפליקציית הניווט פועלת ברקע?

כן. משתמשים ב-Navigator.setHeadsUpNotificationEnabled כדי לשלוט בהתראות. ל-method הזה יש ארגומנט בוליאני. FALSE משביתה את ההתראות, ו-TRUE מפעילה אותן.

איך אפשר לראות את יומן העסקאות שנשמר על ידי Google?

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

התאמה אישית של ממשק המשתמש

האם אפשר לסמן את המסלול הטוב ביותר בקוד צבע?

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

האם Navigation SDK יכול להציג את זמן ההגעה המשוער ליעד הסופי?

כן. אפשר להשתמש בשיטות הבאות:

אפשר לאחזר את הזמן והמרחק של כל נקודות העצירה באמצעות הפונקציה Navigator.getTimeAndDistanceList().
כדי להסתיר את זמן ההגעה המשוער לנקודת הדרך הנוכחית, לוחצים על NavigationFragment.setEtaCardEnabled(false).
עיבוד של זמן ההגעה המשוער ליעד הסופי.

איך אפשר להסתיר עדכונים לגבי זמן ההגעה המשוער?

אפשר להשבית את כרטיסי זמן ההגעה המשוער על ידי שיחה למספר navigationView.setEtaCardEnabled(false).

אילו התאמות אישיות של ממשק המשתמש זמינות לכרטיסי הכותרת העליונה והכותרת התחתונה?

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

ניתוב

האם אפשר לספק למשתמש מסלול ספציפי או להסיר מסלולים חלופיים?

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

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

כן. יוצרים Marker עם שם מותאם אישית ליעד ואת קו הרוחב/האורך. Navigation SDK מציג את השם המותאם אישית ואת הקואורדינטות ב-NavigationMap.

האם אפשר להשתמש ב-Navigation SDK כדי לעקוב אחרי סטיות מנתיב מוגדר?

כן. אפשר להשתמש ב-Navigator.setRouteChangedListener כדי לקבל התראות כשהמסלול משתנה או כשמסלול חדש מומלץ:

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

האם המשתמש יכול לצאת מהניווט בלי להשלים את המסלול?

כן. כדי לעצור את הניווט, צריך להפעיל את השיטה Navigator.stopGuidance().

סימולטור

האם אפשר לשנות מסלולים בסימולטור?: כן. כדי לדמות נסיעה שכוללת שינוי מסלול, צריך להפעיל את הפקודה simulateLocationsAlongNewRoute. השיטה simulateLocationsAlongExistingRoute מתעלמת משינויים בנתיב הקיים.

תהליכי עבודה

איך אפשר לסגור את ההתראה אחרי סגירת פעילות שמכילה קטע ניווט?

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

כדי לטפל בלחיצות על ההתראה, משתמשים ב-Navigator.startGuidance(intent resumeIntent). האירוע resume intent מופעל כשמשתמש באפליקציה לוחץ על ההתראה. בדרך כלל, Navigator.startguidance(getIntent()) נקרא מהפעילות הראשית, שמפעילה מחדש את הפעילות כשמשתמש האפליקציה לוחץ על ההתראה.

שירותי ניידות

מה ההבדל בין השימוש ב-Navigation SDK ללקוחות של Mobility Services?

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

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

איך אפשר לדעת אם אתם לקוחות של Mobility Services?

אם אתם לא בטוחים אם אתם מיישמים כרגע את Navigation SDK בתור לקוחות של Mobility Services, חפשו קריאה ל-ReportBillableEvent בקוד. רק לקוחות Mobility Services צריכים להפעיל את השיטה ReportBillableEvent.

איך מתבצע החיוב על Navigation SDK ללקוחות Mobility Services?

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

באילו ממשקי API של Navigation SDK צריכים להשתמש רק לקוחות של Mobility Services?

יש כמה ממשקי API ב-Navigation SDK שמיועדים לשימוש רק של לקוחות Mobility Services, ש-Google מחייבת אותם על כל עסקה. אם אתם לא לקוחות של Mobility Services, השיטות הבאות הן no-ops:

אם אני לקוח של Mobility Services, האם אוכל להשתמש גם בהטמעה של Navigation SDK שלא קשורה ל-Mobility Services?

כן, לקוחות Mobility Services יכולים להשתמש בהטמעות של Navigation SDK גם ב-Mobility Services וגם מחוץ ל-Mobility Services. עם זאת, אפשר להשתמש רק בסוג הטמעה אחד בכל אפליקציה בכל פעם. בנוסף, צריך ליצור פרויקט חדש ב-Google Cloud, חשבון לחיוב ומפתח API חדשים, בנפרד מהחשבונות שבהם אתם משתמשים בהטמעה של Mobility Services. מידע נוסף זמין בסקירה הכללית על הגדרת Navigation SDK.

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

הערה: אם אתם לא לקוחות של Mobility Services כרגע ואתם רוצים לקבל מידע נוסף על האוסף של ממשקי ה-API וערכות ה-SDK של Mobility Services, אתם יכולים לפנות לצוות המכירות של הפלטפורמה של מפות Google.