במסמכים שבקטע הזה מוסבר איך ליצור נסיעות ולעבוד איתן באמצעות שירות הנסיעות על פי דרישה של מפות Google. ההנחה היא שאתם מכירים את הנושאים הבאים:
- Fleet Engine: כדאי להכיר את פרטי ההטמעה של Fleet Engine, את מנגנוני הבקשות ואת האבטחה. לפרטים נוספים, אפשר לעיין במאמר מהו השירות של Fleet Engine? ובנושאי האבטחה במאמר הגדרת Fleet Engine.
- מידע בסיסי על כלי רכב לשירותים על פי דרישה. מבוא לכלי רכב
- היסודות של נסיעות בשירותים על פי דרישה. נסיעות על פי דרישה
ה-TripService שבו תשתמשו זמין ל-gRPC ול-REST.
מטעמי פשטות, ההפניות לשדות פועלות בהתאם למוסכמה של gRPC.
ב-Fleet Engine לשירותים על פי דרישה, נסיעה היא סוג של מסלול שמתאר את תהליך הביצוע של בקשה של לקוח למשלוח מזון או לנסיעה. לכל נסיעה יש סטטוס שעליכם לדווח עליו ל-Fleet Engine במהלך הנסיעה, כמו NEW, ENROUTE_TO_PICKUP ועוד. סטטוס הנסיעה תואם לנקודות ציון גיאוגרפיות שהוקצו לרכב, ומערכת Fleet Engine משנה את נקודות הציון האלה בכל עדכון נסיעה שאתם מבצעים. מידע נוסף על נסיעות והקשר שלהן לכלי רכב זמין במאמר נסיעות על פי דרישה בקטע היסודות של Fleet Engine.
מחזור החיים של נסיעה
כדי לעקוב אחרי כל נסיעה ב-Fleet Engine, צריך קודם ליצור ישות Trip. אפשר לעיין במאמרים בנושא gRPC או REST.
בטבלה הבאה מתואר תהליך לדוגמה של נסיעה שנוצרה במערכת, והשלבים במחזור החיים שלה ב-Fleet Engine. ההנחה היא שהגדרתם את Fleet Engine ויש לכם רכב להקצות לנסיעה, עם עדכוני מיקום מופעלים באפליקציית הנהג. אפשר לעיין במאמר Driver SDK: נסיעות על פי דרישה.
| 1 | קבלת בקשת הזמנה | לפני תחילת הנסיעה ב-Fleet Engine, מערכת ההזמנות מקבלת קודם בקשה לנסיעה או למשלוח מצרכן דרך האפליקציה או מערכת הזמנות אחרת. לאחר מכן המערכת יוצרת את ישות הנסיעה באמצעות CreateTrip עם שדות חובה, כמו מיקום האיסוף.
בשלב הזה, המערכת יכולה גם להגדיר שדות אחרים, כמו מספר הנוסעים ומיקום המסירה, או להמתין עד שהיא תקצה רכב. איך יוצרים נסיעה ליעד אחד |
| 2 | הקצאת רכב | אתם יכולים להקצות כלי רכב לנסיעות ישירות במערכת ולדווח על ההקצאה ל-Fleet Engine, או להשתמש בשירות חיפוש רכב כדי לחפש כלי רכב, לסנן לפי מאפייני הנסיעה ומאפייני הרכב ולמצוא את הרכב המתאים ביותר להשלים את הנסיעה. כל רכב אונליין שנמצא ברדיוס החיפוש שלכם מעדכן את המיקום שלו באמצעות Driver SDK, כדי להציג את הקרבה שלו. אחרי ש- |
| 3 | עדכון הנסיעה | אחרי שהנהג מאשר את הנסיעה ומתחיל לנווט לנקודת האיסוף, המערכת מעדכנת את סטטוס הנסיעה מ-NEW ל-ENROUTE_TO_PICKUP. אתם ממשיכים לבצע סקרים לגבי מיקום הרכב לאורך המסע, דרך חיבור ישיר מהאפליקציה לקצה העורפי או באמצעות סקרים של Fleet Engine, שמקבלת מ-Driver SDK מקור נתונים רציף של עדכוני מיקום הרכב. לאחר מכן, המערכת מדווחת על כל ציון דרך בנסיעה ל-Fleet Engine, שמעדכן את רשימת נקודות הדרך ברכב בהתאם.
|
| 4 | שיתוף המסלול עם הצרכן | Fleet Engine מאפשר ל-Consumer SDK לגשת לפרטי הנסיעה ולמיקום הרכב. ה-SDK משתמש בבורר כדי לקבל עדכונים על הנסיעה ולהציג אותם באפליקציה של הצרכן. Fleet Engine מעדכן באופן אוטומטי את זמן ההגעה המשוער, המרחק שנותר, המסלולים ונקודות העצירה שנותרו ברכב. מידע נוסף זמין במאמר שיתוף מסלולי נסיעה בנסיעות על פי דרישה. |
| 5 | השלמת הנסיעה. | אחרי שהרכב מגיע לנקודת היעד של הנסיעה והנהג מציין שהנסיעה הסתיימה, המערכת מגדירה את הערך של TripStatus ל-COMPLETE ב-Fleet Engine. חשוב לזכור שבדומה לכלי רכב, ישויות של נסיעות נשארות פעילות ב-Fleet Engine למשך 7 ימים, ללא קשר לסטטוס שלהן, ולאחר מכן הן יוסרו. |
תהליך הרצף של הנסיעה
בתרשים הבא מוצגת תצוגה מפורטת יותר של התהליך.
