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