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