نمای کلی سفرهای درخواستی «کیت توسعه نرم‌افزار مصرف‌کننده»

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

برنامه
مصرف‌کننده پس‌از سفر

کیت توسعه نرم‌افزار مصرف‌کننده چیست؟

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

میاناهای برنامه‌سازی کاربردی مختص پلاتفرم «کیت توسعه نرم‌افزار مصرف‌کننده» به شما امکان می‌دهد قابلیت هم‌رسانی سفرها را به‌صورت بومی در برنامه‌هایتان ایجاد کنید. «کیت توسعه نرم‌افزار مصرف‌کننده» برای پلاتفرم‌های زیر دردسترس است:

چرا باید از کیت توسعه نرم‌افزار مصرف‌کننده استفاده کرد؟

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

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

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

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

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

  • زمان برآوردی ورود (ETA) را برای مکان‌های سوار کردن و پیاده کردن نشان دهید.

  • مسافت باقی‌مانده را نشان می‌دهد.

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

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

در سطح بالا، «کیت توسعه نرم‌افزار مصرف‌کننده» به سازوکارهای زیر متکی است:

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

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

نحوه عملکرد
کیت توسعه نرم‌افزار مصرف‌کننده

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

۱ برنامه مصرف‌کننده درخواست سفر می‌کند سرور زیرینه شما درخواست سفر درخواستی را دریافت می‌کند و کارهای زیر را انجام می‌دهد:
  • سفری در Fleet Engine ایجاد می‌کند.
  • سفر را به خودرو اختصاص می‌دهد.
۲ راننده سفر را می‌پذیرد برنامه راننده شناسه سفر و اطلاعات سفر را دریافت می‌کند و راننده سفر را می‌پذیرد.
3 برنامه مصرف‌کننده درخواست دسترسی برای دنبال کردن سفر می‌کند برنامه مصرف‌کننده شناسه سفر را از پسین شما دریافت می‌کند و درخواست می‌کند که سفر را دنبال کند.
۴ راننده سفر را شروع می‌کند وقتی راننده از برنامه راننده برای نشان دادن شروع سفر استفاده می‌کند، برنامه ازطریق Driver SDK به سرور زیرینه شما اطلاع می‌دهد. برای مثال، وقتی راننده می‌خواهد رستوران را ترک کند یا به‌سمت مکان تحویل رانندگی کند.
‫۵ Fleet Engine شروع به ارسال اطلاعات سفر می‌کند Fleet Engine ردیابی سفر و هم‌رسانی پیشرفت آن را با برنامه مصرف‌کننده شروع می‌کند.
‫۶ برنامه مصرف‌کننده اطلاعات سفر را نمایش می‌دهد برنامه مصرف‌کننده به مصرف‌کننده اطلاع می‌دهد و شروع به نمایش اطلاعات سفر به او می‌کند و سفر را با پیشرفت آن به‌روز می‌کند.
‫۷ سفر لغو یا تکمیل شده است وقتی راننده سفر را لغو یا تکمیل می‌کند، برنامه راننده ردیابی مکان را غیرفعال می‌کند و سرور زیرینه شما به Fleet Engine می‌گوید سفر را به‌عنوان لغوشده یا تکمیل‌شده علامت‌گذاری کند.
‫۸ برنامه مصرف‌کننده دنبال کردن سفر را متوقف می‌کند سفر به‌عنوان لغوشده یا تکمیل‌شده نشان داده می‌شود.
‫۹ این فرایند برای سفر بعدی تکرار می‌شود سفر جدیدی ایجاد می‌شود و این فرایند تکرار می‌شود.

نحوه استفاده از کیت توسعه نرم‌افزار مصرف‌کننده

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

Android

۱ راه‌اندازی کیت توسعه نرم‌افزار مصرف‌کننده در Android برای دنبال کردن سفرهای درخواستی در برنامه‌تان، Consumer SDK را راه‌اندازی کنید. برای اطلاعات بیشتر، دریافت کیت توسعه نرم‌افزار مصرف‌کننده Android را ببینید.
۲ راه‌اندازی میانای دیداری نقشه‌ای را تعریف کنید و پشتیبانی از نقشه‌های بُرداری را برای راه‌اندازی تجربه مصرف‌کننده اضافه کنید. برای اطلاعات بیشتر، به راه‌اندازی نقشه مراجعه کنید.
3 دنبال کردن سفر سفری را دنبال کنید تا مکان خودرو مناسب را با مصرف‌کننده‌تان هم‌رسانی کنید. برای اطلاعات بیشتر، به دنبال کردن سفر مراجعه کنید.
‫۵ به‌روزرسانی پیشرفت سفر و رسیدگی به خطاهای سفر جزئیات سفرهایتان را به‌روز کنید، مثلاً مسافت سفر و زمان برآوردی ورود، و هرگونه خطایی را که درطول سفر رخ می‌دهد برطرف کنید. برای اطلاعات بیشتر، به‌روزرسانی پیشرفت سفر و رسیدگی به خطاهای سفر را ببینید.
‫۵ وقتی سفر تمام شد، دنبال کردن را متوقف کنید دنبال کردن سفر را متوقف کنید تا هم‌رسانی مکان خودرو با مصرف‌کننده متوقف شود. برای اطلاعات بیشتر، به توقف دنبال کردن سفر مراجعه کنید.

iOS

۱ راه‌اندازی کیت توسعه نرم‌افزار مصرف‌کننده در iOS برای دنبال کردن سفرهای درخواستی در برنامه‌تان، «کیت توسعه نرم‌افزار مصرف‌کننده» را راه‌اندازی کنید. برای اطلاعات بیشتر، دریافت کیت توسعه نرم‌افزار مصرف‌کننده iOS را ببینید.
۲ راه‌اندازی میانای دیداری نمای نقشه را مقداردهی اولیه کنید و رویدادهای نقشه را برای راه‌اندازی تجربه مصرف‌کننده مدیریت کنید. برای اطلاعات بیشتر، به راه‌اندازی نقشه مراجعه کنید.
3 دنبال کردن سفر سفری را دنبال کنید تا مکان خودرو مناسب را با مصرف‌کننده‌تان هم‌رسانی کنید. برای اطلاعات بیشتر، به دنبال کردن سفر مراجعه کنید.
‫۵ به‌روزرسانی پیشرفت سفر و رسیدگی به خطاهای سفر جزئیات سفرهایتان را به‌روز کنید، مثلاً مسافت سفر و زمان برآوردی ورود، و هرگونه خطایی را که درطول سفر رخ می‌دهد برطرف کنید. برای اطلاعات بیشتر، به به‌روزرسانی پیشرفت سفر و رسیدگی به خطاهای سفر مراجعه کنید.
‫۵ وقتی سفر تمام شد، دنبال کردن را متوقف کنید دنبال کردن سفر را متوقف کنید تا هم‌رسانی مکان خودرو با مصرف‌کننده متوقف شود. برای اطلاعات بیشتر، به توقف دنبال کردن سفر مراجعه کنید.

JavaScript

۱ راه‌اندازی کیت توسعه نرم‌افزار مصرف‌کننده در جاوا اسکریپت برای دنبال کردن سفرهای درخواستی در برنامه‌تان، Consumer SDK را راه‌اندازی کنید. برای اطلاعات بیشتر، راه‌اندازی کیت توسعه نرم‌افزار مصرف‌کننده جاوا اسکریپت را ببینید.
۲ بار کردن و سفارشی‌سازی نقشه برای راه‌اندازی تجربه مصرف‌کننده، Maps JavaScript API را فعال کنید و مجوز راه‌اندازی کنید. برای اطلاعات بیشتر، به راه‌اندازی نقشه مراجعه کنید.
3 دنبال کردن سفر سفری را دنبال کنید تا مکان خودرو مناسب را با مصرف‌کننده‌تان هم‌رسانی کنید. برای اطلاعات بیشتر، به دنبال کردن سفر مراجعه کنید.
‫۵ به‌روزرسانی پیشرفت سفر و رسیدگی به خطاهای سفر جزئیات سفرهایتان را به‌روز کنید، مثلاً مسافت سفر و زمان برآوردی ورود، و هرگونه خطایی را در سفر برطرف کنید. برای اطلاعات بیشتر، به به‌روزرسانی و دنبال کردن پیشرفت سفر و رسیدگی به خطاهای سفر مراجعه کنید.
‫۵ وقتی سفر تمام شد، دنبال کردن را متوقف کنید دنبال کردن سفر را متوقف کنید تا هم‌رسانی مکان خودرو با مصرف‌کننده متوقف شود. برای اطلاعات بیشتر، به توقف دنبال کردن سفر مراجعه کنید.

اجزا

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

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

واکشی‌کننده کد اصالت‌سنجی

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

  1. سرویس ایجاد «نشان وب JSON» (JWT) را برای Fleet Engine در سرورتان پیاده‌سازی کنید. برای اطلاعات بیشتر، صدور JWT را ببینید.

  2. برای اصالت‌سنجی دسترسی به داده‌های مکان، یک واکِشگر کد اصالت‌سنجی در برنامه‌های وب یا تلفن همراه خود پیاده‌سازی کنید. برای اطلاعات بیشتر درباره راه‌اندازی دریافت‌کننده کد، راهنمای راه‌اندازی Android،‏ iOS، یا JavaScript را ببینید.

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

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

جدول زیر این مؤلفه‌ها را شرح می‌دهد:

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

اشیای مکان پیگیری‌شده

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

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

سبک‌بندی نقشه‌ها

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

کنترل نمایان بودن مکان‌های پیگیری‌شده

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

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

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

قدم بعدی چیست

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