با اجازه دادن به مصرف‌کنندگان برای دنبال کردن سفارش، سرویس یا سایر خدماتی که به آنها ارائه می‌دهید، تجربه مصرف‌کننده را برای سفرهای درخواستی سفارشی‌سازی کنید.
SDK مصرف‌کننده چیست؟
کیت توسعه نرم‌افزار مصرف‌کننده (Consumer SDK) بخشی از Fleet Engine برای سفرهای درخواستی است. این کیت رابط‌هایی را ارائه می‌دهد که داده‌های سفر را مدل‌سازی کرده و سفرها را در Fleet Engine دنبال می‌کنند و کلاس‌هایی را که برای ایجاد یک نمایش غنی و مبتنی بر نقشه برای به اشتراک گذاشتن سفرها با کاربران مصرف‌کننده خود استفاده می‌کنید، ارائه می‌دهد. شما SDK مصرف‌کننده را در برنامه خود ادغام می‌کنید و پروفایل‌های نقش مناسب را در Fleet Engine تنظیم می‌کنید تا این تجربه مصرف‌کننده را ایجاد کنید.
APIهای مختص پلتفرم Consumer SDK به شما امکان می‌دهند تا قابلیت اشتراک‌گذاری سفرها را به صورت بومی در برنامه‌های خود ایجاد کنید. Consumer SDK برای پلتفرم‌های زیر در دسترس است:
چرا از SDK مصرف‌کننده استفاده کنیم؟
ادغام SDK مصرف‌کننده در برنامه‌های سفرهای درخواستی شما به شما امکان می‌دهد یک تجربه جامع مصرف‌کننده را با به‌روزرسانی‌های مکانی تقریباً بلادرنگ و موقعیت‌های جاده‌ای ثبت‌شده ارائه دهید. مصرف‌کنندگان شما می‌توانند مسیر وسیله نقلیه را که روی نقشه نمایش داده شده است، از جمله جزئیات پیشرفت که به آنها کمک می‌کند تا بفهمند وسیله نقلیه یا محل تحویل آنها کجاست، مشاهده کنند.
با SDK مصرف‌کننده چه کارهایی می‌توان انجام داد؟
شما می‌توانید از اطلاعات Driver SDK و Fleet Engine برای ایجاد تجربیات سفارشی برای مصرف‌کننده، از جمله ویژگی‌های زیر، استفاده کنید:
رابط کاربری نقشه را متناسب با نیازهای برندسازی خود سفارشی کنید.
موقعیت فعلی وسیله نقلیه را در طول مسیر دنبال کنید و موقعیت آن را به صورت دوره‌ای به‌روزرسانی کنید.
زمان تخمینی رسیدن (ETA) را برای مکان‌های تحویل و پیاده شدن نشان دهید.
مسافت باقی مانده را نشان دهید.
نمایش ترافیک زنده در مسیر.
نحوه کار SDK مصرف‌کننده
در سطح بالا، Consumer SDK به مکانیسم‌های زیر متکی است:
- داشتن نقش‌های مناسب موتور ناوگان به گونه‌ای که یک برنامه احراز هویت شده بتواند سفر مرتبط با سفارش مصرف‌کننده را دنبال کند.
- ارتباطی بین مصرف‌کننده و سفر، که توسط سیستم بک‌اند شما ارائه می‌شود.
- کلاس‌های
TripModelوJourneySharingSessionSDK داده‌های سفر را مدل‌سازی کرده و جلسات سفر را در برنامه مصرف‌کننده به اشتراک می‌گذارند.
کیت توسعه نرم‌افزار مصرف‌کننده (Consumer SDK) همچنین رابط‌ها و کلاس‌های دیگری را ارائه می‌دهد تا بتوانید یک تجربه غنی از برنامه را با جزئیاتی مانند ترافیک، نشانگرهای نقشه، ETA و داده‌های مسیر ایجاد کنید.
این جدول جریان یک سفر و به دنبال آن یک برنامه مصرف‌کننده را نشان می‌دهد.
| ۱ | اپلیکیشن مشتری درخواست سفر می‌دهد | سرور بک‌اند شما یک درخواست سفر بنا به تقاضا دریافت می‌کند و موارد زیر را انجام می‌دهد:
|
| ۲ | راننده سفر را می‌پذیرد | اپلیکیشن راننده، شناسه سفر و اطلاعات سفر را دریافت می‌کند و راننده سفر را می‌پذیرد. |
| ۳ | اپلیکیشن مصرف‌کننده درخواست دسترسی برای پیگیری سفر را دارد | برنامه‌ی مصرف‌کننده، شناسه‌ی سفر را از بک‌اند شما دریافت می‌کند و درخواست می‌دهد تا سفر را دنبال کند. |
| ۴ | راننده سفر را آغاز می‌کند | وقتی راننده از برنامه راننده برای اعلام شروع سفر استفاده می‌کند، برنامه از طریق Driver SDK به سرور backend شما اطلاع می‌دهد. برای مثال، وقتی راننده قصد ترک رستوران یا رانندگی به سمت محل تحویل بار را دارد. |
| ۵ | موتور ناوگان شروع به ارسال اطلاعات سفر می‌کند | موتور ناوگان شروع به ردیابی سفر و به اشتراک گذاری پیشرفت آن با برنامه مصرف کننده می کند. |
| ۶ | برنامه مصرف کننده اطلاعات سفر را نمایش می دهد | اپلیکیشن مصرف‌کننده به مصرف‌کننده اطلاع می‌دهد و شروع به نمایش اطلاعات سفر به آنها می‌کند و همزمان با پیشرفت سفر، آن را به‌روزرسانی می‌کند. |
| ۷ | سفر لغو یا تکمیل شده است | وقتی راننده سفر را لغو یا تکمیل می‌کند، برنامه راننده ردیابی موقعیت مکانی را غیرفعال می‌کند و سرور پشتیبان شما به Fleet Engine می‌گوید که سفر را به عنوان لغو شده یا تکمیل شده علامت‌گذاری کند. |
| ۸ | برنامه مصرف‌کننده پس از سفر متوقف می‌شود | سفر به صورت لغو شده یا تکمیل شده نمایش داده می‌شود. |
| ۹ | این روند برای سفر بعدی تکرار می‌شود | یک سفر جدید ایجاد می‌شود و این فرآیند تکرار می‌شود. |
نحوه استفاده از SDK مصرف‌کننده
برای مشاهده نحوه شروع دنبال کردن سفرها در اپلیکیشن‌های مصرفی، پلتفرم خود را انتخاب کنید.
اندروید
| ۱ | راه‌اندازی Consumer SDK در اندروید | برای دنبال کردن سفرهای درخواستی در برنامه خود، Consumer SDK را تنظیم کنید. برای اطلاعات بیشتر، به Get the Android Consumer SDK مراجعه کنید. |
| ۲ | رابط بصری را تنظیم کنید | یک نقشه تعریف کنید و پشتیبانی از نقشه‌های برداری را برای تنظیم تجربه مصرف‌کننده خود اضافه کنید. برای اطلاعات بیشتر، به «تنظیم نقشه» مراجعه کنید. |
| ۳ | دنبال کردن یک سفر | برای به اشتراک گذاشتن موقعیت مکانی وسیله نقلیه مناسب با مصرف کننده خود، یک سفر را دنبال کنید. برای اطلاعات بیشتر، به دنبال کردن یک سفر مراجعه کنید. |
| ۵ | به‌روزرسانی پیشرفت سفر و مدیریت خطاهای سفر | جزئیات سفرهای خود مانند مسافت سفر و زمان تخمینی رسیدن را به‌روزرسانی کنید و هرگونه خطایی را در طول سفر مدیریت کنید. برای اطلاعات بیشتر، به به‌روزرسانی پیشرفت سفر و مدیریت خطاهای سفر مراجعه کنید. |
| ۵ | وقتی سفری تمام شد، دنبال کردن آن را متوقف کنید | برای توقف اشتراک‌گذاری موقعیت مکانی خودرو با مصرف‌کننده، «دنبال کردن یک سفر» را متوقف کنید. برای اطلاعات بیشتر، به «توقف دنبال کردن یک سفر» مراجعه کنید. |
آی‌او‌اس
| ۱ | تنظیم SDK مصرف‌کننده در iOS | برای دنبال کردن سفرهای درخواستی در برنامه خود، Consumer SDK را تنظیم کنید. برای اطلاعات بیشتر، به Get the iOS Consumer SDK مراجعه کنید. |
| ۲ | رابط بصری را تنظیم کنید | نمای نقشه را مقداردهی اولیه کنید و رویدادهای نقشه را برای تنظیم تجربه مصرف‌کننده خود مدیریت کنید. برای اطلاعات بیشتر، به «تنظیم نقشه» مراجعه کنید. |
| ۳ | دنبال کردن یک سفر | برای به اشتراک گذاشتن موقعیت مکانی وسیله نقلیه مناسب با مصرف کننده خود، یک سفر را دنبال کنید. برای اطلاعات بیشتر، به دنبال کردن یک سفر مراجعه کنید. |
| ۵ | به‌روزرسانی پیشرفت سفر و مدیریت خطاهای سفر | جزئیات سفرهای خود مانند مسافت سفر و زمان تخمینی رسیدن را به‌روزرسانی کنید و هرگونه خطایی را در طول سفر مدیریت کنید. برای اطلاعات بیشتر، به به‌روزرسانی پیشرفت سفر و مدیریت خطاهای سفر مراجعه کنید. |
| ۵ | وقتی سفری تمام شد، دنبال کردن آن را متوقف کنید | برای توقف اشتراک‌گذاری موقعیت مکانی خودرو با مصرف‌کننده، «دنبال کردن یک سفر» را متوقف کنید. برای اطلاعات بیشتر، به «توقف دنبال کردن یک سفر» مراجعه کنید. |
جاوا اسکریپت
| ۱ | راه‌اندازی Consumer SDK در جاوا اسکریپت | برای دنبال کردن سفرهای درخواستی در برنامه خود، Consumer SDK را تنظیم کنید. برای اطلاعات بیشتر، به Setup the JavaScript Consumer SDK مراجعه کنید. |
| ۲ | بارگذاری و سفارشی‌سازی نقشه | API جاوا اسکریپت نقشه‌ها را فعال کنید و مجوزها را برای تنظیم تجربه مصرف‌کننده خود تنظیم کنید. برای اطلاعات بیشتر، به «تنظیم نقشه» مراجعه کنید. |
| ۳ | دنبال کردن یک سفر | برای به اشتراک گذاشتن موقعیت مکانی وسیله نقلیه مناسب با مصرف کننده خود، یک سفر را دنبال کنید. برای اطلاعات بیشتر، به دنبال کردن یک سفر مراجعه کنید. |
| ۵ | به‌روزرسانی پیشرفت سفر و مدیریت خطاهای سفر | جزئیات سفرهای خود مانند مسافت سفر و زمان تخمینی رسیدن را به‌روزرسانی کنید و هرگونه خطایی را در سفر مدیریت کنید. برای اطلاعات بیشتر، به به‌روزرسانی و پیگیری پیشرفت سفر و مدیریت خطاهای سفر مراجعه کنید. |
| ۵ | وقتی سفری تمام شد، دنبال کردن آن را متوقف کنید | برای توقف اشتراک‌گذاری موقعیت مکانی خودرو با مصرف‌کننده، «دنبال کردن یک سفر» را متوقف کنید. برای اطلاعات بیشتر، به «توقف دنبال کردن یک سفر» مراجعه کنید. |
قطعات
این بخش دو جزء ضروری برای دنبال کردن یک سفر را خلاصه می‌کند:
به صورت اختیاری، می‌توانید تجربه مصرف‌کننده خود را با این اجزا نیز سفارشی کنید:
دریافت‌کننده توکن احراز هویت
برای کنترل دسترسی به داده‌های مکانی ذخیره شده در Fleet Engine، باید موارد زیر را انجام دهید:
یک سرویس ایجاد JSON Web Token (JWT) برای Fleet Engine روی سرور خود پیاده‌سازی کنید. برای اطلاعات بیشتر، به Issue JWTs مراجعه کنید.
برای تأیید دسترسی به داده‌های موقعیت مکانی، یک گیرنده توکن احراز هویت را در برنامه‌های وب یا موبایل خود پیاده‌سازی کنید. برای اطلاعات بیشتر در مورد راه‌اندازی گیرنده توکن، به راهنمای راه‌اندازی برای اندروید ، iOS یا جاوا اسکریپت مراجعه کنید.
نمایش نقشه و ردیاب‌های سفر
دنبال کردن یک سفر شامل اجزایی برای تجسم وسایل نقلیه و نقاط مسیر، و همچنین داده‌های خام برای ETA راننده یا مسافت باقی مانده برای رانندگی است.
جدول زیر این اجزا را شرح می‌دهد:
| کامپوننت | توضیحات |
|---|---|
| نمای نقشه مصرف کننده | نمای نقشه، چرخه حیات یک سفر را مدیریت می‌کند و نقاط مسیر را برای موقعیت وسایل نقلیه در طول سفر نشان می‌دهد. اگر مسیر یک وسیله نقلیه مشخص باشد، نمای نقشه، چندخطی مسیر وسیله نقلیه را به‌روزرسانی می‌کند تا پیشرفت وسیله نقلیه در طول مسیر خود را نشان دهد. |
| ارائه دهنده مکان سفر در جاوا اسکریپت | برای برنامه‌های وب جاوا اسکریپت، ارائه‌دهنده مکان سفر، اطلاعات مکان اشیاء ردیابی شده را به نقشه سفر مشترک ارسال می‌کند. برای اطلاعات بیشتر، به بخش «ایجاد نمونه‌ای از ارائه‌دهنده مکان سفر» مراجعه کنید. می‌توانید از ارائه‌دهنده مکان سفر برای ردیابی جزئیات زیر برای یک سفر استفاده کنید:
|
اشیاء مکان ردیابی شده
ارائه دهنده موقعیت مکانی، موقعیت اشیاء مانند نقاط مسیر و وسایل نقلیه را که در جدول زیر شرح داده شده است، ردیابی می‌کند.
| مکان ردیابی شده | توضیحات |
|---|---|
| محل تحویل | محل تحویل، مکانی است که سفر از آنجا آغاز می‌شود. |
| مکان مقصد | مقصد، جایی است که سفر در آن پایان می‌یابد. این مکان، محل پیاده شدن را مشخص می‌کند. |
| موقعیت مکانی نقطه مسیر | یک نقطه مسیر، هر مکان میانی در طول مسیر یک سفر ردیابی شده است. اگرچه از نظر فنی، نقاط مسیر می‌توانند شامل مکان‌های تحویل و تحویل باشند، اما نقاط مسیر معمولاً به ایستگاه‌های میانی در طول مسیر اشاره دارند. به عنوان مثال، ایستگاه‌های بین مکان‌های تحویل و مقصد در یک مسیر تحویل، مکان‌های نقطه مسیر هستند. برای اطلاعات بیشتر، به نقاط مسیر سفر در مستندات Fleet Engine مراجعه کنید. |
| محل خودرو | موقعیت مکانی خودرو، موقعیت گزارش‌شده‌ی یک خودرو است. برای اطلاعات بیشتر، به «موقعیت مکانی خودرو» در مستندات Fleet Engine مراجعه کنید. |
نقشه‌های خود را سبک‌بندی کنید
سبک‌های نشانگر و چندخطی، ظاهر و حس اشیاء مکان ردیابی شده را روی نقشه تعیین می‌کنند. می‌توانید از گزینه‌های سبک‌بندی سفارشی برای مطابقت با سبک برنامه وب خود استفاده کنید.
کنترل میزان دیده شدن مکان‌های ردیابی شده
ارائه دهندگان موقعیت مکانی از پیش تعریف شده در Fleet Engine از این قوانین دید برای اشیاء موقعیت مکانی ردیابی شده روی نقشه پیروی می‌کنند. اگر یک ارائه دهنده موقعیت مکانی سفارشی یا مشتق شده ایجاد کنید، می‌توانید قوانین دید را تغییر دهید.
وسایل نقلیه فقط زمانی که سفر در حال انجام است قابل مشاهده هستند : یک وسیله نقلیه مسافرتی از زمانی که به یک سفر اختصاص داده می‌شود تا زمان پیاده شدن قابل مشاهده است. اگر سفر لغو شود، وسیله نقلیه دیگر قابل مشاهده نیست.
سایر نشانگرهای مکان همیشه قابل مشاهده هستند : سایر نشانگرهای مکان برای مبدا، مقصد و نقاط مسیر همیشه روی نقشه نشان داده می‌شوند. به عنوان مثال، محل پیاده شدن از سفر یا محل تحویل محموله، صرف نظر از وضعیت سفر یا تحویل، همیشه روی نقشه نشان داده می‌شود.
قدم بعدی چیست؟
مستندات مربوط به پلتفرمی که می‌خواهید سفرها را در آن دنبال کنید را مشاهده کنید: