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