برای کسب اطلاعات کلی درباره نحوه عملکرد خودروها در 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خودرو استفاده می‌شود.نمونه خودرو با فیلدهای الزامی آن. این فیلدها به قابلیت Fleet Engine که استفاده می‌کنید بستگی دارد.
اطلاعات موجود در بدنه درخواست با ماهیت درخواست متفاوت است. این جزئیات را در راهنمای مربوط به هرکدام ببینید.
نمودارهای اصالت‌سنجی و مجوز
درخواست‌های Fleet Engine باید اعتبارنامه‌های دسترسی صحیح را نیز ارائه دهند. مثال‌های این راهنما فرض‌های زیر را دارند:
- نمونه‌های gRPC استفاده از کتابخانه مجوز برای جاوا را فرض می‌کنند.
- نمونه‌های REST سرایند درخواست HTTP را نشان می‌دهند که باید حاوی
فیلد
Authorizationبا مقدارBearer <token>باشد که<token>JSON Web Token است که شما صادر می‌کنید.
برای جزئیات بیشتر، راهنمای راه‌اندازی 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 پشتیبانی نمی‌کند.
شناسه وسیله نقلیه که باید در همه وسایل نقلیه ناوگان شما یکتا باشد و رشته‌ای معتبر از نوع «یونی‌کد» باشد. این شناسه منبع برای وسیله نقلیه است. هم سفرهای درخواستی و هم توقف‌های زمان‌بندی‌شده از این برای مرتبط کردن سفر یا تکلیف با وسیله نقلیه‌ای که آن را تکمیل می‌کند استفاده می‌کنند.
در سرویس‌های مبتنی بر Google Cloud، همه میاناهای برنامه‌سازی کاربردی باید منابع را به‌صورت رشته نشان دهند. برای جزئیات بیشتر، نام‌گذاری منابع در Fleet Engine را ببینید.
شناسه‌های یکتای نهاد
قالب و مقدار شناسه‌های یکتای نهاد که در تماس‌های منبع استفاده می‌شود برای Fleet Engine مبهم است. مطمئن شوید که شناسه حاوی هیچ‌گونه اطلاعات شناساننده شخصی (PII)، مانند شماره تلفن راننده، نباشد.
استفاده مجدد از خودرو
پس‌از اینکه وسیله نقلیه همه توقف‌های برنامه سفر معینی را تکمیل کرد، به‌مدت ۷ روز برای استفاده مجدد در Fleet Engine دردسترس باقی می‌ماند، یعنی می‌توانید در روزهای کاری بعدی بدون نیاز به ایجاد وسیله نقلیه جدید، از وسیله نقلیه قبلی استفاده کنید. هر بار که از خودرویی مجدداً استفاده می‌کنید، Fleet Engine دردسترس بودن آن را بازنشانی می‌کند و در این نقطه، شمارش معکوس ۷ روزه از نو شروع می‌شود.
رویکرد توصیه‌شده برای دردسترس نگه داشتن وسیله نقلیه در Fleet Engine این است که
مکان آن را در فواصل زمانی منظم به‌روز کنید. به‌روزرسانی اکثر فیلدهای دیگر در نهاد Vehicle نیز عمر آن را افزایش می‌دهد، مشروط بر اینکه مقدار فیلد جدید با مقدار موجود متفاوت باشد.
توجه: برخی‌از فیلدهای نهاد Vehicle مثل device_settings صرفاً اطلاعات اشکال‌زدایی هستند که Fleet Engine آن‌ها را حفظ نمی‌کند. به‌روزرسانی آن‌ها باعث افزایش عمر نهاد Vehicle نمی‌شود.
برای بهبود تجزیه‌وتحلیل سیستم، بهتر است از همان جفت‌سازی شناسه راننده-خودرو روزانه استفاده کنید. این کار را بااستفاده از شناسه خودرو یکسانی که با راننده برای توقف‌های زمان‌بندی‌شده قبلی یا سفرهای درخواستی مرتبط است انجام دهید.