برای اطلاعات کلی در مورد نحوه کار وسایل نقلیه در Fleet Engine، به راهنماهای زیر در بخش ضروری Fleet Engine مراجعه کنید:
مستندات این بخش نحوه ایجاد و مدیریت وسایل نقلیه در Fleet Engine را شرح می‌دهد. شما وسایل نقلیه را در محیط سرور Fleet Engine ایجاد می‌کنید تا منعکس کننده وسایل نقلیه واقعی در عملیات دنیای واقعی شما باشند. وسایل نقلیه Fleet Engine شما همچنین باید با وسایل نقلیه مورد استفاده در سیستم backend شما که برای تخصیص و مسیریابی وسایل نقلیه استفاده می‌کنید، مطابقت داشته باشند.
شما از متد create برای ایجاد یک منبع وسیله نقلیه، چه با استفاده از gRPC و چه با استفاده از REST، استفاده می‌کنید. نام فیلدها در این راهنما برای سادگی از نمادگذاری gRPC استفاده می‌کنند.
سفرهای درخواستی
-
CreateVehicleRequest(gRPC) -
providers.vehicle.create(REST) - منبع
Vehicle( REST ، gRPC )
وظایف برنامه‌ریزی‌شده
-
CreateDeliveryVehicleRequest(gRPC) -
providers.deliveryVehicles.create(REST) -
DeliveryVehicle( REST ، gRPC )
درخواست‌های خودرو
برای هر دو قابلیت وظیفه‌ی درخواستی و زمان‌بندی‌شده، شما با صدور یک پیام درخواست حاوی فیلدهایی که به شرح زیر خلاصه می‌شوند، یک وسیله نقلیه ایجاد و به‌روزرسانی می‌کنید:
- والد : رشته‌ای مرتبط با شناسه پروژه گوگل کلود شما که برای پر کردن فیلد نام نمونه خودرو استفاده می‌شود.
شناسه وسیله نقلیه : یک رشته منحصر به فرد که برای پر کردن فیلد
nameوسیله نقلیه استفاده می‌شود.یک نمونه وسیله نقلیه به همراه فیلدهای مورد نیاز آن. این فیلدها به قابلیت Fleet Engine مورد استفاده شما بستگی دارند.
اطلاعات موجود در متن درخواست بسته به ماهیت درخواست متفاوت است. برای جزئیات بیشتر به راهنماهای مربوطه مراجعه کنید.
توکن‌های احراز هویت و مجوز
درخواست‌ها به Fleet Engine همچنین باید اعتبارنامه‌های دسترسی صحیح را ارائه دهند. مثال‌های موجود در این راهنما فرضیات زیر را در نظر گرفته‌اند:
- مثال‌های gRPC فرض را بر استفاده از کتابخانه‌ی Authorization برای جاوا می‌گذارند.
- مثال‌های REST یک هدر درخواست HTTP را نشان می‌دهند که باید شامل فیلد
Authorizationبا مقدارBearer <token>باشد که<token>یک JSON Web Token است که شما صادر می‌کنید .
برای جزئیات بیشتر، به راهنماهای راه‌اندازی موتور ناوگان مراجعه کنید.
فیلدهای منابع خودرو
یک منبع وسیله نقلیه دارای انواع فیلدهای زیر است:
- فیلدهای فقط خروجی . فیلدهایی که توسط سرویس به عنوان خروجی متد دیگری تنظیم شده‌اند و نمی‌توانند مستقیماً تنظیم شوند . یک فیلد مهم از این نوع، فیلد
nameاست. Fleet Engine هر مقدار ارائه شده برای فیلدnameوسیله نقلیه را که طبق راهنمایی Google AIP برای شناسه‌های مشخص شده توسط کاربر ارائه می‌شود، نادیده می‌گیرد. اگر مقادیری را برای این فیلدها ارائه دهید، Fleet Engine خطا می‌دهد. - فیلدهای الزامی . وسایل نقلیه ایجاد شده در سرویس سفر درخواستی نیاز به تنظیم فیلدهای خاصی در هنگام ایجاد دارند. وسایل نقلیه ایجاد شده در سرویس وظایف زمان‌بندی شده، هیچ فیلد منبع وسیله نقلیه الزامی ندارند.
- فیلدهای اختیاری . هر دو سرویس فیلدهایی دارند که می‌توانید هنگام ایجاد یا پس از آن تنظیم کنید. این فیلدها را می‌توانید در راهنمای مرجع مربوط به سرویسی که استفاده می‌کنید، پیدا کنید.
نام وسیله نقلیه (فقط خروجی)
فیلد name دقیقاً برای سفرهای درخواستی و سرویس‌های وظیفه‌ای زمان‌بندی‌شده یکسان است. موتور ناوگان (Fleet Engine) این فیلد را هنگام ایجاد وسیله نقلیه، بر اساس دو فیلدی که در هنگام ایجاد وسیله نقلیه تنظیم کرده‌اید، تعریف می‌کند:
والد : رشته‌ای مرتبط با شناسه پروژه گوگل کلود شما در فرم
providers/{provider}که در آن{provider}شناسه پروژه کلود شماست. هر وسیله نقلیه‌ای که برای یک پروژه مشخص ایجاد می‌کنید، مسیر والد یکسانی خواهد داشت.پروژه ابری که در اینجا به آن اشاره می‌کنید، باید شامل نقش‌های حساب سرویس Fleet Engine برای سرویسی که استفاده می‌کنید نیز باشد. برای مشاهده لیست این حساب‌های سرویس، به بخش حساب‌های سرویس مراجعه کنید. Fleet Engine از دسترسی از چندین پروژه Google Cloud پشتیبانی نمی‌کند.
شناسه وسیله نقلیه ، که باید در تمام وسایل نقلیه ناوگان شما منحصر به فرد باشد و یک رشته یونیکد معتبر باشد. این شناسه منبع وسیله نقلیه است. هم سفرهای درخواستی و هم توقف‌های برنامه‌ریزی شده از این شناسه برای مرتبط کردن یک سفر یا یک کار با وسیله نقلیه‌ای که آن را تکمیل می‌کند، استفاده می‌کنند.
در سرویس‌های مبتنی بر ابر گوگل، تمام APIها باید منابع را به صورت رشته نمایش دهند. برای جزئیات بیشتر به بخش نامگذاری منابع در Fleet Engine مراجعه کنید.
شناسه‌های منحصر به فرد موجودیت
قالب و مقدار شناسه‌های موجودیت منحصر به فرد مورد استفاده در فراخوانی‌های منابع برای Fleet Engine مبهم است. مطمئن شوید که شناسه حاوی هیچ گونه اطلاعات شخصی قابل شناسایی (PII) مانند شماره تلفن راننده نباشد.
استفاده مجدد از وسیله نقلیه
پس از اینکه یک وسیله نقلیه تمام توقف‌های یک برنامه سفر مشخص را انجام داد، به مدت ۷ روز برای استفاده مجدد در Fleet Engine در دسترس باقی می‌ماند، به این معنی که می‌توانید در روزهای کاری بعدی بدون نیاز به ایجاد وسیله نقلیه جدید، از یک وسیله نقلیه دوباره استفاده کنید. هر بار که از یک وسیله نقلیه دوباره استفاده می‌کنید، Fleet Engine میزان در دسترس بودن آن را مجدداً تنظیم می‌کند و در این مرحله شمارش معکوس ۷ روزه از نو شروع می‌شود.
رویکرد توصیه‌شده برای در دسترس نگه‌داشتن یک وسیله نقلیه در Fleet Engine، به‌روزرسانی موقعیت مکانی آن در فواصل منظم است. به‌روزرسانی اکثر فیلدهای دیگر در موجودیت Vehicle نیز عمر آن را افزایش می‌دهد، مشروط بر اینکه مقدار فیلد جدید با مقدار موجود متفاوت باشد.
نکته: برخی از فیلدهای موجود در موجودیت Vehicle مانند device_settings صرفاً اطلاعات اشکال‌زدایی هستند که توسط Fleet Engine ذخیره نمی‌شوند. به‌روزرسانی آنها طول عمر موجودیت Vehicle را افزایش نمی‌دهد.
برای بهبود تجزیه و تحلیل سیستم، بهتر است هر روز از همان شناسه راننده-وسیله نقلیه استفاده کنید. این کار را با استفاده از همان شناسه وسیله نقلیه مرتبط با راننده برای توقف‌های برنامه‌ریزی شده قبلی یا سفرهای درخواستی انجام دهید.