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

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

כן. כדי להפסיק את הניווט, צריך לבצע קריאה ל-method‏ 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, השיטות הבאות הן ללא פעולות:

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