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