התאמה אישית של חוויית הלקוח בנסיעות על פי דרישה, על ידי מתן אפשרות ללקוחות לעקוב אחרי הנסיעה בהזמנה, בנסיעה או בשירות אחר שאתם מספקים להם.
מה זה Consumer SDK?
Consumer SDK הוא חלק מ-Fleet Engine לנסיעות על פי דרישה. היא מספקת ממשקי משתמש שמדמים נתוני נסיעות ועוקבים אחרי נסיעות ב-Fleet Engine, והיא מספקת מחלקות שמשמשות ליצירת תצוגה עשירה שמבוססת על מפה כדי לשתף נסיעות עם משתמשי הקצה. כדי ליצור את חוויית הלקוח הזו, משלבים את Consumer SDK באפליקציה ומגדירים את פרופילי התפקידים המתאימים ב-Fleet Engine.
ממשקי ה-API הספציפיים לפלטפורמה של Consumer SDK מאפשרים לכם להוסיף לאפליקציות שלכם את האפשרות לשתף מסלולים באופן מובנה. ערכת ה-SDK לצרכנים זמינה בפלטפורמות הבאות:
למה כדאי להשתמש ב-Consumer SDK?
שילוב של Consumer SDK באפליקציות שלכם להזמנת נסיעות מאפשר לכם לספק חוויית משתמש מקיפה, עם עדכוני מיקום כמעט בזמן אמת ומיקומים שמוצמדים לכביש. הלקוחות יכולים לראות את המסלול של הרכב על גבי מפה, כולל פרטי התקדמות שיעזרו להם להבין איפה הנסיעה או המשלוח שלהם נמצאים.
מה אפשר לעשות עם Consumer SDK
אתם יכולים להשתמש במידע מ-Driver SDK ומ-Fleet Engine כדי ליצור חוויות מותאמות אישית ללקוחות, כולל התכונות הבאות:
התאמה אישית של ממשק המשתמש של המפה כדי שיתאים לצרכים של המיתוג שלכם.
לעקוב אחרי המיקום הנוכחי של הרכב בזמן שהוא נוסע לאורך המסלול, כשהמיקום מתעדכן מדי פעם.
הצגת זמן ההגעה המשוער (ETA) למיקומי איסוף ומסירה.
הצגת המרחק שנותר.
הצגת נתוני תנועה בזמן אמת במסלול.
איך פועל Consumer SDK
באופן כללי, Consumer SDK מסתמך על המנגנונים הבאים:
- להקצות את התפקידים המתאימים ב-Fleet Engine כדי שאפליקציה מאומתת תוכל לעקוב אחרי הנסיעה שמשויכת להזמנה של לקוח.
- שיוך בין הצרכן לבין הנסיעה, שמתקבל ממערכת ה-Backend שלכם.
- מחלקות ה-SDK
TripModelו-JourneySharingSessionשמדמות נתוני נסיעה ומשתפות סשנים של נסיעות באפליקציה למשתמשים.
ערכת ה-SDK לצרכנים מספקת גם ממשקים וסיווגים אחרים, כך שתוכלו ליצור חוויית אפליקציה עשירה עם פרטים כמו נתוני תנועה, סמני מיקום במפה, זמן הגעה משוער ונתוני מסלול.
בטבלה הזו מוצג רצף הפעולות של נסיעה באפליקציה למשתמשים.
| 1 | אפליקציה למשתמשים שולחת בקשה לנסיעה | השרת העורפי מקבל בקשה לנסיעה על פי דרישה ומבצע את הפעולות הבאות:
|
| 2 | הנהג/ת מאשר/ת את הנסיעה | אפליקציית הנהג מקבלת את מזהה הנסיעה ואת פרטי הנסיעה, והנהג מאשר את הנסיעה. |
| 3 | אפליקציה למשתמשים מבקשת גישה כדי לעקוב אחרי הנסיעה | אפליקציה למשתמשים מקבלת את מזהה הנסיעה מהבק-אנד שלכם ומבקשת להתחיל לעקוב אחרי הנסיעה. |
| 4 | הנהג מתחיל את הנסיעה | כשהנהג משתמש באפליקציית הנהג כדי לציין שהנסיעה התחילה, האפליקציה שולחת הודעה לשרת העורפי שלכם דרך Driver SDK. לדוגמה, כשהנהג עומד לצאת מהמסעדה או לנסוע למיקום האיסוף. |
| 5 | מערכת Fleet Engine מתחילה לשלוח פרטי נסיעה | Fleet Engine מתחיל לעקוב אחרי הנסיעה ולשתף את ההתקדמות שלה עם אפליקציה למשתמשים. |
| 6 | אפליקציה למשתמשים מציגה את פרטי הנסיעה | אפליקציה למשתמשים שולחת למשתמש הודעה ומתחילה להציג לו את פרטי הנסיעה, ומעדכנת את הנסיעה ככל שהיא מתקדמת. |
| 7 | הנסיעה בוטלה או הושלמה | כשהנהג מבטל את הנסיעה או מסיים אותה, אפליקציית הנהג משביתה את מעקב המיקום, ושרת הקצה העורפי שלכם אומר ל-Fleet Engine לסמן את הנסיעה כמבוטלת או כהושלמה. |
| 8 | האפליקציה למשתמשים מפסיקה לעקוב אחרי הנסיעה | הנסיעה מופיעה כנסיעה שבוטלה או כנסיעה שהושלמה. |
| 9 | התהליך חוזר על עצמו בנסיעה הבאה | נוצרת נסיעה חדשה והתהליך חוזר על עצמו. |
איך משתמשים ב-Consumer SDK
כדי לראות איך מתחילים לעקוב אחרי נסיעות באפליקציות לצרכנים, בוחרים את הפלטפורמה.
Android
| 1 | הגדרת Consumer SDK ב-Android | כדי לעקוב אחרי נסיעות על פי דרישה באפליקציה, צריך להגדיר את Consumer SDK. מידע נוסף מופיע במאמר בנושא קבלת Android Consumer SDK. |
| 2 | הגדרת הממשק החזותי | כדי להגדיר את חוויית הלקוח, צריך להגדיר מפה ולהוסיף תמיכה במפות וקטוריות. מידע נוסף מופיע במאמר בנושא הגדרת מפה. |
| 3 | איך עוקבים אחרי נסיעה | כדי לשתף עם הלקוח את המיקום של הרכב המתאים, צריך לעקוב אחרי הנסיעה. מידע נוסף מופיע במאמר בנושא מעקב אחרי נסיעה. |
| 5 | עדכון התקדמות הנסיעה וטיפול בשגיאות בנסיעה | לעדכן פרטים על הנסיעות, כמו מרחק הנסיעה וזמן ההגעה המשוער, ולטפל בשגיאות שמתרחשות במהלך הנסיעה. מידע נוסף זמין במאמרים עדכון התקדמות הנסיעה וטיפול בשגיאות בנסיעה. |
| 5 | כשמסיימים את הנסיעה, מפסיקים לעקוב | כדי להפסיק את שיתוף המיקום של הרכב עם הלקוח, צריך להפסיק את המעקב אחרי הנסיעה. מידע נוסף מופיע במאמר הפסקת המעקב אחרי נסיעה. |
iOS
| 1 | הגדרה של Consumer SDK ב-iOS | כדי לעקוב אחרי נסיעות על פי דרישה באפליקציה, צריך להגדיר את Consumer SDK. מידע נוסף זמין במאמר קבלת ה-SDK לצרכנים ב-iOS. |
| 2 | הגדרת הממשק החזותי | כדי להגדיר את חוויית הלקוח, מאתחלים את תצוגת המפה ומטפלים באירועים במפה. מידע נוסף מופיע במאמר בנושא הגדרת מפה. |
| 3 | איך עוקבים אחרי נסיעה | כדי לשתף עם הלקוח את המיקום של הרכב המתאים, צריך לעקוב אחרי הנסיעה. מידע נוסף מופיע במאמר בנושא מעקב אחרי נסיעה. |
| 5 | עדכון התקדמות הנסיעה וטיפול בשגיאות בנסיעה | לעדכן פרטים על הנסיעות, כמו מרחק הנסיעה וזמן ההגעה המשוער, ולטפל בשגיאות שמתרחשות במהלך הנסיעה. מידע נוסף זמין במאמרים עדכון התקדמות הנסיעה וטיפול בשגיאות בנסיעה. |
| 5 | כשמסיימים את הנסיעה, מפסיקים לעקוב | כדי להפסיק את שיתוף המיקום של הרכב עם הלקוח, צריך להפסיק את המעקב אחרי הנסיעה. מידע נוסף מופיע במאמר הפסקת המעקב אחרי נסיעה. |
JavaScript
| 1 | הגדרה של Consumer SDK ב-JavaScript | כדי לעקוב אחרי נסיעות על פי דרישה באפליקציה, צריך להגדיר את Consumer SDK. מידע נוסף זמין במאמר הגדרת ה-SDK של צרכן JavaScript. |
| 2 | טעינה והתאמה אישית של מפה | כדי להגדיר את חוויית הלקוח, צריך להפעיל את Maps JavaScript API ולהגדיר הרשאה. מידע נוסף מופיע במאמר בנושא הגדרת מפה. |
| 3 | איך עוקבים אחרי נסיעה | כדי לשתף עם הלקוח את המיקום של הרכב המתאים, צריך לעקוב אחרי הנסיעה. מידע נוסף מופיע במאמר בנושא מעקב אחרי נסיעה. |
| 5 | עדכון התקדמות הנסיעה וטיפול בשגיאות בנסיעה | לעדכן פרטים על הנסיעות, כמו מרחק הנסיעה וזמן הגעה משוער, ולטפל בשגיאות בנסיעה. מידע נוסף זמין במאמרים עדכון ומעקב אחר התקדמות הנסיעה וטיפול בשגיאות בנסיעה. |
| 5 | כשמסיימים את הנסיעה, מפסיקים לעקוב | כדי להפסיק את שיתוף המיקום של הרכב עם הלקוח, צריך להפסיק את המעקב אחרי הנסיעה. מידע נוסף מופיע במאמר הפסקת המעקב אחרי נסיעה. |
רכיבים
בקטע הזה מופיע סיכום של שני רכיבים שנדרשים כדי לעקוב אחרי נסיעה:
- Authentication token fetcher (כלי לאחזור טוקן אימות).
- תצוגת מפה וכלי מעקב אחר נסיעות.
אפשר גם להתאים אישית את חוויית הצרכן באמצעות הרכיבים הבאים:
כלי לאחזור טוקן אימות
כדי לשלוט בגישה לנתוני המיקום שמאוחסנים ב-Fleet Engine, צריך לבצע את הפעולות הבאות:
מטמיעים בשרת שירות ליצירת אסימוני JWT (JSON Web Token) עבור Fleet Engine. מידע נוסף זמין במאמר בנושא הנפקת אסימוני JWT.
כדי לאמת את הגישה לנתוני המיקום, צריך להטמיע באפליקציות לנייד או באתרי האינטרנט כלי לאחזור אסימוני אימות. מידע נוסף על הגדרת כלי לאחזור טוקנים זמין במדריך ההגדרה ל-Android, ל-iOS או ל-JavaScript.
תצוגת מפה ומעקב אחר נסיעות
מעקב אחרי נסיעה כולל רכיבים להצגת כלי רכב ונקודות ציון, וגם פידים של נתונים גולמיים לגבי זמן ההגעה המשוער של הנהג או המרחק שנותר לנסיעה.
בטבלה הבאה מתוארים הרכיבים האלה:
| רכיב | תיאור |
|---|---|
| תצוגת מפה לצרכנים | בתצוגת המפה מנוהל מחזור החיים של הנסיעה, ומוצגות נקודות ציון של מיקום כלי הרכב במהלך הנסיעה. אם המסלול של הרכב ידוע, תצוגת המפה מעדכנת את קו הפוליגון של מסלול הרכב כדי לציין את התקדמות הרכב לאורך המסלול. |
| ספק מיקום הנסיעה ב-JavaScript | באפליקציות אינטרנט מבוססות JavaScript, ספק המיקום של הנסיעה מעביר את נתוני המיקום של האובייקטים שבמעקב למפה המשותפת של הנסיעה. מידע נוסף זמין במאמר יצירת מופע של ספק מיקום לנסיעה.
אתם יכולים להשתמש בספק המיקום של הנסיעה כדי לעקוב אחרי הפרטים הבאים של הנסיעה:
|
אובייקטים של מיקומים שנמצאים במעקב
ספק המיקום עוקב אחרי המיקום של אובייקטים כמו נקודות ציון וכלי רכב, שמתוארים בטבלה הבאה.
| מיקום במעקב | תיאור |
|---|---|
| מקום איסוף | מיקום האיסוף הוא המיקום שבו מתחילה הנסיעה. |
| מיקום היעד | מיקום היעד הוא המיקום שבו מסתיים המסלול. הוא מסמן את נקודת ההורדה. |
| מיקום ציון הדרך | מיקום של נקודת ציון הוא כל מיקום ביניים לאורך המסלול של נסיעה במעקב. מבחינה טכנית, נקודות ציון יכולות לכלול מיקומי איסוף ומסירה, אבל בדרך כלל הן מתייחסות לעצירות ביניים לאורך המסלול. לדוגמה, העצירות בין מיקומי האיסוף והיעד במסלול משלוח הן מיקומי ציוני דרך. מידע נוסף זמין במאמר בנושא נקודות ציון במסלול במסמכי התיעוד של Fleet Engine. |
| מיקום הרכב | מיקום הרכב הוא המיקום המדווח של הרכב. מידע נוסף זמין במאמר מיקום הרכב במסמכי התיעוד של Fleet Engine. |
שינוי הסגנון של המפות
סגנונות של סמנים וקווי פוליגון קובעים את המראה והתחושה של אובייקטים של מיקומים במפה. אתם יכולים להשתמש באפשרויות עיצוב בהתאמה אישית כדי להתאים את הסגנון של אפליקציית האינטרנט שלכם.
שליטה בהרשאות הגישה למיקומים שבמעקב
ספקי המיקום המוגדרים מראש ב-Fleet Engine פועלים לפי כללי הנראות הבאים לגבי אובייקטים של מיקומים במפה. אם יוצרים ספק מיקום בהתאמה אישית או ספק מיקום נגזר, אפשר לשנות את כללי החשיפה.
רכבים גלויים רק כשהנסיעה מתבצעת: רכב של נסיעה גלוי מהרגע שהוא משויך לנסיעה ועד לרגע ההורדה. אם הנסיעה מבוטלת, הרכב לא גלוי יותר.
כל סמני המיקום האחרים תמיד גלויים: כל סמני המיקום האחרים של נקודת המוצא, היעד ונקודות הביניים תמיד מוצגים במפה. לדוגמה, מיקום סיום הנסיעה או מיקום מסירת המשלוח תמיד מוצגים במפה, ללא קשר למצב הנסיעה או המשלוח.
המאמרים הבאים
אפשר לעיין בתיעוד של הפלטפורמה שבה רוצים לעקוב אחרי נסיעות: