این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

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

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

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

صفحه موبایلی که یک گردش به سمت راست در 50 فوتی روی کلیسا را نشان می‌دهد خیابان در پایین صفحه، زمان باقی مانده تا مقصد 13 است دقیقه و فاصله باقی مانده 2.1 است مایل

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

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

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

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

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

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

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

GMSNavigationNavInfo - کلاسی که اطلاعات مربوط به وضعیت ناوبری را تعریف می کند.
GMSNavigationStepInfo - کلاسی که اطلاعات مربوط به یک مرحله را در طول مسیر ناوبری تعریف می کند.
GMSNavigationNavState - فهرستی که وضعیت فعلی یک ناوبری را تعریف می کند، مانند مسیر، تغییر مسیر یا توقف.
GMSNavigationDrivingSide - شماره ای که تعیین می کند آیا این مرحله در مسیر درایو به راست یا درایو به چپ است.
GMSNavigationManeuver - Enum که عملکرد ناوبری را که باید انجام دهید، مانند چرخش به چپ یا راست را تعیین می کند.

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

هدف-C

  // 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)

هدف-C

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)

هدف-C

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

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

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];

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

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

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

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

هدف-C

سویفت

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

هدایت خط

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

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

سویفت

هدف-C

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

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

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

سویفت

هدف-C

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