تجربه ناوبری سفارشی

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

تجربه ناوبری سفارشی چیست؟

راه اصلی برای پیاده‌سازی Navigation SDK استفاده از تجربه ناوبری Google است که به شما امکان می‌دهد تجربه ناوبری گام‌به‌گام را که از عناصر میانای کاربر و تصاویر ارائه‌شده توسط Google استفاده می‌کند، جاسازی کنید — مشابه تجربه ناوبری در برنامه‌های Google Maps. اگر به انعطاف‌پذیری بیشتری نسبت‌به آنچه تجربه ناوبری Google ارائه می‌دهد نیاز دارید، می‌توانید تجربه ناوبری سفارشی را پیاده‌سازی کنید. تجربه پیمایش سفارشی به هر چیزی از حذف کامل راهنمای گام‌به‌گام و اجرای پیمایش فقط به‌عنوان فرایند پس‌زمینه‌ای گرفته تا نمایش تجربه راهنمای بسیار سفارشی‌شده در صفحه‌ای جدا از دستگاهی که پیمایش را اجرا می‌کند اشاره دارد. با تجربه ناوبری سفارشی، برنامه شما Navigation SDK را برای درخواست فید ناوبری گام‌به‌گام فرامی‌خواند و سپس شما عناصر میانای کاربر و تصاویر را که کاربر در تجربه ناوبری می‌بیند ارائه و مدیریت می‌کنید. درحالی‌که استفاده از تجربه ناوبری Google معمولاً راحت‌تر پیاده‌سازی می‌شود، ساختن تجربه ناوبری سفارشی خودتان امکان سفارشی‌سازی بیشتری را فراهم می‌کند.

وقتی تجربه ناوبری سفارشی ایجاد می‌کنید، برنامه‌تان بااستفاده از جریان زیر، Navigation SDK را برای شروع، اجرا، و توقف ناوبری فراخوانی می‌کند:

  1. ناوبری را شروع کنید. برای شروع تجربه ناوبری سفارشی‌شده، یک نمونه ناوبری ایجاد کنید و مقصد را تنظیم کنید. ایجاد جلسه ناوبری بااستفاده از GMSNavigationService.createNavigationSession. این شیء غیررابط کاربری حامل وضعیت با یا بدون کنترل‌کننده نما کار می‌کند.

    برای اطلاعات بیشتر، جزئیات مربوط به فید داده گام‌به‌گام را ببینید.

    نسخه نمایشی را ببینید: بارگیری Navigation SDK حاوی نسخه نمایشی است که می‌توانید آن را اجرا کنید تا نمونه‌ای از تجربه ناوبری را ببینید که بین راهنمایی گام‌به‌گام ازطریق ناوبری استاندارد به تجربه ناوبری‌ای که فقط حرکت مکان دستگاه را درطول چندخطی جاده نشان می‌دهد جابه‌جا می‌شود.

  2. پیمایش فعال. در اینجا تفاوت کلیدی دیگری بین تجربه ناوبری ارائه‌شده توسط Google و تجربه ناوبری سفارشی وجود دارد. به‌جای واگذاری راهنمایی به مدیر رویداد داخلی Navigation SDK، با پیاده‌سازی پروتکل GMSNavigatorListener، شنونده‌ای برای راهنمایی گام‌به‌گام دقیق راه‌اندازی می‌کنید و سپس گرداننده‌های رویداد را پیاده‌سازی می‌کنید. این کار به تجربه شما اجازه می‌دهد به رویدادهای شرح‌داده‌شده در گوش دادن به رویدادهای ناوبری پاسخ دهد.

  3. پایان ناوبری. همانند تجربه ناوبری Google، ناوبری سفارشی نیز از شما می‌خواهد ناوبری را به روشی که برای تجربه برنامه مناسب‌تر است خاتمه دهید.

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

جدول زیر برخی‌از سناریوهای پیمایش سفارشی را شرح می‌دهد.

سناریوی نمونه

مراحل سطح بالا

باید راهنمایی راننده فقط نوشتاری برای دستگاه‌های کوچک مثل وسایل نقلیه ۲ چرخ ارائه دهید.

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

می‌خواهید برنامه‌تان را به‌عنوان سرویس خودرو برای رانندگانی که از Apple Carplay استفاده می‌کنند دردسترس قرار دهید.

  1. سرویس خودرو را راه‌اندازی کنید.
  2. پروژه Navigation SDK خود را راه‌اندازی کنید.
  3. اگر قبلاً راهنما تعیین نکرده‌اید، این کار را انجام دهید.
  4. شنونده‌ای برای راهنمایی گام‌به‌گام تنظیم کنید.
  5. نقشه را روی سطح برنامه خودرو بکشید و فیلدها را از فید داده‌ای که پیکربندی کرده‌اید پر کنید.

برای اطلاعات بیشتر، فعال کردن ناوبری برای Carplay را ببینید

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

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