‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

מידע כללי על אופן הפעולה של כלי רכב ב-Fleet Engine מופיע במדריכים הבאים בקטע "מידע בסיסי על Fleet Engine":

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

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

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

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

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

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

בקשות לרכבים

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

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

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

‫The parent: מחרוזת שמשויכת למזהה הפרויקט ב-Google Cloud, בתבנית providers/{provider}, כאשר {provider} הוא המזהה של פרויקט 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.

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