مروری بر سفرهای درخواستی SDK مصرف کننده

با اجازه دادن به مشتریان برای پیگیری سفر برای سفارش، سواری یا خدمات دیگری که به آنها ارائه می دهید، تجربه مصرف کننده را برای سفرهای درخواستی تنظیم کنید.

Consumer SDK چیست؟

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

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

• اندروید
• iOS
• جاوا اسکریپت

چرا از Consumer SDK استفاده کنیم؟

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

با Consumer SDK چه کاری می توانید انجام دهید؟

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

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

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

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

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

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

نحوه عملکرد Consumer SDK

در سطح بالایی، Consumer SDK بر مکانیسم‌های زیر متکی است:

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

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

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

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

نحوه استفاده از Consumer SDK

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

اجزاء

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

• واکشی نشانه احراز هویت
• نمای نقشه و ردیاب سفر .

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

• به نقشه های خود سبک دهید
• کنترل دید مکان های ردیابی شده

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

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

1. سرویس ایجاد JSON Web Token (JWT) را برای Fleet Engine در سرور خود پیاده سازی کنید. برای اطلاعات بیشتر، به شماره JWTs مراجعه کنید.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بعدش چی

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

• اندروید
• iOS
• جاوا اسکریپت