پیکربندی اختلالهای همزمان
اختلالات همزمان مجموعهای از ویژگیها است که به کاربران درباره اختلالات درطول مسیرشان هشدار میدهد و به کاربران امکان میدهد اختلالاتی را که با آنها مواجه میشوند گزارش و تأیید کنند. نمونههایی از اختلالات شامل تصادفات وسایل نقلیه، ازدحام ترافیک، حضور پلیس و دوربینهای سرعت، ساختوساز، بستهشدن خطوط، و شرایط آبوهوایی خاص است. این صفحه ویژگیهای اختلال همزمان و گزینههای پیکربندی آنها را توضیح میدهد، ازجمله ملاحظاتی برای برنامههایی که از رابطهای کاربری ناوبری سفارشی استفاده میکنند.
ویژگیهای اختلال همزمان
کیت توسعه نرمافزار پیمایش شامل ویژگیهای اختلال همزمان زیر بهعنوان بخشی از تجربه پیمایش اصلی است:- برچسبهای تعاملی اختلال درطول مسیر.
- هشدارهای خودکار اختلال با رأیگیری درطول ناوبری فعال.
- گزارش اختلال درطول ناوبری فعال.
این ویژگیها قابلپیکربندی هستند و بهطور پیشفرض فعالاند. بخشهای زیر اطلاعات بیشتری درباره ویژگیها و گزینههای پیکربندی دردسترس ارائه میدهد.
توضیحات تعاملی اختلال درطول مسیرها
وقتی برنامهای مسیری را نمایش میدهد، چه در نمای کلی مسیر و چه درطول ناوبری فعال، هرگونه اختلال فعلی بهصورت فراخوان درطول مسیر نشان داده میشود. وقتی لایه ترافیک را فعال میکنید، اختلالات خارج از مسیر نیز روی نقشه ظاهر میشوند. آوانماها شامل نمادی هستند که نوع اختلال را نشان میدهد.
بااستفاده از 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. } ...