سفر درخواستی چیست؟

مستندات این بخش نحوه ایجاد و کار با سفرها را با استفاده از سرویس سفرهای درخواستی Google Maps Mobility نشان می دهد. مستلزم آشنایی با موارد زیر است:

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 را راه‌اندازی کرده‌اید و وسیله نقلیه‌ای برای اختصاص دادن به سفر دارید و به‌روزرسانی‌های مکان در برنامه راننده فعال است. به Driver SDK: سفرهای درخواستی مراجعه کنید.

1 دریافت درخواست رزرو قبل از شروع سفر Fleet Engine، سیستم رزرو شما ابتدا درخواستی برای سواری یا تحویل از مصرف کننده از طریق برنامه شما یا سایر سیستم های رزرو دریافت می کند. سپس سیستم شما موجودیت سفر را با استفاده CreateTrip با فیلدهای مورد نیاز، مانند مکان تحویل، ایجاد می کند. همچنین می‌تواند فیلدهای دیگری را در این نقطه تنظیم کند، مانند مسافران و محل خروج، یا صبر کند تا وسیله نقلیه را تعیین کند. به ایجاد یک سفر تک مقصدی رجوع کنید.
2 وسیله نقلیه را اختصاص دهید

می‌توانید وسایل نقلیه را مستقیماً در سیستم خود به سفرها اختصاص دهید و آن را به Fleet Engine گزارش دهید، یا می‌توانید از سرویس Search Vehicle برای جستجوی وسایل نقلیه استفاده کنید، با فیلتر کردن هر دو ویژگی سفر و وسیله نقلیه برای یافتن بهترین وسیله نقلیه برای تکمیل سفر. هر وسیله نقلیه آنلاین در شعاع جستجوی شما، نزدیکی خود را از طریق به‌روزرسانی‌های مکان ارائه شده توسط Driver SDK مشخص می‌کند.

هنگامی که SearchVehicle وسیله نقلیه ای را که شما آن را به یک سفر مطابقت می دهید برمی گرداند، سیستم شما با نقطه پایانی UpdateTrip تماس می گیرد تا شناسه وسیله نقلیه ای را که به سفر NEW اختصاص داده اید گزارش کند.

3 به روز رسانی سفر هنگامی که راننده سفر را پذیرفت و حرکت به محل تحویل را آغاز کرد، سیستم شما وضعیت سفر را از NEW به ENROUTE_TO_PICKUP به روز می کند. شما همچنان به نظرسنجی مکان وسیله نقلیه در طول سفر ادامه می‌دهید، یا از طریق اتصال مستقیم از برنامه به باطن خود، یا با نظرسنجی Fleet Engine، که جریانی مداوم از به‌روزرسانی‌های مکان خودرو را از Driver SDK دریافت می‌کند. سپس سیستم شما هر نقطه عطف سفر را به Fleet Engine گزارش می‌کند، که لیست نقاط بین راه خودرو را بر این اساس به‌روزرسانی می‌کند.
4 سفر را با مصرف کننده به اشتراک بگذارید Fleet Engine جزئیات سفر و مکان وسیله نقلیه را در دسترس Consumer SDK قرار می‌دهد، که از شنونده برای دریافت به‌روزرسانی‌های سفر و نمایش آن‌ها در برنامه مصرف‌کننده استفاده می‌کند. Fleet Engine به‌طور خودکار ETA، مسافت باقی‌مانده، مسیرها و ایستگاه‌های بین راهی خودرو را به‌روزرسانی می‌کند. برای اطلاعات بیشتر به اشتراک سفرها برای سفرهای درخواستی مراجعه کنید.
5 سفر کامل هنگامی که وسیله نقلیه به مقصد سفر رسید و راننده شما یک سفر موفق را نشان داد، سیستم شما TripStatus را در Fleet Engine روی COMPLETE تنظیم می کند. به خاطر داشته باشید که مانند وسایل نقلیه، اشخاص سفر بدون در نظر گرفتن وضعیت به مدت 7 روز در Fleet Engine فعال می‌مانند و در این مرحله حذف می‌شوند.

جریان توالی سفر

نمودار زیر نمای دقیق تری از این جریان را نشان می دهد.

TripSequenceDiagram

بعدش چی

،

مستندات این بخش نحوه ایجاد و کار با سفرها را با استفاده از سرویس سفرهای درخواستی Google Maps Mobility نشان می دهد. مستلزم آشنایی با موارد زیر است:

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 را راه‌اندازی کرده‌اید و وسیله نقلیه‌ای برای اختصاص دادن به سفر دارید و به‌روزرسانی‌های مکان در برنامه راننده فعال است. به Driver SDK: سفرهای درخواستی مراجعه کنید.

1 دریافت درخواست رزرو قبل از شروع سفر Fleet Engine، سیستم رزرو شما ابتدا درخواستی برای سواری یا تحویل از مصرف کننده از طریق برنامه شما یا سایر سیستم های رزرو دریافت می کند. سپس سیستم شما موجودیت سفر را با استفاده CreateTrip با فیلدهای مورد نیاز، مانند مکان تحویل، ایجاد می کند. همچنین می‌تواند فیلدهای دیگری را در این نقطه تنظیم کند، مانند مسافران و محل خروج، یا صبر کند تا وسیله نقلیه را تعیین کند. به ایجاد یک سفر تک مقصدی رجوع کنید.
2 وسیله نقلیه را اختصاص دهید

می‌توانید وسایل نقلیه را مستقیماً در سیستم خود به سفرها اختصاص دهید و آن را به Fleet Engine گزارش دهید، یا می‌توانید از سرویس Search Vehicle برای جستجوی وسایل نقلیه استفاده کنید، با فیلتر کردن هر دو ویژگی سفر و وسیله نقلیه برای یافتن بهترین وسیله نقلیه برای تکمیل سفر. هر وسیله نقلیه آنلاین در شعاع جستجوی شما، نزدیکی خود را از طریق به‌روزرسانی‌های مکان ارائه شده توسط Driver SDK مشخص می‌کند.

هنگامی که SearchVehicle وسیله نقلیه ای را که شما آن را به یک سفر مطابقت می دهید برمی گرداند، سیستم شما با نقطه پایانی UpdateTrip تماس می گیرد تا شناسه وسیله نقلیه ای را که به سفر NEW اختصاص داده اید گزارش کند.

3 به روز رسانی سفر هنگامی که راننده سفر را پذیرفت و حرکت به محل تحویل را آغاز کرد، سیستم شما وضعیت سفر را از NEW به ENROUTE_TO_PICKUP به روز می کند. شما همچنان به نظرسنجی مکان وسیله نقلیه در طول سفر ادامه می‌دهید، یا از طریق اتصال مستقیم از برنامه به باطن خود، یا با نظرسنجی Fleet Engine، که جریانی مداوم از به‌روزرسانی‌های مکان خودرو را از Driver SDK دریافت می‌کند. سپس سیستم شما هر نقطه عطف سفر را به Fleet Engine گزارش می‌کند، که لیست نقاط بین راه خودرو را بر این اساس به‌روزرسانی می‌کند.
4 سفر را با مصرف کننده به اشتراک بگذارید Fleet Engine جزئیات سفر و مکان وسیله نقلیه را در دسترس Consumer SDK قرار می‌دهد، که از شنونده برای دریافت به‌روزرسانی‌های سفر و نمایش آن‌ها در برنامه مصرف‌کننده استفاده می‌کند. Fleet Engine به‌طور خودکار ETA، مسافت باقی‌مانده، مسیرها و ایستگاه‌های بین راهی خودرو را به‌روزرسانی می‌کند. برای اطلاعات بیشتر به اشتراک سفرها برای سفرهای درخواستی مراجعه کنید.
5 سفر کامل هنگامی که وسیله نقلیه به مقصد سفر رسید و راننده شما یک سفر موفق را نشان داد، سیستم شما TripStatus را در Fleet Engine روی COMPLETE تنظیم می کند. به خاطر داشته باشید که مانند وسایل نقلیه، اشخاص سفر بدون در نظر گرفتن وضعیت به مدت 7 روز در Fleet Engine فعال می‌مانند و در این مرحله حذف می‌شوند.

جریان توالی سفر

نمودار زیر نمای دقیق تری از این جریان را نشان می دهد.

TripSequenceDiagram

بعدش چی