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

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

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

מהו 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

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

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

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

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

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