כדי להטמיע את נתוני הנסיעה וההזמנות, צריך לעבוד עם כמה מרכיבי הפתרונות לנוסעים ולמשלוחים על פי דרישה – Fleet Engine, Consumer SDK ו-Driver SDK:
Fleet Engine הוא שירות לקצה העורפי של פתרונות לפי דרישה לנסיעות ולמשלוחים. הוא אחראי על ניהול הנסיעות ומצב הרכבים. הוא מטפל בטרנזקציות בין Driver SDK לבין ה-SDK של הצרכן ושירות הקצה העורפי שלכם – שיכול לתקשר עם Fleet Engine באמצעות קריאות REST או gRPC.
Consumer SDK היא ספריית לקוח שאתם משלבים באפליקציה לצרכנים. באחריותה להציג את חוויית שיתוף הנסיעה, שכוללת מעקב אחר מסלול הנהג, המרחק שנותר וזמן ההגעה המשוער. Consumer SDK יכול להיות יכול להיות לנייד (Android או iOS) או לאינטרנט (JavaScript).
Driver SDK היא ספריית לקוח שאתם משלבים באפליקציית הנהג. ה-Fleet Engine אחראי לעדכון המיקום, המסלול, המרחק שנותר וזמן ההגעה המשוער ב-Fleet Engine. הוא גם כולל את ה-SDK של הניווט, שמספק לנהג הוראות ניווט מפורטות. למידע נוסף, ראו ניווט עם מפות Google.
תרשים הארכיטקטורה הבא מציג את הקשר בין הרכיבים האלה:
נסיעות, כלי רכב וציוני דרך
כדי ליצור אפליקציה מסוג 'נסיעה והזמנה' צריך לעבוד עם נסיעות, כלי רכב וציוני דרך.
נסיעות
נסיעה מייצגת מסע – הנסיעה שמעבירה את הצרכן (או את הארוחה שהוא הזמין) מנקודת האיסוף אל נקודת ההורדה, כולל ציוני דרך בדרך.
אובייקט Trip כולל באופן פרוגרמטי את המיקום, היעד, המיקום הנוכחי של הרכב, מסלול הנסיעה, ציוני הדרך בדרך וסוג הנסיעה (בלעדי או משותף).
רכבים
רכב מייצג כלי רכב בצי שלך. אובייקט Vehicle מציג באופן פרוגרמטי את מיקום הרכב, רשימה של נסיעות עדכניות ורשימה של ציוני דרך עדכניים.
נקודות ציון
ציון דרך מייצג מיקום לאורך מסלול. היא יכולה להיות נקודת איסוף, נקודת הורדה או ציון דרך במעבר. אובייקט Waypoint באופן פרוגרמטי מכיל את המיקום של ציון הדרך כקבוצה של קואורדינטות גיאוגרפיות, את סוג ציון הדרך ומזהה הנסיעה שכולל את ציון הדרך.
גם הנסיעות וגם כלי הרכב מכילים ציוני דרך:
קבוצת ציוני הדרך של נסיעה מכילה את כל ציוני הדרך הרלוונטיים לנסיעה. המידע הזה יכול לכלול ציוני דרך לנסיעות אחרות, אם הנסיעה משותפת עם שאר הנסיעות.
קבוצת ציוני הדרך של כלי רכב מכילה את כל ציוני הדרך שנותרו לרכב, כולל ציוני דרך לכמה נסיעות.
תהליך לדוגמה
התרשים הבא מציג את התהליך הטיפוסי של התקדמות הנסיעה וההזמנה. אפשר לקרוא מידע נוסף במאמר איך יוצרים ומציגים נסיעה ליעד אחד.
בשלבים הבאים מתואר איך להגדיר את התהליך לדוגמה:
יוצרים רכב, מפעילים את שיתוף המיקום ומגדירים את מצב הרכב לאונליין. יצירת כלי רכב באמצעות Fleet Engine. תוכלו להגדיר את מצב הרכב לאונליין דרך Fleet Engine או דרך Driver SDK.
מתאימים לקוח לרכב. אפשר להשתמש בשיטה
SearchVehicles()כדי למצוא רשימה של כלי רכב פוטנציאליים מהצי שלכם.יצירת נסיעה ב-Flet Engine, הקצאה של הרכב לנסיעה הזו, שיוך הנסיעה לאפליקציה לצרכנים ואפשרות לתת לנהג את נקודות האיסוף וההורדה.
ה-SDK של Drive מעדכן באופן אוטומטי את זמן ההגעה המשוער, המרחק והמסלול במהלך הנסיעה. באחריותכם לעדכן את סטטוס הנסיעה.
על מנת להתחיל בהטמעת ההתקדמות של הנסיעה וההזמנה, קראו את המאמר יצירה והצגה של נסיעה ליעד יחיד.