התאמה אישית של חוויית הלקוח לנסיעות על פי דרישה, על ידי מתן אפשרות ללקוחות לעקוב אחרי הנסיעה בהזמנה, בנסיעה או בשירות אחר שאתם מספקים להם.
מהו Consumer SDK?
ה-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
באופן כללי, ה-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 | כשנסיעה מסתיימת, מפסיקים לעקוב | כדי להפסיק את שיתוף המיקום של הרכב עם הלקוח, צריך להפסיק את המעקב אחרי הנסיעה. מידע נוסף זמין במאמר בנושא הפסקת המעקב אחרי נסיעה. |
רכיבים
בקטע הזה מופיע סיכום של שני רכיבים שנדרשים כדי לעקוב אחרי נסיעה:
אפשר גם להתאים אישית את חוויית הצרכן באמצעות הרכיבים הבאים:
כלי לאחזור טוקנים של אימות
כדי לשלוט בגישה לנתוני המיקום שמאוחסנים ב-Fleet Engine, צריך לבצע את הפעולות הבאות:
מטמיעים שירות ליצירת אסימוני JWT (JSON Web Token) ב-Fleet Engine בשרת. מידע נוסף זמין במאמר בנושא הנפקת אסימוני JWT.
כדי לאמת את הגישה לנתוני המיקום, צריך להטמיע באפליקציות האינטרנט או באפליקציות לנייד כלי לאחזור טוקן אימות. מידע נוסף על הגדרת כלי לאחזור טוקנים זמין במדריך ההגדרה ל-Android, ל-iOS או ל-JavaScript.
תצוגת מפה ומעקב אחר נסיעות
התכונה 'מעקב אחרי נסיעה' כוללת רכיבים להצגת כלי רכב ונקודות ציון, וגם פידים של נתונים גולמיים לגבי זמן ההגעה המשוער של הנהג או המרחק שנותר לנסיעה.
בטבלה הבאה מתוארים הרכיבים האלה:
| רכיב | תיאור |
|---|---|
| תצוגת מפה של צרכנים | בתצוגת המפה מנוהל מחזור החיים של הנסיעה, ומוצגות נקודות ציון למיקום כלי הרכב במהלך הנסיעה. אם המסלול של הרכב ידוע, קו הפוליגון של מסלול הרכב בתצוגת המפה מתעדכן כדי לציין את התקדמות הרכב לאורך המסלול. |
| ספק מיקום של נסיעה ב-JavaScript | באפליקציות אינטרנט של JavaScript, ספק המיקום של הנסיעה מעביר את פרטי המיקום של האובייקטים שעוקבים אחריהם למפה המשותפת של הנסיעה. מידע נוסף זמין במאמר יצירת מופע של ספק מיקום לנסיעה.
אפשר להשתמש בספק המיקום של הנסיעה כדי לעקוב אחרי הפרטים הבאים של נסיעה:
|
אובייקטים של מיקומים במעקב
ספק המיקום עוקב אחרי המיקום של אובייקטים כמו נקודות ציון וכלי רכב, שמתוארים בטבלה הבאה.
| מיקום במעקב | תיאור |
|---|---|
| מקום איסוף | מיקום האיסוף הוא המיקום שבו מתחילה הנסיעה. |
| מיקום היעד | מיקום היעד הוא המיקום שבו מסתיים המסלול. הוא מסמן את מיקום המסירה. |
| מיקום ציון הדרך | נקודת ציון היא כל מיקום ביניים לאורך המסלול של נסיעה במעקב. מבחינה טכנית, נקודות ציון יכולות לכלול מיקומי איסוף והורדה, אבל בדרך כלל הן מתייחסות לעצירות ביניים לאורך המסלול. לדוגמה, התחנות בין נקודת האיסוף לבין יעד המשלוח במסלול משלוח הן נקודות ציון. מידע נוסף זמין במאמר בנושא נקודות ציון בנסיעה במסמכי התיעוד של Fleet Engine. |
| מיקום הרכב | מיקום הרכב הוא המיקום המדווח של הרכב. מידע נוסף זמין במאמר מיקום הרכב במסמכי התיעוד של Fleet Engine. |
עיצוב המפות
הסגנונות של הסמן והקו המקוטע קובעים את המראה והתחושה של אובייקטים של מיקומים במפה. אתם יכולים להשתמש באפשרויות עיצוב מותאמות אישית כדי להתאים את הסגנון של אפליקציית האינטרנט שלכם.
שליטה בהרשאות הגישה של המיקומים שבמעקב
ספקי המיקום המוגדרים מראש ב-Fleet Engine פועלים לפי כללי הנראות האלה לגבי אובייקטים של מיקום במעקב במפה. אם יוצרים ספק מיקום בהתאמה אישית או ספק מיקום נגזר, אפשר לשנות את כללי החשיפה.
כלי רכב גלויים רק כשהנסיעה מתבצעת: כלי רכב של נסיעה גלויים מהרגע שהם משויכים לנסיעה ועד לרגע ההורדה. אם הנסיעה מבוטלת, כלי הרכב לא גלויים יותר.
כל סמני המיקום האחרים תמיד גלויים: כל סמני המיקום האחרים של נקודת המוצא, היעד ונקודות הביניים תמיד מוצגים במפה. לדוגמה, מיקום סיום הנסיעה או מיקום מסירת המשלוח תמיד מוצגים במפה, ללא קשר למצב הנסיעה או המשלוח.
המאמרים הבאים
אפשר לעיין בתיעוד של הפלטפורמה שבה רוצים לעקוב אחרי נסיעות: