نمای کلی برای به اشتراک گذاری سفرها برای سفرهای درخواستی

وقتی از اشتراک‌گذاری سفر موتور Fleet برای سفرهای درخواستی استفاده می‌کنید، مشتریان می‌توانند پیشرفت سفارش، سواری یا خدمات دیگری را که به آنها ارائه می‌دهید پیگیری کنند.

اپلیکیشن مصرف کننده

اشتراک گذاری سفر چیست؟

اشتراک گذاری سفر یکی از ویژگی های Fleet Engine برای سواری های درخواستی است که برای Consumer SDK استفاده می شود. این رابط‌ها را ارائه می‌کند که داده‌های سفر را مدل‌سازی می‌کند و جلسات سفر را در Fleet Engine دنبال می‌کند، و کلاس‌هایی را که برای ایجاد یک نمایشگر غنی و مبتنی بر نقشه برای اطلاعات سفر برای کاربران مصرف‌کننده‌تان استفاده می‌کنید، ارائه می‌دهد. شما SDK را در برنامه خود ادغام می کنید و پروفایل های نقش مناسب را در Fleet Engine تنظیم می کنید تا از استفاده مصرف کننده از اشتراک گذاری سفر پشتیبانی کند.

Journey sharing API های مخصوص پلتفرم را فراهم می کند، بنابراین می توانید اشتراک گذاری سفر را به صورت بومی در برنامه های خود ایجاد کنید. Consumer SDK برای پلتفرم های زیر در دسترس است:

چرا از اشتراک گذاری سفر استفاده کنیم؟

با ادغام اشتراک‌گذاری سفر در برنامه‌های سفرهای درخواستی خود، یک تجربه نظارت کامل بر وسیله نقلیه را با به‌روزرسانی‌های موقعیت مکانی تقریباً هم‌زمان و موقعیت‌های جاده‌ای فراهم می‌کنید. مشتریان شما می توانند مسیر وسیله نقلیه را که روی نقشه پوشانده شده است، مشاهده کنند، از جمله جزئیات پیشرفت که به آنها کمک می کند بفهمند سواری یا تحویل آنها کجاست.

با اشتراک گذاری سفر چه کاری می توانید انجام دهید؟

می‌توانید از اطلاعات Driver SDK و Fleet Engine برای ایجاد نماهای SDK تلفن همراه غنی و پاسخ‌های سرویس وب استفاده کنید که ویژگی‌های زیر را ارائه می‌کنند:

  • سفارشی‌سازی رابط کاربری نقشه را متناسب با نیازهای نام تجاری خود ارائه دهید.

  • مکان فعلی وسیله نقلیه در حالی که مسیر خود را در مسیر طی می کند و موقعیت آن به طور دوره ای به روز می شود.

  • زمان تخمینی رسیدن (ETA) برای مکان‌های تحویل و تحویل.

  • فاصله باقی مانده

  • ترافیک زنده در مسیر.

اشتراک گذاری سفر چگونه کار می کند

در سطح بالا، اشتراک گذاری سفر به مکانیسم های زیر متکی است:

  • نقش های کاربر Fleet Engine مناسب به طوری که کاربران برنامه تأیید شده بتوانند سفر مرتبط با سفارش خود را دریافت کنند.
  • ارتباط بین مصرف کننده و سفر، ارائه شده توسط سیستم باطن شما.
  • کلاس‌های SDK TripModel و JourneySharingSession ، SDK که داده‌های سفر را مدل‌سازی می‌کنند و جلسات سفر را در برنامه مصرف‌کننده به اشتراک می‌گذارند.

اشتراک گذاری سفر

Consumer SDK همچنین رابط‌ها و کلاس‌های دیگری را فراهم می‌کند تا بتوانید یک رابط کاربری نقشه‌برداری برای برنامه خود ایجاد کنید تا مصرف‌کنندگان شما یک تجربه برنامه غنی کامل با جزئیاتی مانند ترافیک، نشانگرهای نقشه، ETA و داده‌های مسیر داشته باشند.

این جدول جریان یک سفر مشترک را نشان می دهد.

1 برنامه مصرف کننده درخواست سفر می کند. سرور باطن شما یک درخواست سفر درخواستی دریافت می کند و کارهای زیر را انجام می دهد:
  • یک سفر در Fleet Engine ایجاد می کند.
  • سفر را به وسیله نقلیه در Fleet Engine اختصاص می دهد.
2 راننده سفر را می پذیرد برنامه راننده شناسه سفر و اطلاعات سفر را دریافت می کند و راننده سفر را می پذیرد.
3 برنامه مصرف کننده درخواست دسترسی به سفر می کند برنامه مصرف کننده شناسه سفر را از باطن شما دریافت می کند و برای شروع اشتراک گذاری سفر درخواست می کند.
4 راننده سفر را شروع می کند هنگامی که راننده از برنامه درایور برای نشان دادن شروع سفر استفاده می کند، برنامه از طریق Driver SDK به سرور پشتیبان شما اطلاع می دهد. به عنوان مثال، زمانی که راننده می خواهد رستوران را ترک کند یا به سمت محل پیکاپ رانندگی کند.
5 Fleet Engine به اشتراک گذاری سفر را آغاز می کند Fleet Engine شروع به ردیابی سفر و به اشتراک گذاری پیشرفت آن با برنامه مصرف کننده می کند.
6 برنامه مصرف کننده سفر را نشان می دهد برنامه مصرف کننده به مصرف کننده اطلاع می دهد و شروع به نمایش سفر برای آنها می کند و با پیشرفت سفر، سفر را به روز می کند.
7 سفر تکمیل یا لغو شد وقتی راننده سفر را لغو یا کامل می‌کند، برنامه راننده ردیابی موقعیت مکانی را غیرفعال می‌کند و سرور باطن شما به Fleet Engine می‌گوید که سفر را لغو یا تکمیل شده علامت‌گذاری کند.
8 برنامه مصرف کننده اشتراک گذاری سفر را متوقف می کند سفر به صورت لغو شده یا کامل نشان داده می شود.
9 این روند برای سفر بعدی تکرار می شود یک سفر جدید ایجاد می شود و روند تکرار می شود.

نحوه استفاده از اشتراک گذاری سفر

پلتفرم خود را انتخاب کنید تا ببینید چگونه می توان سفرها را به اشتراک گذاشت.

اندروید

1 Consumer SDK را در Android تنظیم کنید برای اشتراک‌گذاری سفرها برای سفرهای درخواستی در برنامه خود، Consumer SDK را راه‌اندازی کنید. برای اطلاعات بیشتر، به دریافت Android Consumer SDK مراجعه کنید.
2 رابط بصری اشتراک گذاری سفر را تنظیم کنید یک نقشه تعریف کنید و برای تنظیم رابط سفر خود از نقشه های برداری پشتیبانی کنید. برای اطلاعات بیشتر، به تنظیم نقشه مراجعه کنید.
3 سفر را به اشتراک بگذارید سفری را دنبال کنید تا مکان وسیله نقلیه مناسب را با مصرف کننده خود به اشتراک بگذارید. برای اطلاعات بیشتر، به دنبال یک سفر مراجعه کنید.
5 پیشرفت سفر را به روز کنید و خطاهای سفر را مدیریت کنید جزئیات سفر سفر خود را به‌روزرسانی کنید، مانند مسافت سفر و زمان تخمینی رسیدن، و هرگونه خطا را در طول سفر بررسی کنید. برای اطلاعات بیشتر، به‌روزرسانی پیشرفت سفر و رسیدگی به خطاهای سفر را ببینید.
5 وقتی یک سفر کامل شد، اشتراک گذاری را متوقف کنید برای توقف اشتراک‌گذاری مکان وسیله نقلیه با مصرف‌کننده، سفر را دنبال نکنید. برای اطلاعات بیشتر، توقف دنبال کردن یک سفر را ببینید.

iOS

1 Consumer SDK را در iOS تنظیم کنید برای اشتراک‌گذاری سفرها برای سفرهای درخواستی در برنامه خود، Consumer SDK را راه‌اندازی کنید. برای اطلاعات بیشتر، به دریافت iOS Consumer SDK مراجعه کنید.
2 رابط بصری اشتراک گذاری سفر را تنظیم کنید نمای نقشه را راه اندازی کنید و رویدادهای نقشه را مدیریت کنید تا رابط سفر خود را تنظیم کنید. برای اطلاعات بیشتر، به تنظیم نقشه مراجعه کنید.
3 سفر را به اشتراک بگذارید سفری را دنبال کنید تا مکان وسیله نقلیه مناسب را با مصرف کننده خود به اشتراک بگذارید. برای اطلاعات بیشتر، به دنبال یک سفر مراجعه کنید.
5 پیشرفت سفر را به روز کنید و خطاهای سفر را مدیریت کنید جزئیات سفر سفر خود را به‌روزرسانی کنید، مانند مسافت سفر و زمان تخمینی رسیدن، و هرگونه خطا را در طول سفر بررسی کنید. برای اطلاعات بیشتر، به‌روزرسانی پیشرفت سفر و رسیدگی به خطاهای سفر را ببینید.
5 وقتی یک سفر کامل شد، اشتراک گذاری را متوقف کنید برای توقف اشتراک‌گذاری مکان وسیله نقلیه با مصرف‌کننده، سفر را دنبال نکنید. برای اطلاعات بیشتر، توقف دنبال کردن سفر را ببینید.

جاوا اسکریپت

1 اشتراک گذاری سفر را در جاوا اسکریپت تنظیم کنید برای اشتراک‌گذاری سفرها برای سفرهای درخواستی در برنامه خود، Consumer SDK را راه‌اندازی کنید. برای اطلاعات بیشتر، به تنظیم JavaScript Consumer SDK مراجعه کنید.
2 نقشه اشتراک گذاری سفر را بارگیری و سفارشی کنید Maps JavaScript API را فعال کنید و مجوز را برای تنظیم رابط سفر خود تنظیم کنید. برای اطلاعات بیشتر، به تنظیم نقشه مراجعه کنید.
3 سفر را به اشتراک بگذارید سفری را دنبال کنید تا مکان وسیله نقلیه مناسب را با مصرف کننده خود به اشتراک بگذارید. برای اطلاعات بیشتر، به دنبال یک سفر مراجعه کنید.
5 پیشرفت سفر را به روز کنید و خطاهای سفر را مدیریت کنید جزئیات سفر سفر خود را به‌روزرسانی کنید، مانند مسافت سفر و زمان تخمینی رسیدن، و هرگونه خطا را در طول سفر بررسی کنید. برای اطلاعات بیشتر، به‌روزرسانی و پیگیری پیشرفت سفر و رسیدگی به خطاهای سفر را ببینید.
5 وقتی یک سفر کامل شد، اشتراک گذاری را متوقف کنید برای توقف اشتراک‌گذاری مکان وسیله نقلیه با مصرف‌کننده، سفر را دنبال نکنید. برای اطلاعات بیشتر، توقف اشتراک‌گذاری سفر را ببینید.

اجزاء

این بخش دو مؤلفه لازم برای اشتراک گذاری یک سفر را خلاصه می کند:

به صورت اختیاری، همچنین می توانید تجربه اشتراک گذاری سفر خود را با این مؤلفه ها سفارشی کنید:

واکشی نشانه احراز هویت

برای کنترل دسترسی به داده های مکان ذخیره شده در Fleet Engine، باید موارد زیر را انجام دهید:

  1. سرویس ایجاد JSON Web Token (JWT) را برای Fleet Engine در سرور خود پیاده سازی کنید.

  2. برای تأیید اعتبار دسترسی به داده‌های مکان، یک واکشی نشانه احراز هویت را در برنامه‌های وب یا تلفن همراه خود پیاده‌سازی کنید.

برای اطلاعات بیشتر، راهنمای راه‌اندازی اندروید ، iOS یا جاوا اسکریپت را ببینید.

نمای نقشه و ردیاب سفر

اشتراک‌گذاری سفر شامل اجزایی برای تجسم وسایل نقلیه و ایستگاه‌های بین راهی، و همچنین داده‌های خام برای ETA راننده یا مسافت باقی‌مانده تا رانندگی است.

جدول زیر این اجزا را توضیح می دهد:

جزء شرح
نمای نقشه اشتراک گذاری سفر نمای نقشه چرخه زندگی یک سفر را مدیریت می‌کند و در حین پیشرفت سفر، نقاط بین مکان وسایل نقلیه را نشان می‌دهد. اگر مسیر یک وسیله نقلیه مشخص باشد، نمای نقشه چند خط مسیر وسیله نقلیه را به روز می کند تا پیشرفت وسیله نقلیه را در طول مسیر خود نشان دهد.
ارائه دهنده مکان سفر در جاوا اسکریپت برای برنامه‌های وب جاوا اسکریپت، ارائه‌دهنده مکان سفر اطلاعات موقعیت مکانی اشیاء ردیابی شده را در نقشه سفر مشترک تغذیه می‌کند. برای اطلاعات بیشتر، به ارائه‌دهنده موقعیت مکانی سفر مراجعه کنید. می‌توانید از ارائه‌دهنده مکان سفر برای ردیابی جزئیات زیر برای سفر استفاده کنید:
  • محل تحویل یا تحویل یک سفر.
  • محل و مسیر وسیله نقلیه تعیین شده برای سفر.

اشیاء مکان ردیابی شده

ارائه‌دهنده موقعیت مکانی اشیایی مانند ایستگاه‌های بین راه و وسایل نقلیه را که در جدول زیر شرح داده شده است، ردیابی می‌کند.

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

به نقشه های خود سبک دهید

استایل های نشانگر و چند خطی ظاهر و احساس اشیاء مکان ردیابی شده را روی نقشه تعیین می کنند. می توانید از گزینه های استایل سفارشی برای تغییر استایل پیش فرض برای مطابقت با سبک برنامه وب خود استفاده کنید.

کنترل دید مکان های ردیابی شده

ارائه دهندگان موقعیت مکانی از پیش تعریف شده در Fleet Engine از این قوانین دید برای اشیاء مکان ردیابی شده روی نقشه پیروی می کنند. اگر یک ارائه دهنده موقعیت مکانی سفارشی یا مشتق شده ایجاد کنید، می توانید قوانین دید را تغییر دهید.

  • وسایل نقلیه فقط زمانی قابل مشاهده هستند که سفر در حال انجام است : وسیله نقلیه مشترک سفر از زمانی که به یک سفر اختصاص داده شده تا زمان تحویل قابل مشاهده است. اگر سفر لغو شود، وسیله نقلیه طولانی تر قابل مشاهده است.

  • همه نشانگرهای موقعیت مکانی دیگر همیشه قابل مشاهده هستند : همه نشانگرهای مکان دیگر برای مبدا، مقصد، و نقاط بین راه همیشه روی نقشه نشان داده می شوند. به عنوان مثال، یک مکان اشتراک گذاری سفر یا محل تحویل محموله، صرف نظر از وضعیت سفر یا تحویل، همیشه روی نقشه نشان داده می شود.

بعدش چی

مستندات پلتفرمی را که می‌خواهید سفرها را در آن به اشتراک بگذارید، ببینید: