במאמרי העזרה שבקטע הזה מוסבר איך ליצור נסיעות ולעבוד איתן באמצעות שירות הנסיעות על פי דרישה של מפות 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: On-demand trips.
| 1 | קבלת בקשה להזמנה. | לפני שנסיעה ב-Fleet Engine מתחילה, מערכת ההזמנות שלכם מקבלת בקשה לנסיעה או למשלוח מלקוח דרך האפליקציה או מערכת הזמנות אחרת. המערכת יוצרת את ישות הנסיעה באמצעות
CreateTrip עם שדות חובה, כמו מיקום האיסוף.
בשלב הזה אפשר גם להגדיר שדות אחרים, כמו מספר הנוסעים ומיקום ההורדה, או להמתין עד להקצאת רכב. מידע נוסף זמין במאמר יצירת נסיעה עם יעד אחד. |
| 2 | הקצאת רכב. | אפשר להקצות רכבים לנסיעות ישירות במערכת ולדווח על ההקצאה ל-Fleet Engine, או להשתמש בשירות Search Vehicle כדי לחפש רכבים ולסנן לפי מאפייני נסיעה ורכב כדי למצוא את הרכב הכי מתאים להשלמת הנסיעה. כל רכב באינטרנט שנמצא ברדיוס החיפוש שלכם משתף את המיקום שלו באמצעות עדכוני מיקום שמסופקים על ידי Driver SDK. אחרי ש- |
| 3 | thought עדכון הנסיעה. | אחרי שהנהג מאשר את הנסיעה ומתחיל לנווט אל
מיקום האיסוף, המערכת מעדכנת את סטטוס הנסיעה מ-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 ימים, ללא קשר לסטטוס שלהן, ולאחר מכן הן מוסרות. |
תהליך רצף הנסיעות
בתרשים הבא מוצגת תצוגה מפורטת יותר של התהליך הזה.
