מידע כללי על האופן שבו כלי רכב פועלים ב-Fleet Engine זמין במדריכים הבאים בקטע 'מידע חיוני על Fleet Engine':
במסמכי התיעוד שבקטע הזה מוסבר איך ליצור ולנהל כלי רכב ב-Fleet Engine. אתם יוצרים כלי רכב בסביבת השרת של Fleet Engine כדי לשקף את כלי הרכב בפועל בפעילות שלכם בעולם האמיתי. הרכבים ב-Fleet Engine צריכים להיות זהים לרכבים במערכת העורפית שבה אתם משתמשים להקצאת רכבים ולניתוב.
משתמשים בשיטת יצירה כדי ליצור משאב של רכב, באמצעות gRPC או REST. כדי לפשט את המדריך הזה, השתמשנו בשמות השדות בסימון gRPC.
נסיעות על פי דרישה
-
CreateVehicleRequest(gRPC) -
providers.vehicle.create(REST) - משאב
Vehicle(REST, gRPC)
משימות מתוזמנות
-
CreateDeliveryVehicleRequest(gRPC) -
providers.deliveryVehicles.create(REST) -
DeliveryVehicle(REST, gRPC)
בקשות רכב
גם כדי ליצור רכב וגם כדי לעדכן אותו, צריך לשלוח הודעת בקשה עם שדות. הנה סיכום של השדות:
- ההורה: מחרוזת שמשויכת למזהה הפרויקט ב-Google Cloud, ומשמשת לאכלוס השדה name של מופע הרכב.
The ID for the vehicle: מחרוזת ייחודית שמשמשת לאכלוס השדה
nameשל הרכב.מופע של רכב עם שדות החובה שלו. השדות האלה תלויים ביכולת של Fleet Engine שבה אתם משתמשים.
המידע בגוף הבקשה משתנה בהתאם לסוג הבקשה. פרטים נוספים מופיעים במדריכים הרלוונטיים.
טוקנים של אימות והרשאה
בנוסף, בבקשות ל-Fleet Engine צריך לספק את פרטי הגישה הנכונים. הדוגמאות במדריך הזה מבוססות על ההנחות הבאות:
- בדוגמאות ל-gRPC מניחים שמשתמשים בספריית ההרשאות ל-Java.
- בדוגמאות של REST מוצגת כותרת של בקשת HTTP, שחייבת להכיל את השדה
Authorizationעם הערךBearer <token>, כאשר<token>הוא אסימון אינטרנט בפורמט JSON שאתם מנפיקים.
פרטים נוספים זמינים במדריכים בנושא הגדרת Fleet Engine.
שדות של משאב הרכב
למשאב של כלי רכב יש את סוגי השדות הבאים:
- שדות פלט בלבד. שדות שהשירות מגדיר כפלט של שיטה אחרת ואי אפשר להגדיר אותם ישירות. שדה חשוב מהסוג הזה הוא השדה
name. Fleet Engine מתעלם מכל ערך שסופק בשדהnameשל הרכב בהתאם להנחיות של Google AIP בנושא מזהים שצוינו על ידי המשתמש. אם תספקו ערכים בשדות האלה, Fleet Engine יחזיר שגיאה. - שדות חובה. כשיוצרים כלי רכב בשירות נסיעות על פי דרישה, צריך להגדיר שדות מסוימים בזמן היצירה. לרכבים שנוצרו בשירות של משימות מתוזמנות אין שדות חובה של משאבי רכב.
- שדות אופציונליים. בשני השירותים יש שדות שאפשר להגדיר בזמן היצירה או לאחר מכן. אפשר למצוא אותם במדריך העזר המתאים לשירות שבו אתם משתמשים.
שם הרכב (פלט בלבד)
השדה name זהה בדיוק גם לנסיעות לפי דרישה וגם לשירותים של משימות מתוזמנות. Fleet Engine מגדיר את השדה כשיוצרים את הרכב, על סמך שני שדות שמגדירים כשיוצרים את הרכב:
ההורה: מחרוזת שמשויכת למזהה הפרויקט ב-Google Cloud, בתבנית
providers/{provider}, כאשר{provider}הוא מזהה הפרויקט ב-Cloud. לכל רכב שיוצרים בפרויקט מסוים יהיה אותו נתיב אב.פרויקט ה-Cloud שאליו מתייחסים כאן צריך לכלול גם את התפקידים של חשבון השירות של Fleet Engine בשירות שבו אתם משתמשים. רשימת חשבונות השירות האלה מופיעה במאמר חשבונות שירות. Fleet Engine לא תומך בגישה מכמה פרויקטים ב-Google Cloud.
המזהה של הרכב, שחייב להיות ייחודי לכל הרכבים בצי שלכם ומחרוזת Unicode תקינה. זהו מזהה המשאב של הרכב. גם בנסיעות לפי דרישה וגם בעצירות מתוזמנות נעשה שימוש בנתון הזה כדי לשייך נסיעה או משימה לכלי הרכב שמבצע אותה.
בשירותים מבוססי-Google Cloud, כל ממשקי ה-API חייבים לייצג משאבים כמחרוזות. פרטים נוספים זמינים במאמר שמות של משאבים ב-Fleet Engine.
מזהים ייחודיים של ישויות
הפורמט והערך של מזהי הישות הייחודיים שמשמשים בקריאות למשאבים הם אטומים ל-Fleet Engine. חשוב לוודא שהמזהה לא מכיל פרטים אישיים מזהים (PII), כמו מספר הטלפון של הנהג.
שימוש חוזר ברכב
אחרי שרכב משלים את כל העצירות במסלול מסוים, הוא נשאר זמין לשימוש חוזר ב-Fleet Engine למשך 7 ימים. כלומר, אפשר להשתמש ברכב בימי עסקים עוקבים בלי ליצור רכב חדש. בכל פעם שמשתמשים מחדש ברכב, Fleet Engine מאפס את הזמינות שלו, ובשלב הזה מתחיל מחדש הספירה לאחור של 7 ימים.
הדרך המומלצת לשמור על זמינות של רכב ב-Fleet Engine היא לעדכן את המיקום שלו במרווחי זמן קבועים. עדכונים ברוב השדות האחרים בישות Vehicle יאריכו גם הם את משך החיים שלה, בתנאי שהערך החדש של השדה שונה מהערך הקיים.
הערה: חלק מהשדות בישות Vehicle, כמו device_settings, הם נתוני ניפוי באגים בלבד שלא נשמרים ב-Fleet Engine. עדכון שלהם לא מאריך את משך החיים של ישות Vehicle.
כדי לשפר את ניתוח המערכת, מומלץ להשתמש שוב באותו צימוד של מזהה נהג-רכב מיום ליום. כדי לעשות את זה, צריך להשתמש באותו מזהה רכב שמקושר לנהג עבור עצירות מתוזמנות קודמות או נסיעות לפי דרישה.