Định cấu hình thông tin gián đoạn theo thời gian thực

Thông tin gián đoạn theo thời gian thực là một tập hợp các tính năng cảnh báo người dùng về tình trạng gián đoạn trên tuyến đường của họ, đồng thời cho phép người dùng báo cáo và xác minh tình trạng gián đoạn mà họ gặp phải. Ví dụ về tình trạng tắc nghẽn bao gồm tai nạn xe cộ, tình trạng ùn tắc giao thông, sự hiện diện của cảnh sát và camera đo tốc độ, công trình xây dựng, làn đường bị đóng và một số điều kiện thời tiết. Trang này giải thích các tính năng gián đoạn theo thời gian thực và các lựa chọn cấu hình của các tính năng này, bao gồm cả những điểm cần cân nhắc đối với các ứng dụng sử dụng giao diện người dùng điều hướng tuỳ chỉnh.

Các tính năng về tình trạng gián đoạn theo thời gian thực

• Chú thích tương tác về tình trạng gián đoạn dọc theo tuyến đường.
• Cảnh báo tự động về tình trạng gián đoạn có tính năng bình chọn trong khi chỉ đường.
• Báo cáo tình trạng gián đoạn trong khi đang chỉ đường.

Các tính năng này có thể định cấu hình và được bật theo mặc định. Các phần sau đây cung cấp thêm thông tin về các tính năng và lựa chọn cấu hình hiện có.

Chú thích tương tác về tình trạng gián đoạn dọc theo tuyến đường

Khi một ứng dụng hiển thị một tuyến đường, cho dù là trong phần tổng quan về tuyến đường hay trong khi đang di chuyển, mọi sự cố hiện tại sẽ xuất hiện dưới dạng chú thích dọc theo tuyến đường. Khi bạn bật lớp giao thông, tình trạng gián đoạn ngoài tuyến đường cũng sẽ xuất hiện trên bản đồ. Chú thích có một biểu tượng cho biết loại gián đoạn.

Bạn có thể kiểm soát việc hiển thị chú thích về tình trạng gián đoạn dọc theo các tuyến đường bằng cách sử dụng shouldDisplayPrompts. Chế độ này cũng kiểm soát việc hiển thị cảnh báo tự động khi người dùng đến gần một tình trạng gián đoạn.

mapView.navigator.shouldDisplayPrompts = true

Hiển thị thông tin chi tiết về sự gián đoạn khi người dùng nhấn vào chú thích

Khi bạn nhấn vào chú thích về tình trạng gián đoạn, một thẻ thông tin sẽ xuất hiện kèm theo thông tin chi tiết. Điều này áp dụng cho cả chú thích trên tuyến đường và chú thích ngoài tuyến đường, mặc dù chú thích ngoài tuyến đường chỉ xuất hiện nếu bạn bật lớp giao thông. Thẻ này hiển thị loại thông tin gián đoạn, thời gian báo cáo gần đây nhất và đôi khi có lựa chọn bỏ phiếu xem thông tin gián đoạn có còn xảy ra hay không. Loại thẻ thông tin và các lựa chọn cấu hình của thẻ này sẽ thay đổi tuỳ thuộc vào việc người dùng có đang ở chế độ chỉ đường hay không.

Thẻ thông tin chú thích trên thông tin tổng quan về tuyến đường, trước khi bắt đầu chế độ chỉ đường đang hoạt động

Trước khi bắt đầu chế độ chỉ đường chủ động, người dùng có thể nhấn vào chú thích trên tuyến đường hoặc ngoài tuyến đường trên bản đồ hoặc phần tổng quan về tuyến đường để mở thẻ thông tin. Chú thích ngoài tuyến đường yêu cầu bạn bật lớp giao thông. Thẻ thông tin cung cấp thêm thông tin chi tiết về tình trạng gián đoạn.

Bạn có thể kiểm soát khả năng người dùng nhấn vào chú thích về sự cố trên bản tổng quan về tuyến đường để hiển thị thêm thông tin bằng cách sử dụng showsIncidentCards.

mapView.settings.showsIncidentCards = true

Thẻ thông tin chú thích trong khi đi theo chỉ dẫn

Trong quá trình chỉ đường, người dùng có thể nhấn vào chú thích về sự cố trên đường hoặc ngoài đường để mở thẻ thông tin. Thẻ này cho biết loại gián đoạn và thời gian báo cáo gần đây nhất, đồng thời có các nút để người dùng bình chọn xem tình trạng gián đoạn có còn tiếp diễn hay không.

Người dùng có thể bình chọn cho các sự cố trên đường và ngoài đường trong phạm vi 5 km, ngoại trừ trường hợp đường bị đóng. Google xử lý những lượt bình chọn này để giúp xác định xem có nên tiếp tục hiển thị thông tin về sự cố ngừng dịch vụ hay không. Phiếu bầu cũng có thể xuất hiện trên bản đồ cho những người dùng khác của Google Maps và Navigation SDK.

Bạn có thể kiểm soát việc hiển thị và khả năng nhấn của chú thích gián đoạn trong quá trình điều hướng đang hoạt động bằng cách sử dụng shouldDisplayPrompts. Lớp này cũng kiểm soát việc hiển thị chú thích dọc theo các tuyến đường và việc hiển thị cảnh báo tự động khi người dùng tiếp cận một điểm gián đoạn.

mapView.navigator.shouldDisplayPrompts = true

Cảnh báo gián đoạn tự động kèm tính năng bình chọn trong khi chế độ chỉ đường đang hoạt động

Trong quá trình chỉ đường, khi người dùng đến gần một điểm gián đoạn trên tuyến đường, một lời nhắc sẽ xuất hiện kèm theo thông tin về điểm gián đoạn và các nút để bình chọn xem điểm gián đoạn đó có còn tồn tại hay không. Google sẽ xử lý các lượt bình chọn do người dùng gửi và có thể hiển thị các lượt bình chọn đó trên bản đồ cho những người dùng khác của Google Maps và Navigation SDK, cũng như dùng để xác định xem có nên tiếp tục hiển thị thông tin về sự cố hay không.

Bạn có thể định cấu hình chế độ hiển thị của lời nhắc cảnh báo trong khi đang điều hướng bằng cách sử dụng shouldDisplayPrompts. Lớp này cũng kiểm soát chế độ hiển thị của chú thích dọc theo các tuyến đường.

mapView.navigator.shouldDisplayPrompts = true

Báo cáo tình trạng gián đoạn trong khi đi theo chỉ dẫn

Trong chế độ thao tác đang hoạt động, một nút sẽ xuất hiện trên giao diện người dùng chỉ đường, cho phép người dùng báo cáo các sự cố mới dọc theo tuyến đường của họ. Khi người dùng nhấn vào nút này, một trình đơn sẽ xuất hiện với các loại thông tin gián đoạn có thể báo cáo. Google sẽ xử lý các báo cáo do người dùng gửi và có thể hiển thị các báo cáo đó trên bản đồ cho những người dùng khác của Google Maps và Navigation SDK.

Hiện hoặc ẩn nút báo cáo chuẩn

Bạn có thể định cấu hình chế độ hiển thị của nút báo cáo tiêu chuẩn trong quá trình điều hướng đang hoạt động bằng cách sử dụng navigationReportIncidentButtonEnabled.

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

Thêm nút báo cáo tuỳ chỉnh

Thay vì nút báo cáo gián đoạn tiêu chuẩn, bạn có thể thêm một nút báo cáo tuỳ chỉnh vào giao diện người dùng điều hướng. Khi người dùng nhấp vào nút tuỳ chỉnh, bạn có thể kích hoạt việc hiển thị trình đơn báo cáo bằng cách gọi phương thức presentReportIncidentsPanel. Trước khi thêm nút báo cáo tuỳ chỉnh, hãy xác minh rằng ứng dụng đang ở chế độ điều hướng đang hoạt động và người dùng đang ở quốc gia có bật tính năng báo cáo bằng cách gọi reportIncidentsAvailable. Nếu một trong hai điều kiện này không đúng, thì trình đơn báo cáo sẽ không xuất hiện.

  // 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.
          }
     }

Thao tác với giao diện người dùng điều hướng tuỳ chỉnh

Nếu việc triển khai Navigation SDK của bạn có các phần tử giao diện người dùng tuỳ chỉnh, bạn cần cân nhắc các phần tử gây gián đoạn theo thời gian thực để tránh xung đột.

Vị trí của nút báo cáo

// 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 (Thử nghiệm)

// 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.
}
...