סקירה כללית על נסיעות על פי דרישה ב-Consumer SDK

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

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

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

איך פועל Consumer SDK

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

1 אפליקציה לצרכנים מבקשת נסיעה השרת העורפי מקבל בקשה לנסיעה על פי דרישה ומבצע את הפעולות הבאות:
  • יצירת נסיעה ב-Fleet Engine.
  • הקצאת הנסיעה לרכב.
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, צריך לבצע את הפעולות הבאות:

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

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

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

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

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

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

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

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

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

עיצוב המפות

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

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

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

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

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

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

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