סקירה כללית על נסיעות על פי דרישה ב-Consumer SDK

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

מהו Consumer SDK?

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

ממשקי ה-API הספציפיים לפלטפורמה של Consumer SDK מאפשרים לכם לשלב באפליקציות שלכם את היכולת לשתף תהליכים באופן מקורי. ערכת ה-SDK לצרכן זמינה לפלטפורמות הבאות:

• Android
• iOS
• JavaScript

למה כדאי להשתמש ב-Consumer SDK?

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

מה אפשר לעשות עם Consumer SDK?

אתם יכולים להשתמש במידע מ-Driver SDK ומ-Fleet Engine כדי ליצור חוויות מותאם אישית של צרכנים, כולל התכונות הבאות:

• להתאים אישית את ממשק המשתמש של המפה בהתאם לצרכים של המיתוג.

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

• הצגת זמן ההגעה המשוער (ETA) למיקומי האיסוף וההורדה.

• הצגת המרחק שנותר.

• הצגת נתוני תנועה בזמן אמת במסלול.

איך פועל Consumer SDK

באופן כללי, Consumer SDK מסתמך על המנגנונים הבאים:

• יש לכם את התפקידים המתאימים ב-Fleet Engine כדי שאפליקציה מאומתת תוכל לעקוב אחרי הנסיעה שמשויכת להזמנה של צרכן.
• שיוך בין הצרכן לנסיעה, שמסופק על ידי מערכת הקצה העורפי.
• כיתות ה-SDK TripModel ו-JourneySharingSession, שמציגות מודל של נתוני הנסיעה ומשתפות סשנים של נסיעות באפליקציה של הצרכן.

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

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

1	בקשה לנסיעה באפליקציה של הצרכן	השרת העורפי מקבל בקשה לנסיעה על פי דרישה, ומבצע את הפעולות הבאות: יצירת נסיעה ב-Fleet Engine. הקצאת הנסיעה לרכב.
2	הנהג/ת מאשר/ת את הנסיעה	אפליקציית הנהג מקבלת את מזהה הנסיעה ואת פרטי הנסיעה, והנהג מאשר את הנסיעה.
3	אפליקציית הצרכן מבקשת גישה כדי לעקוב אחרי הנסיעה	באפליקציית הצרכן מקבלים את מזהה הנסיעה מהקצה העורפי ומבקשים להתחיל לעקוב אחרי הנסיעה.
4	הנהג מתחיל את הנסיעה	כשהנהג משתמש באפליקציית הנהג כדי לציין שהנסיעה מתחילה, האפליקציה מעדכנת את שרת הקצה העורפי דרך Driver SDK. לדוגמה, כשהנהג עומד לצאת מהמסעדה או לנסוע לנקודת האיסוף.
5	המערכת של Fleet Engine מתחילה לשלוח את פרטי הנסיעה	מערכת Fleet Engine מתחילה לעקוב אחרי הנסיעה ולשתף את ההתקדמות שלה עם אפליקציית הצרכן.
6	פרטי הנסיעה מוצגים באפליקציה של הצרכן	באפליקציה של הצרכן תופיע התראה, והוא יתחיל לראות את פרטי הנסיעה ועדכונים עליה.
7	הנסיעה בוטלה או הושלמה	כשהנהג מבטל או משלים את הנסיעה, מעקב המיקום מושבת באפליקציה של הנהג, ושרת הקצה העורפי מורה ל-Fleet Engine לסמן את הנסיעה כ'מבוטל' או כ'הושלמה'.
8	האפליקציה של הצרכן מפסיקה לעקוב אחרי הנסיעה	הנסיעה תופיע כ'בוטלה' או כ'הושלמה'.
9	התהליך חוזר על עצמו בנסיעה הבאה	נוצרת נסיעה חדשה והתהליך חוזר על עצמו.

איך משתמשים ב-Consumer SDK

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

רכיבים

בקטע הזה נסכם שני רכיבים נדרשים למעקב אחרי נסיעה:

• אחזור של טוקן אימות.
• תצוגת מפה ומעקב אחר נסיעות.

אפשר גם להתאים אישית את חוויית הצרכן באמצעות הרכיבים הבאים:

• עיצוב המפות
• שליטה בחשיפה של המיקומים שבמעקב.

אחזור של טוקן אימות

כדי לשלוט בגישה לנתוני המיקום שמאוחסנים ב-Fleet Engine, צריך לבצע את הפעולות הבאות:

1. הטמעת שירות ליצירת אסימוני JWT (JSON Web Token) ל-Fleet Engine בשרת. מידע נוסף זמין במאמר הנפקת אסימוני JWT.

2. מטמיעים גורם לאחזור אסימון אימות באפליקציות האינטרנט או בנייד כדי לאמת את הגישה לנתוני המיקום. מידע נוסף על הגדרת אוסף אסימונים זמין במדריך ההגדרה ל-Android, ל-iOS או ל-JavaScript.

תצוגת מפה ומעקב אחר נסיעות

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

הרכיבים האלה מתוארים בטבלה הבאה:

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

אובייקטים של מיקומים במעקב

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

המיקום במעקב	תיאור
מקום איסוף	מיקום האיסוף הוא המיקום שבו מתחילה הנסיעה.
מיקום היעד	מיקום היעד הוא המיקום שבו הנסיעה מסתיימת. הוא מסמן את מיקום המסירה.
מיקום של ציון דרך	מיקום של נקודת ציון הוא כל מיקום ביניים לאורך המסלול של נסיעה במעקב. מבחינה טכנית, נקודות דרך יכולות לכלול את מיקומי האיסוף וההורדה, אבל בדרך כלל הן מתייחסות לעצירות ביניים במסלול. לדוגמה, תחנות העצירה בין נקודת האיסוף לנקודת היעד במסלול המשלוח הן מיקומי נקודות ציון. מידע נוסף זמין במאמר נקודות ציון בנסיעה במסמכי התיעוד של Fleet Engine.
מיקום הרכב	מיקום הרכב הוא המיקום המדווח של הרכב. למידע נוסף, קראו את המאמר מיקום הרכב במסמכי התיעוד של Fleet Engine.

עיצוב המפות

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

שליטה בחשיפה של המיקומים שבמעקב

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

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

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

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

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

• Android
• iOS
• JavaScript