סקירה כללית על נסיעות על פי דרישה ב-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 עובד

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

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

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

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

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

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

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

רכיבים

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

• ‫Authentication token fetcher (כלי לאחזור טוקן אימות).
• תצוגת מפה וכלי מעקב אחר נסיעות.

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

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

אחזור אסימון אימות

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

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

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

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

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

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

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

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

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

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

שינוי הסגנון של המפות

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

שליטה בהרשאות הגישה של המיקומים שבמעקב

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

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

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

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

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

• Android
• iOS
• JavaScript