אתם יכולים להתאים אישית את חוויית הצרכן לנסיעות מתי שנוח, ולאפשר לצרכנים לעקוב אחרי הנסיעה של הזמנה, נסיעה או שירות אחר שאתם מספקים להם.
מה זה 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) למיקומי האיסוף וההורדה.
הצגת המרחק שנותר.
הצגת מצב התנועה בזמן אמת במסלול.
איך פועל ה-SDK לצרכן
באופן כללי, ה-SDK לצרכן מסתמך על המנגנונים הבאים:
- תפקידים מתאימים ב-Fleet Engine, כדי שאפליקציה מאומתת תוכל לעקוב אחרי הנסיעה שמשויכת להזמנה של הלקוח.
- שיוך בין הצרכן לנסיעה, שסופק על ידי המערכת לקצה העורפי.
- מחלקות ה-SDK של
TripModelו-JourneySharingSessionשיוצרות מודלים של נתוני נסיעות ומשתפות סשנים של נסיעות באפליקציה למשתמשים.
ה-SDK לצרכן מספק גם ממשקים ומחלקות אחרים, כדי שתוכלו ליצור חוויית שימוש עשירה באפליקציה עם פרטים כמו תנועה, סמנים במפה, זמן הגעה משוער ונתוני מסלול.
בטבלה הזו מוצג תהליך הנסיעה באפליקציה למשתמשים.
| 1 | בקשת נסיעה באפליקציה למשתמשים | שרת הקצה העורפי מקבל בקשה לנסיעה על פי דרישה ומבצע את הפעולות הבאות:
|
| 2 | הנהג מאשר את הנסיעה | אפליקציית הנהג מקבלת את מזהה הנסיעה ואת פרטי הנסיעה, והנהג מאשר את הנסיעה. |
| 3 | אפליקציה למשתמשים מבקשת גישה למעקב אחרי הנסיעה | האפליקציה למשתמשים מקבלת את מזהה הנסיעה מה-backend שלכם ומבקשת להתחיל לעקוב אחרי הנסיעה. |
| 4 | הנהג מתחיל את הנסיעה | כשהנהג משתמש באפליקציה לנהגים כדי לציין שהנסיעה התחילה, האפליקציה שולחת התראה לשרת בק-אנד באמצעות ה-SDK לנהגים. לדוגמה, כשהנהג עומד לצאת מהמסעדה או לנסוע למיקום האיסוף. |
| 5 | Fleet Engine מתחיל לשלוח את פרטי הנסיעה | Fleet Engine מתחיל לעקוב אחרי הנסיעה ולשתף את ההתקדמות שלה עם האפליקציה למשתמשים. |
| 6 | האפליקציה למשתמשים מציגה את פרטי הנסיעה | האפליקציה למשתמשים שולחת התראה למשתמש ומתחילה להציג לו את פרטי הנסיעה, ומתעדכנת ככל שהנסיעה מתקדמת. |
| 7 | הנסיעה בוטלה או הסתיימה | כשהנהג מבטל או משלים את הנסיעה, אפליקציית הנהג משביתה את מעקב המיקום, ושרת בק-אנד מורה ל-Fleet Engine לסמן את הנסיעה כמבוטלת או כהושלמה. |
| 8 | האפליקציה למשתמשים מפסיקה לעקוב אחרי הנסיעה | הנסיעה מוצגת כמבוטלת או ככזו שהסתיימה. |
| 9 | התהליך חוזר על עצמו בנסיעה הבאה | נוצרת נסיעה חדשה והתהליך חוזר על עצמו. |
איך משתמשים ב-Consumer SDK
כדי לראות איך מתחילים לעקוב אחרי נסיעות באפליקציות למשתמשים, צריך לבחור את הפלטפורמה הרלוונטית.
Android
| 1 | הגדרת Consumer SDK ב-Android | כדי לעקוב אחרי נסיעות לפי דרישה באפליקציה, צריך להגדיר את Consumer SDK. מידע נוסף זמין במאמר Get the Android Consumer SDK. |
| 2 | הגדרת הממשק החזותי | כדי להגדיר את חוויית הצרכן, מגדירים מפה ומוסיפים תמיכה במפות וקטוריות. מידע נוסף זמין במאמר הגדרת מפה. |
| 3 | מעקב אחרי נסיעה | מעקב אחרי נסיעה כדי לשתף את המיקום של הרכב הרלוונטי עם הלקוח. מידע נוסף זמין במאמר מעקב אחרי נסיעה. |
| 5 | עדכון ההתקדמות של הנסיעה וטיפול בשגיאות בנסיעה | לעדכן פרטים על הנסיעות, כמו מרחק הנסיעה וזמן ההגעה המשוער, ולטפל בשגיאות במהלך הנסיעה. מידע נוסף זמין במאמרים עדכון ההתקדמות בנסיעה וטיפול בשגיאות בנסיעה. |
| 5 | כשהנסיעה מסתיימת, מפסיקים לעקוב | כדי להפסיק לשתף את מיקום הרכב עם הלקוח, צריך להפסיק את המעקב אחרי הנסיעה. מידע נוסף זמין במאמר הפסקת המעקב אחרי נסיעה. |
iOS
| 1 | הגדרת Consumer SDK ב-iOS | כדי לעקוב אחרי נסיעות לפי דרישה באפליקציה, צריך להגדיר את Consumer SDK. מידע נוסף זמין במאמר הורדת Consumer SDK ל-iOS. |
| 2 | הגדרת הממשק החזותי | מאתחלים את תצוגת המפה ומטפלים באירועים במפה כדי להגדיר את חוויית הצרכן. מידע נוסף זמין במאמר הגדרת מפה. |
| 3 | מעקב אחרי נסיעה | מעקב אחרי נסיעה כדי לשתף את המיקום של הרכב הרלוונטי עם הלקוח. מידע נוסף זמין במאמר מעקב אחרי נסיעה. |
| 5 | עדכון ההתקדמות של הנסיעה וטיפול בשגיאות בנסיעה | לעדכן פרטים על הנסיעות, כמו מרחק הנסיעה וזמן ההגעה המשוער, ולטפל בשגיאות במהלך הנסיעה. מידע נוסף זמין במאמרים עדכון ההתקדמות בנסיעה וטיפול בשגיאות בנסיעה. |
| 5 | כשהנסיעה מסתיימת, מפסיקים לעקוב | כדי להפסיק לשתף את מיקום הרכב עם הלקוח, צריך להפסיק את המעקב אחרי הנסיעה. מידע נוסף זמין במאמר הפסקת המעקב אחרי נסיעה. |
JavaScript
| 1 | הגדרת Consumer SDK ב-JavaScript | כדי לעקוב אחרי נסיעות לפי דרישה באפליקציה, צריך להגדיר את Consumer SDK. מידע נוסף זמין במאמר הגדרת Consumer SDK ל-JavaScript. |
| 2 | טעינה והתאמה אישית של מפה | כדי להגדיר את חוויית הצרכן, צריך להפעיל את Maps JavaScript API ולהגדיר הרשאה. מידע נוסף זמין במאמר הגדרת מפה. |
| 3 | מעקב אחרי נסיעה | מעקב אחרי נסיעה כדי לשתף את המיקום של הרכב הרלוונטי עם הלקוח. מידע נוסף זמין במאמר מעקב אחרי נסיעה. |
| 5 | עדכון ההתקדמות של הנסיעה וטיפול בשגיאות בנסיעה | לעדכן פרטים על הנסיעות, כמו מרחק הנסיעה וזמן ההגעה המשוער, ולטפל בשגיאות בנסיעה. מידע נוסף זמין במאמרים עדכון ומעקב אחרי התקדמות הנסיעה וטיפול בשגיאות בנסיעה. |
| 5 | כשהנסיעה מסתיימת, מפסיקים לעקוב | כדי להפסיק לשתף את מיקום הרכב עם הלקוח, צריך להפסיק את המעקב אחרי הנסיעה. מידע נוסף זמין במאמר הפסקת המעקב אחרי נסיעה. |
רכיבים
בקטע הזה מפורטים שני הרכיבים שנדרשים כדי לעקוב אחרי נסיעה:
אפשר גם להתאים אישית את חוויית הצרכן באמצעות הרכיבים הבאים:
אחזור של אסימון אימות
כדי לשלוט בגישה לנתוני המיקום שמאוחסנים ב-Fleet Engine, צריך לבצע את הפעולות הבאות:
מטמיעים בשרת שירות ליצירת אסימון אינטרנט מסוג JSON (JWT) ל-Fleet Engine. מידע נוסף זמין במאמר הנפקת אסימוני JWT.
מטמיעים מאחזר של אסימון אימות באפליקציות לאינטרנט או לנייד כדי לאמת את הגישה לנתוני המיקום. מידע נוסף על הגדרת מאחזר טוקנים זמין במדריך ההגדרה ל-Android, ל-iOS או ל-JavaScript.
תצוגת מפה ומעקב אחרי נסיעות
מעקב אחרי נסיעה כולל רכיבים להצגה חזותית של כלי רכב ונקודות ציון, וגם פידים של נתונים גולמיים של זמן ההגעה המשוער של הנהג או המרחק שנותר לנסיעה.
הרכיבים האלה מתוארים בטבלה הבאה:
| רכיב | תיאור |
|---|---|
| תצוגת מפה לצרכנים | תצוגת המפה מנהלת את מחזור החיים של הנסיעה, ומציגה נקודות ציון של מיקום הרכבים במהלך הנסיעה. אם המסלול של הרכב ידוע, תצוגת המפה מעדכנת את הקו הפוליגוני של מסלול הרכב כדי לציין את התקדמות הרכב לאורך המסלול. |
| ספק מיקום הנסיעה ב-JavaScript | באפליקציות אינטרנט ב-JavaScript, ספק המיקום של הנסיעה מזין את פרטי המיקום של האובייקטים שאחריהם מתבצע מעקב במפה המשותפת של הנסיעה. מידע נוסף זמין במאמר יצירת מופע של ספק מיקום לנסיעה.
אתם יכולים להשתמש בספק המיקום של הנסיעה כדי לעקוב אחרי הפרטים הבאים של הנסיעה:
|
אובייקטים של מיקומים במעקב
ספק המיקום עוקב אחרי המיקום של אובייקטים כמו נקודות ציון וכלי רכב, שמתוארים בטבלה הבאה.
| מיקום במעקב | תיאור |
|---|---|
| מקום איסוף | מיקום האיסוף הוא המיקום שבו הנסיעה מתחילה. |
| מיקום היעד | מיקום היעד הוא המיקום שבו הנסיעה מסתיימת. הוא מסמן את נקודת ההורדה. |
| מיקום של נקודת ציון | נקודת ציון היא כל מיקום ביניים לאורך המסלול של נסיעה במעקב. מבחינה טכנית, נקודות ציון יכולות לכלול מיקומים של איסוף והורדה, אבל בדרך כלל הן מתייחסות לעצירות ביניים לאורך המסלול. לדוגמה, התחנות בין מיקום האיסוף למיקום היעד במסלול משלוח הן מיקומים של נקודות ציון. מידע נוסף זמין במאמר נקודות עצירה בנסיעה במסמכי התיעוד של Fleet Engine. |
| מיקום הרכב | מיקום הרכב הוא המיקום המדווח של הרכב. למידע נוסף, קראו את המאמר מיקום הרכב במסמכי התיעוד של Fleet Engine. |
עיצוב המפות
הסגנונות של הסמנים והקווים הפוליגוניים קובעים את המראה והתחושה של אובייקטי המיקום במעקב במפה. אתם יכולים להשתמש באפשרויות סגנון אישי כדי להתאים את הסגנון של אפליקציית האינטרנט.
שליטה בהרשאות הגישה של המיקומים שבמעקב
ספקי המיקום שהוגדרו מראש ב-Fleet Engine פועלים לפי כללי החשיפה הבאים לאובייקטים של מיקום במעקב במפה. אם אתם יוצרים ספק מיקום בהתאמה אישית או ספק מיקום נגזר, אתם יכולים לשנות את כללי החשיפה.
כלי הרכב גלויים רק כשהנסיעה מתבצעת: כלי הרכב של הנסיעה גלוי מרגע שהוא מוקצה לנסיעה ועד לרגע ההורדה. אם הנסיעה מבוטלת, כלי הרכב לא גלוי יותר.
כל שאר סמני המיקום תמיד גלויים: כל שאר סמני המיקום של נקודת המוצא, היעד ונקודות הציון תמיד מוצגים במפה. לדוגמה, מיקום הורדה של נסיעה או מיקום מסירה של משלוח תמיד מוצגים במפה, בלי קשר למצב הנסיעה או המשלוח.
המאמרים הבאים
כדי לעקוב אחרי נסיעות, עיינו במסמכי התיעוד של הפלטפורמה הרלוונטית: