הצטרפו אלינו לאירוע הבא של Google Maps Platform Developer Community Day בסן פרנסיסקו בדצמבר. להגשת בקשה להשתתפות.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

שאלות נפוצות

פרטי המוצר

איך צריך להציג את ההודעה על התנאים וההגבלות של 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 Support.

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

איך Navigation SDK מתמודד עם חיבור חלש לרשת?

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

איך ה-Navigation SDK מטפל באותות GPS חלשים או באובדן אותות 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 כדי לשלוט בהתראות. לשיטה הזו יש ארגומנט בוליאני. FALSE משבית את ההתראות, ו-TRUE מפעיל אותן.

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

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

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

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

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

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

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

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

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

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

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

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

ניתוב

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

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

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

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

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

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

רושמים מאזין שבודק את מיקום המכשיר לאורך המסלול באמצעות השיטה Navigator.setRouteChangedListener.
מוסיפים קוד לגורם המטפל באירועים של הקריאה החוזרת (callback),‏ onRouteChanged:
- שליחת הודעה למשתמש באפליקציה עם מידע מעודכן על זמן ההגעה המשוער והמרחק.
- לעקוב אחרי מיקום המכשיר.
- [optional] Add other features required by your app to handle when the user is off the prescribed route.

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

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

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

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

סימולטור

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

תהליכי עבודה

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

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

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

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

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

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

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

איך אפשר לדעת אם יש לי מינוי ל-Mobility Services?

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

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

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

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

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

אם אני לקוח של 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 Maps Platform.