מבוא: יצירת רכבים

למידע כללי על האופן שבו כלי רכב פועלים ב-Fleet Engine, תוכלו לעיין בהדרכות הבאות בקטע 'מידע חיוני על Fleet Engine':

• מהו Fleet Engine?
• מבוא לכלי רכב

במסמכים שבקטע הזה מוסבר איך יוצרים כלי רכב ומנהלים אותם ב-Fleet Engine. אתם יוצרים רכבים בסביבת השרת של Fleet Engine כדי לשקף את הרכבים בפועל בפעילות שלכם בעולם האמיתי. כלי הרכב ב-Fleet Engine צריכים להתאים גם לאלה שבהם אתם משתמשים במערכת הקצה העורפי, שבה אתם משתמשים להקצאת כלי רכב ולניתוב.

משתמשים ב-method create כדי ליצור משאב רכב, באמצעות gRPC או REST. שמות השדות במדריך הזה מבוססים על סימון gRPC כדי לפשט את הקריאה.

נסיעות על פי דרישה

• CreateVehicleRequest (gRPC)
• providers.vehicle.create (‏REST)
• משאב Vehicle (REST, ‏ gRPC)

משימות מתוזמנות

• CreateDeliveryVehicleRequest (gRPC)
• providers.deliveryVehicles.create (‏REST)
• DeliveryVehicle (REST, ‏ gRPC)

הערה: הודעות הבקשה ושדות המשאבים של שני משאבי הרכב ב-Fleet Engine דומים במידה רבה, למרות שחלק מהשמות משתנים בין השניים.

בקשות לכלי רכב

כדי ליצור ולעדכן כלי רכב, גם לצורך משימות על פי דרישה וגם לצורך משימות מתוזמנות, שולחים הודעת בקשה עם שדות, כפי שמתואר בהמשך:

1. האב: מחרוזת שמשויכת למזהה הפרויקט ב-Google Cloud, שמשמשת לאכלוס שדה השם של מופע הרכב.

2. המזהה של הרכב: מחרוזת ייחודית שמשמש לאכלוס השדה name של הרכב.

   הערה: למחרוזות של מזהי כלי רכב יש הגבלות מסוימות על תווים. מומלץ להימנע מיצירת מזהי עלייה אוטומטית ולוודא שהם לא מכילים פרטים אישיים מזהים. פרטים על הגבלות התווים מופיעים בשדה מזהה הרכב ב-CreateVehicleRequest או ב-CreateDeliveryVehicleRequest.

3. מכונה של רכב עם השדות הנדרשים. השדות האלה תלויים ביכולות של Fleet Engine שבהן אתם משתמשים.

המידע בגוף הבקשה משתנה בהתאם לסוג הבקשה. הפרטים האלה מפורטים במדריכים הרלוונטיים.

טוקנים של אימות והרשאה

בבקשות ל-Fleet Engine צריך לציין גם את פרטי הכניסה הנכונים. הדוגמאות במדריך הזה מבוססות על ההנחות הבאות:

• בדוגמאות ל-gRPC נעשה שימוש ב-Authorization library ל-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.

כדי לשפר את ניתוח הנתונים של המערכת, מומלץ להשתמש שוב באותו התאמה של מזהה הנהג למזהה הרכב מדי יום. כדי לעשות זאת, צריך להשתמש באותו מזהה רכב שמשויך לנהג בתחנות מתוזמנות קודמות או בנסיעות על פי דרישה.

המאמרים הבאים

• יצירת רכב לנסיעות על פי דרישה
• יצירת כלי לצורך משימות מתוזמנות