שאלות נפוצות

פרטי המוצר

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

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

איך Navigation SDK מטפל בקישוריות חלשה לרשת?

Navigation SDK שומר במטמון מראש את המסלול לכל נסיעה. המידע שנשמר במטמון מראש כולל מידע על ניתוב למשך 15-20 דקות, וחלופות לניתוב למקרה שהמשתמש יסטה מהמסלול. ה-SDK של Navigation מעריך את המיקום באמצעות ה-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?

כלי התיעוד של העסקאות עוקב אחרי איסופים ומסירות באמצעות מזהה ייחודי, ש-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:
- שליחת הודעה למשתמש באפליקציה עם מידע מעודכן על זמן ההגעה המשוער והמרחק.
- מעקב אחרי המיקום של המכשיר.
- [אופציונלי] מוסיפים תכונות אחרות שנדרשות לאפליקציה כדי לטפל במקרים שבהם המשתמש לא נמצא במסלול שנקבע.

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

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

סימולטור

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

תהליכי עבודה

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

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

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

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

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

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

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

איך אפשר לדעת אם אני לקוח של 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 שמיועדים לשימוש רק על ידי לקוחות של שירותי תחבורה, שמתבצעת להם חיוב על ידי Google על בסיס כל עסקה. אם אתם לא לקוחות של שירותי ניידות, השיטות הבאות הן בלי תפעול (no-ops):

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

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

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

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