Đị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 gián đoạn tự động kèm tính năng bình chọn trong khi đang 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 gián đoạn tương tác 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 bao gồm 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. Lựa chọn này cũng kiểm soát việc hiển thị cảnh báo tự động khi người dùng tiếp cận 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 một chú thích về sự gián đoạn, một thẻ thông tin sẽ mở ra và cung cấp thêm thông tin chi tiết. Điều này áp dụng cho cả chú thích trên tuyến đường và ngoài tuyến đường, mặc dù chú thích ngoài tuyến đường chỉ xuất hiện nếu lớp giao thông được bật. Thẻ này cho biết loại sự cố, thời điểm báo cáo gần đây nhất và đôi khi có cả lựa chọn để bình chọn xem sự cố đó 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ẽ khác nhau 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ề sự cố 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 khi đang đi theo chỉ dẫn, người dùng có thể nhấn vào chú thích về sự cố trên tuyến đường hoặc ngoài tuyến đường để mở thẻ thông tin. Thẻ này cho biết loại sự cố 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 sự cố 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 tuyến đường và ngoài tuyến đường trong phạm vi 5 km, ngoại trừ trường hợp đường bị đóng. Google xử lý các lượt bình chọn này để xác định xem có nên tiếp tục hiển thị sự cố hay không. Các lượt bình chọn 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à SDK chỉ đường.

Bạn có thể kiểm soát việc hiển thị và khả năng nhấn của chú thích về sự cố trong quá trình điều hướng đang diễn ra 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 sự cố.

mapView.navigator.shouldDisplayPrompts = true

Cảnh báo gián đoạn tự động có tính năng bỏ phiếu trong khi chỉ đườ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à SDK Điều hướng, cũng như dùng các lượt bình chọn đó để xác định xem có tiếp tục hiển thị sự cố gián đoạn hay không.

Bạn có thể định cấu hình chế độ hiển thị lời nhắc cảnh báo trong quá trình điều hướng đang hoạt động bằng cách sử dụng shouldDisplayPrompts. Lựa chọn này cũng kiểm soát chế độ hiển thị 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 để người dùng có thể báo cáo các sự cố mới trên 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 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 sự cố gián đoạn tiêu chuẩn, bạn có thể thêm nút báo cáo tùy 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 tùy 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 ở một quốc gia cho phép 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 được đáp ứng, 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 quá trình triển khai Navigation SDK 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í 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.
}
...