שאלות נפוצות

פרטי המוצר

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

נתונים

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

ניתוב

סימולטור

תהליכי עבודה

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

פרטי המוצר

באפליקציה שלך צריך להיות מוטמע תיבת דו-שיח עם הודעה על התנאים וההגבלות של Navigation SDK, שכל משתמש צריך לאשר. בתיבת הדו-שיח הזו המשתמש יכול להביע הסכמה לתנאים ולהגבלות. קובץ טקסט עם התנאים מסופק עם Navigation SDK. משתמשים בשיטה NavigationApi.showTermsAndConditionsDialog כדי להציג את תיבת הדו-שיח עם התנאים.
כל השפות שנתמכות ב-Google Maps Mobile זמינות באופן אוטומטי ב-Navigation SDK. למכשיר יש שפת מערכת שמוגדרת כברירת מחדל, ואפליקציה לא יכולה לשנות את ההגדרה הזו. עם זאת, לאפליקציה יש גישה ליותר מ-70 שפות.

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

כן. כשיוצרים או משנים מסלול, RouteChangeListener מספק קווי פוליגון.

לא, לא נדרשת התקנה של מפות Google לנייד במכשיר כדי להשתמש ב-Navigation SDK.
לא, בשלב הזה אין תמיכה בתכונה הזו ב-Navigation SDK.
כן. כיוון התנועה זמין ומוצג כברירת מחדל.
באילו גרסאות של JDK יש תמיכה ב-Navigation SDK?
‫
Navigation SDK תומך בגרסאות LTS של Java SE שנתמכות באופן פעיל על ידי Oracle. הגרסאות האלה מופיעות בתוכנית הדרך לתמיכה ב-Oracle Java SE עם תמיכה ברמה Premier.

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

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

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

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

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

יש מצב אופליין?
לא, ל-Navigation SDK אין כרגע מצב אופליין, אבל ה-SDK מספק מידע שמאוחסן במטמון מראש לגבי מסלול.

נתונים

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

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

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

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

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

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

האם Navigation SDK תומך בגדרות וירטואליות?

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

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

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

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

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

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

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

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

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

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

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

אפשר להשבית את כרטיסי ה-ETA באמצעות התקשרות למספר navigationView.setEtaCardEnabled(false).

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

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

ניתוב

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

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

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

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

  1. רושמים listener שבודק את מיקום המכשיר לאורך המסלול באמצעות השיטה Navigator.setRouteChangedListener.
  2. מוסיפים קוד ל-callback event handler, ‏ onRouteChanged:
    • שליחת הודעה למשתמש באפליקציה עם מידע עדכני על זמן ההגעה המשוער והמרחק.
    • עוקבים אחרי מיקום המכשיר.
    • [אופציונלי] מוסיפים תכונות אחרות שנדרשות לאפליקציה כדי לטפל במקרים שבהם המשתמש סוטה מהמסלול שנקבע.
האם המשתמש יכול לצאת מהניווט בלי להשלים את המסלול?

כן. מבצעים קריאה ל-Navigator.stopGuidance כדי להפסיק את הניווט.

האם Navigation SDK תומך בניווט ובהגדרת מסלולים למשאיות ולרכבים גדולים?

כן. בעזרת LVR (ניווט למשאיות), אתם יכולים להעביר טוקנים של מסלולים ספציפיים למשאיות שנוצרו על ידי Routes API או Route Optimization API אל Navigation SDK. ה-SDK מספק ניווט מנקודה לנקודה עם הערות לגבי המסלול (גובה, משקל, חומרים מסוכנים והגבלות על משאיות) ושומר על הפרופיל הפיזי של הרכב במהלך ניתוב מחדש דינמי. פרטים נוספים זמינים במאמר ניווט במסלולים לרכבים גדולים.

סימולטור

האם הסימולטור תומך בשינויים במסלול?

כן. מתקשרים אל simulateLocationsAlongNewRoute כדי לדמות נסיעה שכוללת שינוי מסלול. השיטה simulateLocationsAlongExistingRoute מתעלמת משינויים במסלול הקיים.

תהליכי עבודה

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

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

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

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

מה ההבדל בשימוש ב-Navigation SDK ללקוחות של שירותי ניידות?

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

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

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

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

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

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

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

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

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

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