سوالات متداول

حقایق محصول

شبکه

داده ها

سفارشی سازی UI

مسیریابی

شبیه ساز

گردش کار

حقایق محصول

برنامه شما باید یک کادر محاوره ای با اعلان شرایط سرویس Navigation SDK اجرا کند که هر راننده باید آن را بپذیرد. این کادر محاوره ای به راننده این فرصت را می دهد که با شرایط خدمات موافقت کند. یک فایل متنی از شرایط همراه با Navigation SDK ارائه شده است.
در اندروید، از روش NavigationApi.showTermsAndConditionsDialog برای نمایش کادر محاوره ای حاوی عبارات استفاده کنید.
در iOS، با GMSNavigationServices.showTermsAndConditionsDialogIfNeededWithCompanyName تماس بگیرید.
هر زبانی که توسط Google Maps Mobile پشتیبانی می شود به طور خودکار برای Navigation SDK در دسترس است. یک دستگاه دارای یک زبان سیستم پیش فرض است و یک برنامه نمی تواند آن تنظیمات را تغییر دهد. با این حال، این برنامه به بیش از 70 زبان دسترسی دارد.

آره. در اندروید، پس از شروع، LocationListener همچنان در پس‌زمینه اجرا می‌شود. برنامه شما به گرفتن موقعیت جاده ادامه می دهد و یاتاقان را حفظ می کند.

در iOS، برای ادامه دریافت به‌روزرسانی‌های موقعیت مکانی و یاتاقان در پس‌زمینه، snapping را پیاده‌سازی کنید و allowsBackgroundLocationUpdates روی YES تنظیم کنید.

آره. هنگامی که یک مسیر ایجاد یا تغییر می کند، RouteChangeListener چند خطوط را ارائه می دهد.

خیر، Navigation SDK نیازی به نصب Google Maps Mobile روی دستگاه ندارد.
خیر، Navigation SDK در حال حاضر این قابلیت را ارائه نمی دهد.
آره. جهت ترافیک به صورت پیش فرض در دسترس است و نمایش داده می شود.

شبکه

چگونه SDK ناوبری اتصال ضعیف را کنترل می کند؟
Navigation SDK مسیر را برای هر سفر از قبل ذخیره می کند. اطلاعات از پیش ذخیره شده شامل اطلاعات مسیریابی به مدت 15 تا 20 دقیقه و جایگزین های مسیر در صورت انحراف راننده از مسیر است. Navigation SDK موقعیت را با استفاده از GPS دستگاه و حسگرها تقریبی می کند.
آیا حالت آفلاین موجود است؟
خیر، Navigation SDK در حال حاضر حالت آفلاین را ارائه نمی دهد. با این حال، SDK اطلاعات از پیش ذخیره شده را برای یک سفر فراهم می کند.

داده ها

آیا می توانم قبل از شروع مسیر، تمام توقف ها/مقصدهای سفر را بازیابی کنم؟

آره. در Android، برای بازیابی مسیرها، Navigator.getRouteSegments() را فراخوانی کنید.

در iOS، با GMSNavigator.routeLegs(read) تماس بگیرید.

آیا راهنمایی مسیر گام به گام در ابتدای مسیر موجود است؟
آره. Navigation SDK فهرستی از بخش های مسیر را ارائه می دهد. علاوه بر این، راننده می تواند برای دیدن هر مانور، از طریق کارت جهت ها در هدر حرکت کند.
چگونه ETA به کاربران برنامه منتقل می شود؟

در Android، از مراحل زیر برای دادن اطلاعات ETA به کاربران برنامه استفاده کنید:

  1. با استفاده از Navigator.getTimeAndDistanceList() زمان و مسافت را برای تمام نقاط بین راهی بازیابی کنید.
  2. همانطور که در حال حاضر برای درایور ETA انجام می دهید، این اطلاعات را به برنامه مشتری ارسال کنید.

در iOS، از این مراحل برای دادن اطلاعات ETA به کاربران برنامه استفاده کنید:

  1. پاهای سفر را با استفاده از Navigator.getRouteSegments() بازیابی کنید.
  2. برای هر مرحله سفر با GMSNavigator.timeToNextDestination تماس بگیرید.
  3. همانطور که در حال حاضر برای درایور ETA انجام می دهید، اطلاعات زمان را به برنامه مشتری ارسال کنید.
اگر مسیریابی در پیش زمینه نباشد، آیا می توان از RoadSnappedLocationProvider برای به دست آوردن موقعیت مکانی ضبط شده فعلی راننده استفاده کرد؟

آره. در اندروید، RoadSnappedLocationProvider به طور پیش فرض در پس زمینه اجرا می شود.

در iOS، برای اینکه پیمایش در پس‌زمینه اجرا شود، نماینده را برای GMSRoadSnappedLocationProviderDelegate پیاده‌سازی کنید و ویژگی allowsBackgroundLocationUpdates روی TRUE تنظیم کنید.

آیا Navigation SDK از geofencing پشتیبانی می کند؟

خیر. در زمینه ناوبری، remainingTimeOrdistanceChangeListener نسبت به geofence ساده مزیت دارد. geofence ممکن است هندسه جاده را در نظر نگیرد، و ممکن است بر روی نقطه دقیقی که راننده در حال حرکت به آن است متمرکز نباشد.

می توانید این عملکرد را با استفاده از remainingTimeOrdistanceChangeListener تقریبی کنید.

  1. آستانه را برای تعیین فرکانس تماس ها تنظیم کنید.
  2. فاصله باقی مانده تا مقصد را بررسی کنید.

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

در iOS، نماینده GMSNavigatorDelegate.didUpdateRemainingDistance را برای مدیریت فاصله بین اعلان ها پیاده سازی کنید.

آیا می توانم وقتی برنامه ناوبری در پس زمینه است اعلان ها را غیرفعال کنم؟

آره. در Android، از Navigator.setHeadsUpNotificationEnabled برای کنترل اعلان‌ها استفاده کنید. این روش دارای آرگومان بولی است. FALSE اعلان ها را غیرفعال می کند. TRUE اعلان ها را فعال می کند.

در iOS، با تنظیم GMSRoadSnappedLocationProviderDelegate.allowsBackgroundLocationUpdates روی NO، اعلان پس‌زمینه را برای مکان‌های تصادفی غیرفعال کنید.

برای غیرفعال کردن پردازش پس‌زمینه برای سایر اعلان‌های مکان، با GMSNavigator.sendsBackgroundNotifications(NO) تماس بگیرید.

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

برای اطلاعات در مورد جنبه های کدگذاری تراکنش های صورتحساب، به تراکنش های قابل صورتحساب مراجعه کنید.

سفارشی سازی UI

آیا می توانم بهترین گزینه مسیر را کد رنگ کنم؟
خیر. کدگذاری رنگی یک گزینه مسیر خاص در حال حاضر پشتیبانی نمی شود.
آیا Navigation SDK می تواند ETA را برای مقصد نهایی نشان دهد؟

آره. در اندروید از روش های زیر استفاده کنید:

  1. با استفاده از Navigator.getTimeAndDistanceList() زمان و مسافت را برای تمام نقاط بین راهی بازیابی کنید.
  2. ETA نقطه بین راه فعلی را با استفاده از NavigationFragment.setEtaCardEnabled(false) مخفی کنید.
  3. مقصد نهایی ETA را رندر کنید.

در iOS از موارد زیر استفاده کنید:

  1. با GMSNavigator.routeLegs(read) تماس بگیرید.
  2. با آخرین مرحله، با GMSNavigator.timeToNextDestination تماس بگیرید.
  3. ETA نقطه راه فعلی را با استفاده از MSMapView.settings.navigationFooterEnabled=NO به FALSE پنهان کنید.
  4. مقصد نهایی ETA را رندر کنید.
چگونه می توانم به روز رسانی های ETA را پنهان کنم؟

می توانید کارت های ETA را با روش های زیر غیرفعال کنید:

  • در Android، از navigationView.setEtaCardEnabled(false) استفاده کنید.
  • در iOS، از GMSMapView.settings.navigationFooterEnabled=NO استفاده کنید.
کدام شخصی‌سازی‌های رابط کاربری برای کارت‌های سرصفحه و پاورقی در دسترس هستند؟

در اندروید، از StylingOptions برای تنظیم استایل رنگ پس‌زمینه استفاده می‌کنید. برای پنهان کردن یا نشان دادن سرصفحه و پاورقی، از توابع عضو setHeaderEnabled و setFooterEnabled NavigationFragment استفاده کنید.

در iOS، از GMSMapView.settings.navigationHeaderPrimaryBackgroundColor برای تنظیم استایل رنگ پس‌زمینه استفاده کنید. برای پنهان کردن یا نمایش سرصفحه و پاورقی از ویژگی های navigationFooterEnabled و navigationHeaderEnabled GMSUISettings استفاده کنید.

مسیریابی

آیا می توانم مسیر خاصی را به راننده ارائه دهم یا مسیرهای جایگزین را حذف کنم؟
خیر به طور پیش فرض چندین مسیر ارائه شده و سریعترین مسیر اولویت دارد. می‌توانید با افزودن تنظیمات برگزیده، مانند «جلوگیری از بزرگراه‌ها و عوارضی» به درخواست خود، مسیر پیش‌فرض را تحت تأثیر قرار دهید. اضافه کردن ایستگاه های بین راه نیز بر مسیر تأثیر می گذارد.
آیا می توانم به کاربر برنامه برچسبی متفاوت از مکان مقصد پیش فرض برای مقصد نشان دهم؟

آره. در Android، یک Marker با عنوان سفارشی برای مقصد و طول و عرض جغرافیایی ایجاد کنید. Navigation SDK عنوان سفارشی و مختصات را در NavigationMap نمایش می دهد.

در iOS، یک GMSMarker برای مقصد ایجاد و نمایش می دهید.

آیا می توانم از Navigation SDK برای ردیابی انحرافات از یک مسیر تعریف شده استفاده کنم؟

آره. در Android، از Navigator.setRouteChangedListener برای دریافت اعلان‌ها هنگام تغییر مسیر یا توصیه مسیر جدید استفاده کنید:

  1. شنونده ای را ثبت کنید که موقعیت دستگاه را در طول مسیر با استفاده از روش Navigator.setRouteChangedListener بررسی می کند.
  2. کد را به کنترل کننده رویداد پاسخ به تماس، onRouteChanged اضافه کنید:
    • برای کاربر برنامه پیامی با اطلاعات به روز شده ETA و فاصله ارسال کنید.
    • مکان دستگاه را ردیابی کنید.
    • [اختیاری] قابلیت‌های دیگری را اضافه کنید که برنامه‌تان مورد نیاز است تا زمانی که راننده از مسیر تعیین‌شده خارج می‌شود، آن را مدیریت کند.

در iOS، از GMSNavigator و نمایندگان آن برای دریافت اعلان‌ها هنگام تغییر مسیر یا توصیه مسیر جدید استفاده کنید:

  1. در کنترلر نمای نقشه، پروتکل GMSNavigatorDelegate و پروتکل GMSRoadSnappedLocationProviderDelegate را پیاده سازی کنید.
  2. GMSNavigatorDelegate.navigatorDidChangeRoute را پیاده سازی کنید.
  3. با استفاده از routeLegs و ویژگی های currentRouteLeg GMSNavigator به مسیر جدید دسترسی پیدا کنید.
آیا راننده می تواند بدون تکمیل مسیر از مسیریابی خارج شود؟

آره. در اندروید، متد Navigator.stopGuidance() را برای توقف ناوبری فراخوانی کنید.

در iOS، با GMSNavigator.clearDestinations تماس بگیرید.

شبیه ساز

آیا شبیه ساز از تغییرات مسیر پشتیبانی می کند؟

آره. در اندروید، با simulateLocationsAlongNewRoute تماس بگیرید تا سفری را که شامل تغییر مسیر است شبیه سازی کنید. متد simulateLocationsAlongExistingRoute تغییرات مسیر موجود را نادیده می گیرد.

در iOS، از GMSLocationSimulator.simulateAlongNewRouteToDestinations برای شبیه سازی سفری که شامل تغییر مسیر است، استفاده کنید. اگر هیچ تغییر مسیری را پیش‌بینی نمی‌کنید، می‌توانید از GMSLocationSimulator.simulateLocationsAlongExistingRoute یا GMSLocationSimulator.simulateAlongNewRouteToDestinations استفاده کنید.

گردش کار

چگونه می توانم پس از بستن فعالیتی که حاوی یک قطعه ناوبری است، اعلان را رد کنم؟

اعلان ناوبری در طول ناوبری، زمانی که فعالیت بسته می شود، قابل مشاهده باقی می ماند. وقتی وسیله نقلیه به مقصد می رسد، ناوبری متوقف می شود و اعلان ناپدید می شود.

برای مدیریت کلیک‌های روی اعلان، از Navigator.startGuidance(intent resumeIntent) استفاده کنید. هنگامی که کاربر برنامه روی اعلان کلیک می کند resume intent فعال می شود. به طور معمول، Navigator.startguidance(getIntent()) از Activity اصلی فراخوانی می شود، که وقتی کاربر برنامه روی اعلان کلیک می کند، Activity را به یاد می آورد.