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