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

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

אפליקציה לצרכנים אחרי נסיעה

מהו ה-SDK לצרכנים?

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

ממשקי ה-API הספציפיים לפלטפורמה של Consumer SDK מאפשרים לכם לשלב את היכולת לשתף תהליכים באופן מקורי באפליקציות שלכם. ערכת ה-SDK לצרכן זמינה לפלטפורמות הבאות:

למה כדאי להשתמש ב-SDK לצרכן?

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

מה אפשר לעשות עם ה-SDK לצרכנים?

אפשר להשתמש במידע מ-Driver SDK ומ-Fleet Engine כדי ליצור חוויות לקוח מותאמות אישית, כולל התכונות הבאות:

  • להתאים אישית את ממשק המשתמש של המפה בהתאם לצרכים של המיתוג.

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

  • הצגת זמן ההגעה המשוער (ETA) למיקומי האיסוף וההורדה.

  • הצגת המרחק שנותר.

  • הצגת תנועה בזמן אמת במסלול.

איך פועל Consumer SDK

ככלל, ערכת ה-SDK לצרכן מסתמכת על המנגנונים הבאים:

  • יש לכם את התפקידים המתאימים ב-Fleet Engine כדי שאפליקציה מאומתת תוכל לעקוב אחרי הנסיעה שמשויכת להזמנה של צרכן.
  • שיוך בין הצרכן לנסיעה, שמסופק על ידי מערכת הקצה העורפי.
  • כיתות ה-SDK TripModel ו-JourneySharingSession, שמציגות מודל של נתוני הנסיעה ומשתפות סשנים של נסיעות באפליקציה של הצרכן.

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

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

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

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

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