הפעלת פיד נתונים מפורט

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

  • סמלים (שמאלה, ימינה, פניית פרסה)
  • מספרי פניות בכיכרות
  • שמות של כבישים
  • המרחק המשוער והזמן המשוער עד לשלב הבא בניווט או עד ליעד הסופי

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

כדי להשתמש ב-SDK, צריך ליצור שירות ולרשום אותו ב-Navigation SDK ל-Android, כדי שהוא יוכל לקבל מידע חדש על הניווט בזמן אמת (בערך פעם בשנייה במהלך הניווט).

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

סקירה כללית

בקטע הזה מוסבר בקצרה התהליך להפעלת התכונה "מסלול מפורט".

שימוש בתכונה TurnByTurn

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

  1. יוצרים שירות לקבלת עדכוני ניווט.

  2. רושמים את השירות.

  3. הסבר על מצבי הניווט

יצירת שירות לקבלת עדכוני ניווט

‫Navigation SDK נקשר לשירות TurnByTurn ושולח לו עדכוני ניווט דרך Android Messenger. אתם יכולים ליצור שירות ניווט חדש לעדכונים האלה, או להשתמש בשירות קיים.

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

השירות בדוגמה הבאה מקבל מידע על הניווט ומשתמש ב-TurnByTurnManager כדי להמיר את הנתונים לאובייקט NavInfo שמכיל את פרטי הניווט.

/**
 *   Receives turn-by-turn navigation information forwarded from NavSDK.
 */
public class NavInfoReceivingService extends Service {
  /** The messenger used by the service to receive nav step updates. */
  private Messenger incomingMessenger;
  private TurnByTurnManager turnByTurnManager;

  private final class IncomingNavStepHandler extends Handler {
    public IncomingNavStepHandler(Looper looper) {
      super(looper);
    }

    @Override
    public void handleMessage(Message msg) {
      // Identify the message through the msg.what field.
      if (TurnByTurnManager.MSG_NAV_INFO == msg.what) {
        // Extract the NavInfo object using the TurnByTurnManager.
        NavInfo navInfo = turnByTurnManager
          .readNavInfoFromBundle(msg.getData()));
      // Do something with the NavInfo
    }
  }
}

@Nullable
@Override
public IBinder onBind(Intent intent) {
  return incomingMessenger.getBinder();
}

@Override
public void onCreate() {
  turnByTurnManager = TurnByTurnManager.createInstance();
  HandlerThread thread =
    new HandlerThread("NavInfoReceivingService",
      Process.THREAD_PRIORITY_DEFAULT);
  thread.start();
  incomingMessenger = new Messenger(
    new IncomingNavStepHandler(thread.getLooper()));
}

קודי הודעות

אפשר לזהות הודעות NavInfo באמצעות השדה Message.what של המחלקה Message, שמוגדר לערך TurnByTurnManager.MSG_NAV_INFO.

רישום השירות לעדכוני ניווט

קטעי הקוד הבאים רושמים את שירות הניווט.

boolean isNavInfoReceivingServiceRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(), NavInfoReceivingService.class.getName(), numNextStepsToPreview);

הפעלה והפסקה של השירות

שירות הניווט פעיל כל עוד Navigation SDK מקושר אליו. אתם יכולים להפעיל באופן ידני את startService() ואת stopService() כדי לשלוט במחזור החיים של שירות הניווט, אבל כשאתם רושמים את השירות ב-Navigation SDK, השירות מופעל באופן אוטומטי, ונפסק רק כשאתם מבטלים את הרישום שלו. בהתאם לאופן שבו הגדרתם את האפליקציה, יכול להיות שכדאי לכם להפעיל שירות בחזית, כפי שמתואר במסמכי התיעוד של Android בקטע סקירה כללית של שירותים.

ביטול הרישום של השירות

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

navigator.unregisterServiceForNavUpdates();

הסבר על מצבי הניווט

משתמשים ב-NavInfo.getNavState() כדי לקבל את המצב הנוכחי של הניווט, שהוא אחד מהבאים:

  • בדרך – המצב ENROUTE מציין שהניווט המודרך פעיל והמשתמש נמצא במסלול שסופק. יש מידע על השלב הבא בתמרון.

  • שינוי מסלול – REROUTING פירושו שהניווט מתבצע, אבל הניווט מחפש מסלול חדש. השלב הבא בתמרון לא זמין כי עדיין אין מסלול חדש. באפליקציה לדוגמה, ההודעה "Rerouting...‎" מופיעה בתצוגת פרטי הניווט. אחרי שמוצאים מסלול, נשלחת הודעת NavInfo עם הסטטוס ENROUTE.

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

אכלוס תצוגת הפיד

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

מסך של נייד שבו מוצגת פנייה שמאלה בעוד 30 מטרים אל W Ahwanee Ave. בתחתית המסך, הזמן שנותר עד ליעד הוא 46 דקות, והמרחק שנותר הוא 62 קילומטרים.

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

בטבלה הזו מוצגים השדות של פרטי הניווט והמיקום שלהם.

שדות לכל שלב בניווט שדות שמתייחסים לנסיעה כולה
נמצא ב-StepInfo נמצא ב-NavInfo
השם המלא של הכביש הזמן שנותר
סמל התמרון המרחק ליעד
המרחק לשלב הבא
שדות של הנחיה לבחירת נתיב

הנחיה לבחירת נתיב

ב-Navigation SDK, הנתיבים מיוצגים בכרטיס הפנייה של הניווט כאובייקטים של נתונים מסוג Lane ו-LaneDirection. אובייקט Lane מייצג נתיב ספציפי במהלך הניווט, ויש לו רשימה של אובייקטים מסוג LaneDirection שמתארים את כל הפניות שאפשר לבצע מהנתיב הזה.

הגדרה לדוגמה של הנחיה בנתיב.

הכיוון המומלץ שהמשתמש צריך לפנות אליו בנתיב מסומן בשדה isRecommended.

דוגמה להנחיה לבחירת נתיב

קטע הקוד הבא ממחיש את ייצוג הנתונים של הנתיבים שמוצגים למעלה.

// Lane 1
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false},
                  {/*laneShape=*/ SLIGHT_LEFT, /*isRecommended=*/ true}]

// Lane 2
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false}]

יצירת סמלים לתמרונים

הערך enum של Maneuver מגדיר כל תמרון אפשרי שיכול להתרחש במהלך הניווט, ואפשר לקבל את התמרון לשלב נתון מהשיטה StepInfo.getManeuver().

אתם צריכים ליצור סמלי תמרונים ולהתאים אותם לתמרונים המשויכים אליהם. בחלק מהתמרונים, אפשר להגדיר מיפוי של אחד לאחד לסמל, כמו DESTINATION_LEFT ו-DESTINATION_RIGHT. עם זאת, מכיוון שחלק מהתמרונים דומים, יכול להיות שתרצו למפות יותר מתמרון אחד לסמל אחד. לדוגמה, גם TURN_LEFT וגם ON_RAMP_LEFT יכולים למפות לסמל הפנייה שמאלה.

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

הרחבה כדי לראות סמלים לדוגמה של תמרונים שונים

סמל לדוגמה תמרונים של TurnByTurn
DEPART
UNKNOWN
STRAIGHT
ON_RAMP_UNSPECIFIED
OFF_RAMP_UNSPECIFIED
NAME_CHANGE
TURN_RIGHT
ON_RAMP_RIGHT
TURN_LEFT
ON_RAMP_LEFT
TURN_SLIGHT_RIGHT
ON_RAMP_SLIGHT_RIGHT
OFF_RAMP_SLIGHT_RIGHT
TURN_SLIGHT_LEFT
ON_RAMP_SLIGHT_LEFT
OFF_RAMP_SLIGHT_LEFT
TURN_SHARP_RIGHT
ON_RAMP_SHARP_RIGHT
OFF_RAMP_SHARP_RIGHT
TURN_SHARP_LEFT
ON_RAMP_SHARP_LEFT
OFF_RAMP_SHARP_LEFT
TURN_U_TURN_COUNTERCLOCKWISE
ON_RAMP_U_TURN_COUNTERCLOCKWISE
OFF_RAMP_U_TURN_COUNTERCLOCKWISE
TURN_U_TURN_CLOCKWISE
ON_RAMP_U_TURN_CLOCKWISE
OFF_RAMP_U_TURN_CLOCKWISE
ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_RIGHT_CLOCKWISE
ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
ROUNDABOUT_STRAIGHT_CLOCKWISE
ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
ROUNDABOUT_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_LEFT_CLOCKWISE
ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
ROUNDABOUT_SHARP_LEFT_CLOCKWISE
ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
ROUNDABOUT_U_TURN_CLOCKWISE
ROUNDABOUT_COUNTERCLOCKWISE
ROUNDABOUT_CLOCKWISE
ROUNDABOUT_EXIT_COUNTERCLOCKWISE
ROUNDABOUT_EXIT_CLOCKWISE
MERGE_RIGHT
OFF_RAMP_RIGHT
MERGE_LEFT
OFF_RAMP_LEFT
FORK_RIGHT
TURN_KEEP_RIGHT
ON_RAMP_KEEP_RIGHT
OFF_RAMP_KEEP_RIGHT
FORK_LEFT
TURN_KEEP_LEFT
ON_RAMP_KEEP_LEFT
OFF_RAMP_KEEP_LEFT
MERGE_UNSPECIFIED
DESTINATION
DESTINATION_RIGHT
DESTINATION_LEFT
FERRY_BOAT
FERRY_TRAIN

איך משתמשים בסמלים שנוצרו על ידי AI

רשימה קטנה של סמלים שנוצרו על ידי Navigation SDK.

כדי לתמוך בתרחישי שימוש ב-Android Auto, ערכת ה-SDK לניווט תומכת ביצירת סמלים להנחיות לגבי תמרונים ונתיבים. הסמלים האלה מתאימים להנחיות לגבי גודל התמונה של ספריית האפליקציות לרכב של Android Auto, שבה מומלץ לטרגט תיבה תוחמת בגודל 500x74dp. פרטים נוספים זמינים במאמרי העזרה של Android בנושא setsLaneImage ו-CarIcon.

דוגמה ליצירת סמלים

NavigationUpdatesOptions options =
  NavigationUpdatesOptions.builder()
             .setNumNextStepsToPreview(numNextStepsToPreview)
             .setGeneratedStepImagesType(GeneratedStepImagesType.BITMAP)
             .setDisplayMetrics(getResources().getDisplayMetrics())
             .build();
boolean isRegistered =
          navigator.registerServiceForNavUpdates(
              getPackageName(),
              NavInfoReceivingService.class.getName(),
              options);

אחרי שמפעילים את יצירת הסמלים, האובייקט TurnbyTurn StepInfo מאכלס את השדות maneuverBitmap ו-lanesBitmap בסמלים.

המאמרים הבאים