پلاتفرم را انتخاب کنید: Android iOS

پیکربندی اختلال‌های هم‌زمان

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

ویژگی‌های اختلال هم‌زمان

کیت توسعه نرم‌افزار پیمایش شامل ویژگی‌های اختلال هم‌زمان زیر به‌عنوان بخشی از تجربه پیمایش اصلی است:

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

توضیحات تعاملی اختلال درطول مسیرها

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

نوشته‌های راهنما درطول مسیرها

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

mapView.navigator.shouldDisplayPrompts = true

نمایش جزئیات اختلال وقتی کاربر روی توضیحات تکمیلی ضربه می‌زند

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

کارت‌های اطلاعاتی توضیحی در نمای کلی مسیر، پیش‌از شروع ناوبری فعال

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

کارت اطلاعات نمای کلی

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

mapView.settings.showsIncidentCards = true

کارت‌های اطلاعاتی فراخوان درطول پیمایش فعال

درطول ناوبری فعال، کاربران می‌توانند روی توضیحات اختلال در مسیر یا خارج از مسیر تک‌ضرب بزنند تا کارت اطلاعات باز شود. این کارت نوع اختلال و آخرین زمان گزارش‌شده را نشان می‌دهد و شامل دکمه‌هایی است که کاربران می‌توانند بااستفاده از آن‌ها درباره اینکه اختلال همچنان وجود دارد یا نه رأی دهند.

رأی دادن برای اختلالات در مسیر و خارج از مسیر در فاصله ۵ کیلومتری کاربر به‌استثنای راه‌بندان‌ها دردسترس است. Google این رأی‌ها را پردازش می‌کند تا تصمیم بگیرد که آیا نمایش اختلال را ادامه دهد یا نه. رأی‌ها ممکن است روی نقشه برای دیگر کاربران Google Maps و Navigation SDK نیز نمایش داده شود.

کارت اطلاعات ناوبری فعال

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

mapView.navigator.shouldDisplayPrompts = true

هشدارهای اختلال خودکار با رأی‌گیری درطول ناوبری فعال

درطول ناوبری فعال، وقتی کاربر به اختلالی در مسیر نزدیک می‌شود، پیام‌واره‌ای با اطلاعاتی درباره اختلال و دکمه‌هایی برای رأی دادن درباره اینکه آیا اختلال هنوز وجود دارد یا نه ظاهر می‌شود. رأی‌های ارسال‌شده توسط کاربران توسط Google پردازش می‌شود و ممکن است در نقشه برای سایر کاربران Google Maps و Navigation SDK نمایش داده شود، و همچنین برای تعیین اینکه آیا نمایش اختلال ادامه یابد یا نه استفاده شود.

کارت اطلاعات ناوبری فعال

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

mapView.navigator.shouldDisplayPrompts = true

گزارش اختلال درطول ناوبری فعال

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

دکمه گزارش کردن منو گزارش کردن

نمایش دادن یا پنهان کردن دکمه گزارش استاندارد

بااستفاده از navigationReportIncidentButtonEnabled می‌توانید نمایان بودن دکمه گزارش استاندارد را درطول پیمایش فعال پیکربندی کنید.

// Enables the incident reporting FAB to show in situations where incident
// reporting is possible.
mapView.settings.navigationReportIncidentButtonEnabled = true

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

به‌جای دکمه گزارش اختلال استاندارد، می‌توانید دکمه گزارش سفارشی به میانای پیمایش اضافه کنید. وقتی کاربر روی دکمه سفارشی کلیک می‌کند، می‌توانید با فراخوانی روش presentReportIncidentsPanel ، نمایش منو گزارش‌دهی را راه‌اندازی کنید. قبل‌از افزودن دکمه گزارش‌دهی سفارشی، با فراخوانی reportIncidentsAvailable بررسی کنید که برنامه در حالت ناوبری فعال باشد و کاربر در کشوری باشد که گزارش‌دهی در آن فعال است. اگر هریک از این موارد درست نباشد، منو گزارش کردن نشان داده نخواهد شد.

  // Check if reporting is available before displaying your button
  let isReportingAvailable = mapview.isIncidentReportingAvailable()
  customReportingIncidentButton.isHidden = !isReportingAvailable
  customReportingIncidentButton.addTarget(self, action: #selector(didTapReportIncidentButton), for: .touchUpInside)
  
  // Trigger the reporting flow if the button is clicked
  func didTapReportIncidentButton() {
          mapView.presentReportIncidentsPanel(self) { [weak self] error in
              guard let self = self else { return }
              if let error = error as NSError? {
                  if error.domain == GMSMapViewPresentReportIncidentPanelErrorDomain {
                      let errorCode = GMSMapViewPresentReportIncidentPanelErrorCode(rawValue: error.code)
                      
                      switch errorCode {
                      case .internal:
                          self.showErrorMessage(
                              title: "Error Presenting Report Incident Panel",
                              message: "An internal error occurred."
                          )
                      case .reportingNotAvailable:
                          self.showErrorMessage(
                              title: "Error Presenting Report Incident Panel",
                              message: "Reporting is not available."
                          )
                      case .none:
                          self.showErrorMessage(
                              title: "Error Presenting Report Incident Panel",
                              message: "An unknown error occurred."
                          )
                      }
                  } else {
                      // Handle other potential errors (e.g., network errors)
                      self.showErrorMessage(
                          title: "Error Presenting Report Incident Panel",
                          message: "An unexpected error occurred: \(error.localizedDescription)"
                      )
                  }
              }
              // If error is nil, the panel was presented successfully. You can add any extra logic here.
          }
     }

کار با واسط‌های کاربر پیمایش سفارشی

اگر پیاده‌سازی شما از Navigation SDK شامل عناصر میانای کاربر سفارشی است، باید عناصر اختلال هم‌زمان را درنظر بگیرید تا از تداخل جلوگیری شود.

موقعیت دکمه گزارش کردن

به‌طور پیش‌فرض، دکمه گزارش اختلال در گوشه پایین/انتهایی نقشه قرار دارد—در سمت راست برای زبان‌های چپ به راست و در سمت چپ برای زبان‌های راست به چپ. اگر لازم است دکمه گزارش‌دهی را جابه‌جا کنید تا برای عناصر میانای کاربر سفارشی فضا ایجاد کنید، از bottomTrailingButtonsLayoutGuide استفاده کنید.

Swift

// Create a new layout guide
let topRightLayoutGuide = UILayoutGuide()
self.view.addLayoutGuide(topRightLayoutGuide)

// Activate constraints using fixed constants here as an example
// assuming the current reporting button is of fixed height
topRightLayoutGuide.topAnchor.constraint(equalTo: _mapView.navigationHeaderLayoutGuide.bottomAnchor, constant: 50).isActive = true
topRightLayoutGuide.trailingAnchor.constraint(equalTo: self.view.safeAreaLayoutGuide.trailingAnchor, constant: -14).isActive = true

// Assign the layout guide
_mapView.bottomTrailingButtonsLayoutGuide = topRightLayoutGuide

// Create an alternate layout guide to use when the header and the footer are not full width
let topRightAlternateLayoutGuide = UILayoutGuide()
self.view.addLayoutGuide(topRightAlternateLayoutGuide)

// Activate constraints using fixed constants here as an example
// assuming the current RTD button is of fixed height
topRightAlternateLayoutGuide.topAnchor.constraint(equalTo: _mapView.navigationHeaderLayoutGuide.bottomAnchor, constant: 20).isActive = true
topRightAlternateLayoutGuide.trailingAnchor.constraint(equalTo: self.view.safeAreaLayoutGuide.trailingAnchor, constant: -10).isActive = true

// Assign the layout guide
_mapView.bottomTrailingButtonsAlternateLayoutGuide = topRightAlternateLayoutGuide

آبجکتیو-سی

// Create a new layout guide
UILayoutGuide *topRightLayoutGuide = [[UILayoutGuide alloc] init];
[self.view addLayoutGuide:topRightLayoutGuide];

// Activate constraints using fixed constants here as an example
// assuming the current RTD button is of fixed height
[[topRightLayoutGuide.topAnchor
    constraintEqualToAnchor:_mapView.navigationHeaderLayoutGuide.bottomAnchor
                   constant:50]
    setActive:YES];

[[topRightLayoutGuide.trailingAnchor
    constraintEqualToAnchor:self.view.safeAreaLayoutGuide.trailingAnchor
                   constant:-14]
    setActive:YES];

// Assign the layout guide
_mapView.bottomTrailingButtonsLayoutGuide = topRightLayoutGuide;

// Create an alternate layout guide to use when the header and the footer are not full width
UILayoutGuide *topRightAlternateLayoutGuide = [[UILayoutGuide alloc] init];
[self.view addLayoutGuide:topRightAlternateLayoutGuide];

// Activate constraints using fixed constants here as an example
// assuming the current RTD button is of fixed height
[[topRightAlternateLayoutGuide.topAnchor
    constraintEqualToAnchor:_mapView.navigationHeaderLayoutGuide.bottomAnchor
                   constant:50]
    setActive:YES];

[[topRightAlternateLayoutGuide.trailingAnchor
    constraintEqualToAnchor:self.view.safeAreaLayoutGuide.trailingAnchor
                   constant:-14]
    setActive:YES];

// Assign the layout guide
_mapView.bottomTrailingButtonsAlternateLayoutGuide = topRightAlternateLayoutGuide;

Prompt Visibility API (آزمایشی)

‫Prompt Visibility API با افزودن شنونده‌ای برای دریافت فراخوانی برگشتی قبل‌از اینکه عنصر میانای کاربر Navigation SDK ظاهر شود و به‌محض اینکه عنصر برداشته شود، به شما کمک می‌کند از تداخل بین عناصر میانای کاربر تولیدشده توسط Navigation SDK و عناصر میانای کاربر سفارشی خودتان جلوگیری کنید. می‌توانید برای عناصر اختلال هم‌زمان، ازجمله کارت‌های اطلاعات، درخواست‌ها، و منو گزارش اختلال—و همچنین برای سایر اعلان‌های تولیدشده توسط Navigation SDK، فراخوان‌های برگشتی دریافت کنید.

Swift

// Additional methods added to GMSNavigatorListener
...
func navigatorWillPresentPrompt(_ navigator: GMSNavigator) {
  // Hide any sort of custom UI element.
}

func navigatorDidDismissPrompt(_ navigator: GMSNavigator) {
  // Show any sort of custom UI element.
}
...

آبجکتیو-سی

// Additional methods added to GMSNavigatorListener
...
- (void)navigatorWillPresentPrompt:(GMSNavigator *)navigator {
  // Hide any sort of custom UI element.
}

- (void)navigatorDidDismissPrompt:(GMSNavigator *)navigator {
  // Show any sort of custom UI element.
}
...