שאלות נפוצות
פרטי המוצר
- איך צריך להציג את ההודעה על התנאים וההגבלות של Navigation SDK?
- אילו שפות נתמכות בהנחיות הקוליות?
- האם הכיוון נשמר כשהמשתמש יוצא ממצב ניווט?
- האם קווים פוליגוניים זמינים כשמתחילים מסלול או משנים אותו?
- האם המשתמשים באפליקציה צריכים להתקין את מפות Google לנייד?
- האם Navigation SDK יכול לזהות חנייה ליד מסעדות ויעדים אחרים?
- האם Navigation SDK מציג את כיוון התנועה בנתיבים כשמתקרבים לנקודת פנייה?
- אילו גרסאות של JDK נתמכות ב-Navigation SDK?
רשת וקישוריות
- איך Navigation SDK מטפל בקישוריות רשת חלשה?
- איך Navigation SDK מטפל באותות GPS חלשים או באותות GPS שאבדו?
- האם יש מצב אופליין?
נתונים
- האם אפשר לאחזר את כל התחנות או היעדים במסלול לפני שמתחילים את הנסיעה?
- האם ההנחיות המפורטות זמינות בתחילת המסלול?
- איך זמן ההגעה המשוער (ETA) מוצג למשתמשי האפליקציה?
- האם אפשר להשתמש ב-
RoadSnappedLocationProviderכדי לקבל את המיקום הנוכחי של המשתמש אם הניווט לא פועל בחזית? - האם Navigation SDK תומך בגדרות וירטואליות?
- אפשר להשבית את ההתראות כשאפליקציית הניווט פועלת ברקע?
- איך אפשר לראות את יומן העסקאות ש-Google שומרת?
התאמה אישית של ממשק המשתמש
- אפשר להשתמש בקידוד צבעים כדי להבחין בין האפשרויות של המסלול הטוב ביותר?
- האם אפשר להציג ב-Navigation SDK את זמן ההגעה המשוער ליעד הסופי?
- איך אפשר להסתיר את העדכונים לגבי שעת ההגעה המשוערת?
- אילו התאמות אישיות של ממשק המשתמש זמינות בכרטיסי הכותרת והכותרת התחתונה?
ניתוב
- האם אפשר לספק נתיב ספציפי למשתמש או להסיר נתיבים חלופיים?
- האם אפשר להציג למשתמש תווית שונה ליעד במקום מיקום היעד שמוגדר כברירת מחדל?
- האם אפשר להשתמש ב-Navigation SDK כדי לעקוב אחרי סטיות מנתיב מוגדר?
- האם המשתמש יכול לצאת מהניווט בלי להשלים את המסלול?
- האם Navigation SDK תומך בניווט ובהגדרת מסלולים למשאיות ולרכבים גדולים?
סימולטור
תהליכי עבודה
שירותי ניידות
- מה ההבדל בשימוש ב-Navigation SDK ללקוחות של Mobility Services?
- איך אפשר לדעת אם אני לקוח של Mobility Services?
- איך מחויבים לקוחות של שירותי ניידות על השימוש ב-Navigation SDK?
- באילו ממשקי API של Navigation SDK יכולים להשתמש רק לקוחות של שירותי ניידות?
- אם אני לקוח של Mobility Services, האם אוכל להשתמש גם בהטמעה של Navigation SDK שלא קשורה ל-Mobility Services?
פרטי המוצר
-
באפליקציה שלך צריך להיות מוטמע תיבת דו-שיח עם הודעה על התנאים וההגבלות של 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 מספק רשימה של קטעי מסלול. בנוסף, המשתמש יכול להחליק בכרטיס ההוראות בכותרת כדי לראות כל תמרון.
- איך זמן ההגעה המשוער מוצג למשתמשי האפליקציה?
-
כדי להציג למשתמשי האפליקציה מידע על זמן ההגעה המשוער:
- מאחזרים את הזמן והמרחק של כל נקודות הביניים באמצעות
Navigator.getTimeAndDistanceList(). - מעבירים את המידע הזה לאפליקציית הלקוח, כמו שמעבירים את זמן ההגעה המשוער של הנהג.
- מאחזרים את הזמן והמרחק של כל נקודות הביניים באמצעות
-
האם אפשר להשתמש ב-
RoadSnappedLocationProviderכדי לקבל את המיקום הנוכחי של המשתמש אם הניווט לא פועל בחזית? -
כן. כברירת מחדל,
RoadSnappedLocationProviderפועל ברקע. - האם Navigation SDK תומך בגדרות וירטואליות?
-
לא. בהקשר של ניווט, ל-
remainingTimeOrdistanceChangeListenerיש יתרון על פני גדר וירטואלית. יכול להיות שהגדרת הגדר הגיאוגרפית לא תתחשב בגיאומטריה של הכביש, ושהיא לא תהיה ממוקמת בדיוק בנקודה שאליה המשתמש מנווט.אפשר להשתמש ב-
remainingTimeOrdistanceChangeListenerכדי לקבל הערכה של התכונה הזו.- מגדירים את ערך הסף כדי לקבוע את תדירות הקריאות החוזרות.
- בודקים את המרחק שנותר עד ליעד.
לדוגמה, אם מגדירים את הסף ל-100 מטר, מקבלים קריאה חוזרת כשהמרחק ליעד משתנה ב-100 מטר. ככל שהמרחק קטן יותר, אפשר לעדכן את ערך הסף הזה לערך קטן יותר ולקבל קריאות חוזרות בתדירות גבוהה יותר. לאחר מכן, בודקים את המרחק שנותר כדי להבין אם אתם קרובים מספיק למיקום האיסוף או המסירה.
- אפשר להשבית את ההתראות כשאפליקציית הניווט פועלת ברקע?
-
כן. משתמשים ב
Navigator.setHeadsUpNotificationEnabledכדי לשלוט בהתראות. לשיטה הזו יש ארגומנט בוליאני.FALSEמשבית את ההתראות;TRUEמפעיל את ההתראות. -
כלי התיעוד של העסקאות עוקב אחרי איסופים ומסירות באמצעות מזהה ייחודי, ש-Google מתעדת למטרות ניתוח נתונים של מוצרים. אם אתם לקוחות של Mobility Services, Google ממליצה לכם להטמיע את
NavigationTransactionRecorderכדי לתעד את העסקאות שלכם.
התאמה אישית של ממשק המשתמש
- אפשר להשתמש בקידוד צבעים כדי להבליט את המסלול הכי טוב?
- לא. בשלב הזה אין תמיכה בקידוד צבעים של אפשרות מסלול ספציפית.
- האם אפשר להציג ב-Navigation SDK את זמן ההגעה המשוער ליעד הסופי?
-
כן. אפשר להשתמש בשיטות הבאות:
- מאחזרים את הזמן והמרחק של כל נקודות הביניים באמצעות
Navigator.getTimeAndDistanceList(). - כדי להסתיר את זמן ההגעה המשוער לנקודת הדרך הנוכחית, משתמשים ב-
NavigationFragment.setEtaCardEnabled(false). - עיבוד של משך ההגעה המשוער ליעד הסופי.
- מאחזרים את הזמן והמרחק של כל נקודות הביניים באמצעות
- איך אפשר להסתיר את העדכונים לגבי שעת ההגעה המשוערת?
-
אפשר להשבית את כרטיסי ה-ETA באמצעות התקשרות למספר
navigationView.setEtaCardEnabled(false). -
משתמשים ב-
StylingOptionsכדי להגדיר את הסגנון של צבע הרקע. כדי להסתיר או להציג את הכותרת העליונה והכותרת התחתונה, משתמשים בפונקציות החבריםsetHeaderEnabledו-setFooterEnabledשלNavigationFragment.
ניתוב
- האם אפשר לספק נתיב ספציפי למשתמש או להסיר נתיבים חלופיים?
- לא. כברירת מחדל, מוצגים כמה מסלולים והמסלול המהיר ביותר מקבל עדיפות. כדי להשפיע על מסלול ברירת המחדל, אפשר להוסיף להעדפות בקשה כמו 'הימנעות מכבישים מהירים ומכבישי אגרה'. הוספת נקודות ציון משפיעה גם על המסלול.
- האם אפשר להציג למשתמש האפליקציה תווית שונה ליעד ממיקום היעד שמוגדר כברירת מחדל?
-
כן. יוצרים
Markerעם כותרת מותאמת אישית ליעד ולקווי הרוחב והאורך. Navigation SDK מציג את הכותרת המותאמת אישית ואת הקואורדינטות ב-NavigationMap. - האם אפשר להשתמש ב-Navigation SDK כדי לעקוב אחרי סטיות מנתיב מוגדר?
-
כן. אפשר להשתמש ב-
Navigator.setRouteChangedListenerכדי לקבל התראות על שינויים במסלול או על המלצות למסלולים חדשים:- רושמים listener שבודק את מיקום המכשיר לאורך המסלול באמצעות השיטה
Navigator.setRouteChangedListener. - מוסיפים קוד ל-callback event handler,
onRouteChanged:- שליחת הודעה למשתמש באפליקציה עם מידע עדכני על זמן ההגעה המשוער והמרחק.
- עוקבים אחרי מיקום המכשיר.
- [אופציונלי] מוסיפים תכונות אחרות שנדרשות לאפליקציה כדי לטפל במקרים שבהם המשתמש סוטה מהמסלול שנקבע.
- רושמים listener שבודק את מיקום המכשיר לאורך המסלול באמצעות השיטה
-
כן. מבצעים קריאה ל-
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 כשהמשתמש באפליקציה לוחץ על ההתראה.
שירותי ניידות
שירותי הניידות של Google Maps Platform כוללים אוסף של ממשקי API ו-SDK שעוזרים לתמוך בצרכים של עסקים בתחום התחבורה והלוגיסטיקה. לקוחות של שירותי ניידות משתמשים בדרך כלל ב-Navigation SDK בשילוב עם שירותים קשורים לאופטימיזציה של מסלולים, לשיגור, למעקב אחרי משימות, לניתוח של צי הרכב ועוד. לקוחות של שירותי ניידות מחויבים על השימוש ב-Navigation SDK באופן שונה. מידע נוסף זמין במאמרי העזרה בנושא שירותי ניידות.
מוצרי Mobility זמינים כרגע רק ללקוחות נבחרים. למידע נוסף, אפשר לפנות לנציג המכירות.
ReportBillableEvent בקוד שלכם. רק לקוחות של Mobility Services צריכים להתקשר לשיטה ReportBillableEvent.
יש כמה ממשקי API ב-Navigation SDK שמיועדים לשימוש רק על ידי לקוחות של Mobility Services, שמקבלים חשבון מ-Google על בסיס כל עסקה. אם אתם לא לקוחות של שירותי ניידות, השיטות הבאות הן בלי תפעול (no-ops):
כן, לקוחות של Mobility Services יכולים להשתמש גם ב-Mobility Services וגם בהטמעות של Navigation SDK שאינן Mobility Services. עם זאת, אפשר להשתמש רק בסוג הטמעה אחד באפליקציה בכל פעם. בנוסף, צריך ליצור פרויקט בענן חדש ב-Google Cloud, חשבון לחיוב ומפתח API, בנפרד מאלה שבהם אתם משתמשים בהטמעה של שירותי הניידות. מידע נוסף זמין במאמר סקירה כללית של הגדרת Navigation SDK.
לקבלת מידע נוסף על שימוש בהטמעה של Navigation SDK שאינה Mobility Services, כולל העברת אפליקציה מסוג הטמעה אחד לסוג אחר, אפשר לפנות לאיש הקשר האחראי לחשבון Google.
הערה: אם אתם לא לקוחות של שירותי Mobility כרגע, אבל אתם רוצים לקבל מידע נוסף על אוסף ממשקי ה-API וערכות ה-SDK של שירותי Mobility, אתם יכולים לפנות למחלקת המכירות של הפלטפורמה של מפות Google.