جزئیات در مورد فید داده گام به گام

یک فید داده گام به گام اطلاعات ناوبری را به دستگاه هایی ارائه می دهد که برای هدایت ناوبری مبتنی بر نقشه طراحی نشده اند. مانورهای آتی را با عناصری که شما تامین می کنید ارائه می دهد:

• نمادها (چپ، راست، چرخش U)
• اعداد را در دوربرگردان ها بچرخانید
• نام جاده ها
• فاصله و زمان تخمینی تا مرحله ناوبری بعدی یا مقصد نهایی

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

عناصر ضروری نمایش ناوبری

فیلدهای اولیه برای هر مرحله ناوبری، نام کامل جاده، مانور، و مسافت کلی مرحله است که در GMSNavigationStepInfo موجود است.

برای سفر کلی، ممکن است بخواهید زمان و مسافت باقیمانده تا مرحله فعلی یا مقصد را نمایش دهید که همه آنها در GMSNavigationNavInfo موجود هستند. تصویر سمت راست نمونه ای از این عناصر ناوبری ضروری را نشان می دهد.

یک شنونده رویداد راه اندازی کنید

برای استفاده از داده‌های فقط ناوبری، باید یک شنونده رویداد برای رویداد didChangeNavInfo پیاده‌سازی کنید. در شنونده رویداد، به اطلاعات سفر و مرحله دسترسی داشته باشید تا ناوبری نوبتی را به کاربران خود ارائه دهید.

برای پیاده‌سازی کنترل‌کننده‌های رویداد، کنترل‌کننده نمایش نقشه باید پروتکل GMSNavigatorListener را پیاده‌سازی کند. برای اطلاعات دقیق در مورد مدیریت رویدادها در Navigation SDK برای iOS، به گوش دادن به رویدادهای پیمایش مراجعه کنید.

مدیریت رویداد didChangeNavInfo

یک شنونده برای رویداد didChangeNavInfo ایجاد کنید تا پشتیبانی گام به گام را به برنامه خود اضافه کنید. در شنونده رویداد، از کلاس ها و فهرست های زیر برای کنترل ناوبری گام به گام استفاده کنید:

• GMSNavigationNavInfo - کلاسی که اطلاعات مربوط به وضعیت ناوبری را تعریف می کند.

• GMSNavigationStepInfo - کلاسی که اطلاعات مربوط به یک مرحله را در طول مسیر ناوبری تعریف می کند.

• GMSNavigationNavState - فهرستی که وضعیت فعلی یک ناوبری را تعریف می کند، مانند مسیر، تغییر مسیر یا توقف.

• GMSNavigationDrivingSide - شماره ای که تعیین می کند آیا این مرحله در مسیر درایو به راست یا درایو به چپ است.

• GMSNavigationManeuver - Enum که عملکرد ناوبری را که باید انجام دهید، مانند چرخش به چپ یا گردش به راست را مشخص می کند.

در زیر نمونه شنوندگان رویداد برای رویداد didChangeNavInfo نشان داده شده است:

  // ViewController.h
  @interface SomeViewController () <GMSNavigatorListener>

  @end

  // ViewController.m
  @implementation SomeViewController
  // Some initialization code.
  ... {
    ...
    [_mapView.navigator addListener:self];
    ...
  }

  #pragma mark GMSNavigatorListener
  - (void)navigator:(GMSNavigator *)navigator didUpdateNavInfo:(GMSNavigationNavInfo *)navInfo {
    // Get the current step information
    if (navInfo.navState == GMSNavigationNavStateEnroute) {
      GMSNavigationStepInfo *currentStep = navInfo.currentStep;
      if (currentStep) {
        ...
        roadNameLabel.text = currentStep.simpleRoadName;
        ...
      }
    }
    ...
  }

  // ViewController.swift
  class SomeViewController: UIViewController {
    ...
    mapView.navigator?.add(self);
    ...
  }

  extension SomeViewController: GMSNavigatorListener {
    func navigator(_ navigator: GMSNavigator,
                   didUpdateNavInfo navInfo: GMSNavigationNavInfo) {

      // Get the current step information
      if navInfo.navState == .enroute {
        if let currentStep = navInfo.currentStep {
          ...
          roadNameLabel.text = currentStep.simpleRoadName
          ...
        }
      }
    }
  }

وضعیت های ناوبری

از ویژگی navState GMSNavigationNavInfo برای دریافت وضعیت فعلی ناوبری استفاده کنید که یکی از موارد زیر است:

• Enroute - وضعیت GMSNavigationNavStateEnroute به این معنی است که ناوبری هدایت شده در حال حاضر فعال است و کاربر در مسیر ارائه شده است. اطلاعات مربوط به مرحله مانور آینده در دسترس است.

• مسیریابی مجدد - GMSNavigationNavStateRerouting به این معنی است که ناوبری در حال انجام است، اما ناوبر به دنبال یک مسیر جدید است. مرحله مانور آینده در دسترس نیست، زیرا هنوز مسیر جدیدی وجود ندارد.

• متوقف شد - GMSNavigationNavStateStopped به این معنی است که ناوبری به پایان رسیده است. به عنوان مثال، هنگامی که کاربر از ناوبری در برنامه خارج می شود، ناوبری متوقف می شود. در برنامه نمونه، یک وضعیت GMSNavigationNavStateStopped صفحه نمایش اطلاعات ناوبری را پاک می کند تا از نمایش دستورالعمل های مرحله طولانی جلوگیری کند.

هدایت خط

Navigation SDK خطوط را در کارت نوبت ناوبری به عنوان اشیاء داده GMSNavigationLane و GMSNavigationLaneDirection نشان می دهد. یک شی GMSNavigationLane یک خط خاص را در طول مسیریابی نشان می دهد و دارای لیستی از اشیاء GMSNavigationLaneDirection است که تمام چرخش هایی را که می توان از این خط انجام داد را توصیف می کند.

جهت توصیه شده ای که راننده باید در یک لاین طی کند با استفاده از فیلد recommended مشخص شده است.

نمونه راهنمای خط

قطعه زیر نمایش داده های خطوط نمایش داده شده در تصویر قبلی را نشان می دهد.

// Lane 1
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 2
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]

// Lane 3
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false}]

// Lane 4
GMSNavigationLaneDirections =
  [{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false},
{/*GMSNavigationLaneShape=*/ GMSNavigationLaneShapeNormalRight, /*recommended=*/ false}]

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

Navigation SDK از تولید تصاویر خط برای هر مرحله پیمایش همانطور که توسط GMSNavigationStepInfo منتقل می شود پشتیبانی می کند. این نمادها با راهنمای اندازه‌گیری تصویر CarPlay مطابقت دارند.

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)
      

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];
      

ایجاد آیکون برای مانور

فهرست GMSNavigationManeuver هر مانور ممکنی را که می‌تواند در حین پیمایش رخ دهد، تعریف می‌کند، و می‌توانید مانور یک مرحله معین را از ویژگی maneuver GMSNavigationStepInfo دریافت کنید.

شما باید آیکون های مانور را ایجاد کنید و آنها را با مانورهای مرتبط خود جفت کنید. برای برخی از مانورها، می‌توانید نگاشت یک به یک را روی یک نماد تنظیم کنید، مانند GMSNavigationManeuverDestinationLeft و GMSNavigationManeuverDestinationRight . با این حال، از آنجایی که برخی از مانورها ویژگی های مشترکی با سایر مانورها دارند، ممکن است بخواهید بیش از یک مانور را به یک نماد منفرد نگاشت کنید. برای مثال GMSNavigationManeuverTurnLeft و GMSNavigationManeuverOnRampLeft هر دو می توانند به نماد چرخش چپ نگاشت شوند.

برخی از مانورها حاوی یک برچسب اضافی "Clockwise" یا "CounterClockwise" هستند که SDK بر اساس سمت رانندگی یک کشور تعیین می کند. برای مثال، در کشورهایی که رانندگی در سمت چپ جاده است، رانندگان یک دوربرگردان یا دوربرگردان در جهت عقربه‌های ساعت می‌پیچند، در حالی که کشورهای سمت راست جاده در خلاف جهت عقربه‌های ساعت حرکت می‌کنند. Navigation SDK تشخیص می دهد که آیا مانور در ترافیک سمت چپ یا راست رخ می دهد و مانور مناسب را خروجی می دهد. بنابراین، نماد مانور شما ممکن است برای یک مانور در جهت عقربه‌های ساعت در مقابل یک مانور خلاف جهت عقربه‌های ساعت متفاوت باشد.

برای دیدن نمونه نمادها برای مانورهای مختلف بزرگ کنید

نماد نمونه	مانورهای نوبتی
	DEPART UNKNOWN
	STRAIGHT ON_RAMP_UNSPECIFIED OFF_RAMP_UNSPECIFIED NAME_CHANGE
	TURN_RIGHT ON_RAMP_RIGHT
	TURN_LEFT ON_RAMP_LEFT
	TURN_SLIGHT_RIGHT ON_RAMP_SLIGHT_RIGHT OFF_RAMP_SLIGHT_RIGHT
	TURN_SLIGHT_LEFT ON_RAMP_SLIGHT_LEFT OFF_RAMP_SLIGHT_LEFT
	TURN_SHARP_RIGHT ON_RAMP_SHARP_RIGHT OFF_RAMP_SHARP_RIGHT
	TURN_SHARP_LEFT ON_RAMP_SHARP_LEFT OFF_RAMP_SHARP_LEFT
	TURN_U_TURN_COUNTERCLOCKWISE ON_RAMP_U_TURN_COUNTERCLOCKWISE OFF_RAMP_U_TURN_COUNTERCLOCKWISE
	TURN_U_TURN_CLOCKWISE ON_RAMP_U_TURN_CLOCKWISE OFF_RAMP_U_TURN_CLOCKWISE
	ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
	ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
	ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
	ROUNDABOUT_RIGHT_CLOCKWISE
	ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
	ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
	ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
	ROUNDABOUT_STRAIGHT_CLOCKWISE
	ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
	ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
	ROUNDABOUT_LEFT_COUNTERCLOCKWISE
	ROUNDABOUT_LEFT_CLOCKWISE
	ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
	ROUNDABOUT_SHARP_LEFT_CLOCKWISE
	ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
	ROUNDABOUT_U_TURN_CLOCKWISE
	ROUNDABOUT_COUNTERCLOCKWISE
	ROUNDABOUT_CLOCKWISE
	ROUNDABOUT_EXIT_COUNTERCLOCKWISE
	ROUNDABOUT_EXIT_CLOCKWISE
	MERGE_RIGHT OFF_RAMP_RIGHT
	MERGE_LEFT OFF_RAMP_LEFT
	FORK_RIGHT TURN_KEEP_RIGHT ON_RAMP_KEEP_RIGHT OFF_RAMP_KEEP_RIGHT
	FORK_LEFT TURN_KEEP_LEFT ON_RAMP_KEEP_LEFT OFF_RAMP_KEEP_LEFT
	MERGE_UNSPECIFIED
	DESTINATION
	DESTINATION_RIGHT
	DESTINATION_LEFT
	FERRY_BOAT
	FERRY_TRAIN

از آیکون های تولید شده استفاده کنید

Navigation SDK از تولید نمادهای مانور برای یک GMSNavigationStepInfo داده شده پشتیبانی می کند. این نمادها با راهنمای اندازه‌گیری تصویر CarPlay مطابقت دارند.

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)
      

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];