برای اطلاعات کلی در مورد نحوه عملکرد وسایل نقلیه در Fleet Engine، به راهنمای زیر در بخش Fleet Engine ضروری مراجعه کنید:
مستندات این بخش نحوه ایجاد و مدیریت وسایل نقلیه در Fleet Engine را شرح می دهد. شما وسایل نقلیه ای را در محیط سرور Fleet Engine ایجاد می کنید تا وسایل نقلیه واقعی را در عملیات دنیای واقعی خود منعکس کنید. وسایل نقلیه Fleet Engine شما همچنین باید مطابق با وسایل مورد استفاده در سیستم backend شما باشد که برای تخصیص وسایل نقلیه و مسیریابی استفاده می کنید.
شما از یک روش ایجاد برای ایجاد یک منبع وسیله نقلیه، یا با استفاده از 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 است که شما صادر می‌کنید .
برای جزئیات بیشتر، به راهنمای تنظیم 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، همه APIها باید منابع را به صورت رشته نمایش دهند. برای جزئیات بیشتر به نامگذاری منابع در Fleet Engine مراجعه کنید.
شناسه های موجودیت منحصر به فرد
قالب و مقدار شناسه های موجودیت منحصر به فرد مورد استفاده در فراخوانی منابع برای Fleet Engine غیرشفاف است. اطمینان حاصل کنید که شناسه حاوی اطلاعات قابل شناسایی شخصی (PII) مانند شماره تلفن راننده نباشد.
استفاده مجدد از خودرو
پس از اینکه یک وسیله نقلیه تمام توقف‌های یک برنامه سفر مشخص را انجام داد، برای استفاده مجدد در Fleet Engine به مدت 7 روز در دسترس باقی می‌ماند، به این معنی که می‌توانید در روزهای کاری بعدی از یک وسیله نقلیه مجدداً استفاده کنید بدون اینکه نیازی به ایجاد وسیله‌ای جدید داشته باشید. هر بار که از وسیله نقلیه استفاده مجدد می کنید، Fleet Engine در دسترس بودن آن را بازنشانی می کند، در این مرحله شمارش معکوس 7 روزه از نو شروع می شود.
روش توصیه شده برای در دسترس نگه داشتن یک وسیله نقلیه در Fleet Engine این است که مکان آن را در فواصل زمانی منظم به روز کنید. به‌روزرسانی‌های بیشتر فیلدهای دیگر موجودیت Vehicle نیز عمر آن را افزایش می‌دهد، مشروط بر اینکه مقدار فیلد جدید با مقدار موجود متفاوت باشد.
توجه: برخی از فیلدهای موجود در Vehicle مانند device_settings صرفاً اطلاعات اشکال زدایی هستند که توسط Fleet Engine وجود ندارد. به روز رسانی آنها عمر Vehicle را افزایش نمی دهد.
برای تجزیه و تحلیل سیستم بهبود یافته، بهتر است از جفت شدن شناسه راننده-خودرو هر روز دوباره استفاده کنید. این کار را با استفاده از همان شناسه وسیله نقلیه مرتبط با راننده برای توقف های برنامه ریزی شده قبلی یا سفرهای درخواستی انجام دهید.