مستندات این بخش نحوه ایجاد و کار با سفرها را با استفاده از سرویس سفرهای درخواستی Google Maps Mobility نشان می‌دهد. آشنایی با موارد زیر را در نظر می‌گیرد:
- موتور ناوگان : شما باید با جزئیات پیاده‌سازی، مکانیسم‌های درخواست و امنیت موتور ناوگان آشنا باشید. برای این منظور، به بخش «سرویس موتور ناوگان چیست؟» و مباحث امنیتی در «راه‌اندازی موتور ناوگان» مراجعه کنید.
- اصول اولیه وسایل نقلیه برای خدمات درخواستی. به مقدمه‌ای بر وسایل نقلیه مراجعه کنید.
- اصول اولیه سفر برای خدمات درخواستی. به سفرهای درخواستی مراجعه کنید.
TripService که استفاده خواهید کرد برای gRPC و REST در دسترس است. برای سادگی، ارجاعات فیلد از قرارداد gRPC پیروی می‌کنند.
در Fleet Engine برای سرویس‌های درخواستی، یک سفر نوعی سفر است که انجام یک درخواست تحویل غذا یا سواری از مصرف‌کنندگان شما را مدل‌سازی می‌کند. یک سفر وضعیتی دارد که شما با پیشرفت سفر به Fleet Engine گزارش می‌دهید، مانند NEW ، ENROUTE_TO_PICKUP و موارد دیگر. وضعیت سفر با نقاط مسیر جغرافیایی اختصاص داده شده به وسیله نقلیه مطابقت دارد و Fleet Engine این نقاط مسیر وسیله نقلیه را با هر به‌روزرسانی سفری که انجام می‌دهید، تغییر می‌دهد. برای اطلاعات بیشتر در مورد سفرها و ارتباط آنها با وسایل نقلیه، به بخش سفرهای درخواستی در Fleet Engine essentials مراجعه کنید.
زندگی یک سفر
برای ردیابی هر سفر در Fleet Engine، ابتدا باید یک موجودیت Trip ایجاد کنید. برای مرجع به gRPC یا REST مراجعه کنید.
جدول زیر نمونه‌ای از جریان پیوسته یک سفر ایجاد شده در سیستم شما و مراحل چرخه عمر آن در Fleet Engine را شرح می‌دهد. فرض بر این است که شما Fleet Engine را راه‌اندازی کرده‌اید و وسیله نقلیه‌ای برای اختصاص به سفر دارید و به‌روزرسانی‌های موقعیت مکانی در برنامه راننده فعال است. به Driver SDK: On-demand trips مراجعه کنید.
| ۱ | دریافت درخواست رزرو. | قبل از شروع سفر با Fleet Engine، سیستم رزرو شما ابتدا از طریق برنامه یا سیستم رزرو دیگر، درخواستی برای سفر یا تحویل از یک مصرف‌کننده دریافت می‌کند. سپس سیستم شما با استفاده CreateTrip و فیلدهای مورد نیاز، مانند محل تحویل، موجودیت سفر را ایجاد می‌کند. همچنین می‌تواند در این مرحله فیلدهای دیگری مانند مسافران و محل تحویل را تنظیم کند یا منتظر بماند تا وسیله نقلیه‌ای را اختصاص دهد. به بخش ایجاد یک سفر تک مقصدی مراجعه کنید. |
| ۲ | وسیله نقلیه اختصاص دهید. | شما می‌توانید مستقیماً درون سیستم خود، وسایل نقلیه را به سفرها اختصاص دهید و این اختصاص را به Fleet Engine گزارش دهید، یا می‌توانید از سرویس جستجوی وسیله نقلیه برای جستجوی وسایل نقلیه استفاده کنید و با فیلتر کردن بر اساس ویژگی‌های سفر و وسیله نقلیه، بهترین وسیله نقلیه را برای تکمیل سفر پیدا کنید. هر وسیله نقلیه آنلاین در شعاع جستجوی شما، نزدیکی خود را از طریق به‌روزرسانی‌های موقعیت مکانی ارائه شده توسط Driver SDK اعلام می‌کند. به محض اینکه |
| ۳ | سفر را به‌روزرسانی کنید. | به محض اینکه راننده سفر را پذیرفت و شروع به حرکت به سمت محل تحویل بار کرد، سیستم شما وضعیت سفر را از NEW به ENROUTE_TO_PICKUP به‌روزرسانی می‌کند. شما در طول سفر، یا از طریق اتصال مستقیم برنامه به backend خود، یا با نظرسنجی از Fleet Engine که جریان مداوم به‌روزرسانی‌های موقعیت مکانی خودرو را از Driver SDK دریافت می‌کند، به جمع‌آوری اطلاعات موقعیت مکانی خودرو ادامه می‌دهید. سپس سیستم شما هر نقطه عطف سفر را به Fleet Engine گزارش می‌دهد که فهرست نقاط مسیر خودرو را بر اساس آن به‌روزرسانی می‌کند. |
| ۴ | سفر را با مصرف‌کننده به اشتراک بگذارید. | Fleet Engine جزئیات سفر و موقعیت مکانی خودرو را در اختیار Consumer SDK قرار می‌دهد که از یک شنونده برای دریافت به‌روزرسانی‌های سفر و نمایش آنها در برنامه مصرف‌کننده استفاده می‌کند. Fleet Engine به طور خودکار ETA، مسافت باقیمانده، مسیرها و نقاط مسیر باقیمانده خودرو را به‌روزرسانی می‌کند. برای اطلاعات بیشتر به Share journeys برای سفرهای درخواستی مراجعه کنید. |
| ۵ | سفر کامل. | به محض اینکه وسیله نقلیه به نقطه مقصد سفر برسد و راننده شما سفر موفقیت‌آمیز را اعلام کند، سیستم شما TripStatus را در Fleet Engine روی COMPLETE تنظیم می‌کند. به خاطر داشته باشید که مانند وسایل نقلیه، موجودیت‌های سفر صرف نظر از وضعیت، به مدت ۷ روز در Fleet Engine فعال می‌مانند و در آن زمان حذف می‌شوند. |
جریان توالی سفر
نمودار زیر نمای دقیق‌تری از این جریان را نشان می‌دهد.
