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