דף זה תורגם על ידי Cloud Translation API.

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

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

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

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

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

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

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

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

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

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

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

שם הרכב (פלט בלבד)

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

ההורה: מחרוזת שמשויכת למזהה הפרויקט שלכם ב-Google Cloud של טופס providers/{provider} כאשר {provider} הוא המזהה של הענן שלך פרויקט. לכל רכב שיוצרים בפרויקט מסוים בנתיב ההורה.

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

בשירותים המבוססים על Google Cloud, כל ממשקי ה-API חייבים לייצג משאבים באמצעות מחרוזות. לפרטים נוספים, ראו מתן שמות למשאבים ב-Fleet Engine.

מזהי ישויות ייחודיים

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

שימוש חוזר ברכב

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

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

הערה: חלק מהשדות בישות Vehicle, כמו device_settings, מיועדים רק לניפוי באגים שלא נשמרים על ידי Fleet Engine. העדכון שלהן לא להאריך את חיי הישות Vehicle.

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