请选择平台： Android iOS

配置实时中断

实时中断信息是一组功能，可提醒用户其路线上的中断情况，并允许用户报告和验证他们遇到的中断情况。 中断的示例包括交通事故、交通拥堵、警察和测速摄像头、施工、车道封闭以及某些天气状况。本页介绍了实时中断功能及其配置选项，包括使用自定义导航界面的应用的注意事项。

实时中断功能

Navigation SDK 包含以下实时中断功能，作为核心导航体验的一部分：

这些功能可配置，并且默认处于启用状态。以下部分详细介绍了这些功能和可用的配置选项。

沿途的互动式中断标注

当应用显示路线时（无论是在路线概览中还是在有效导航期间），任何当前中断情况都会以标注的形式显示在路线沿途。启用路况图层后，地图上还会显示路线外的交通中断情况。标注包含一个图标，用于指示中断类型。

路线沿途的标注

您可以使用 shouldDisplayPrompts 控制沿路线显示中断标注，该属性还可控制在用户接近中断时显示自动提醒。 

mapView.navigator.shouldDisplayPrompts = true

在用户点按标注时显示中断详情

点按中断标注会打开一个信息卡片，其中包含更多详细信息。此设置适用于沿途和非沿途标注，但只有在启用流量图层后，非沿途标注才会显示。该卡片会显示中断类型、上次报告的时间，有时还会显示一个选项，供您投票说明中断是否仍然存在。信息卡片类型及其配置选项因用户是否处于主动导航状态而异。

在开始主动导航之前，在路线概览上显示标注信息卡

在开始主动导航之前，用户可以点按地图或路线概览中的沿途标注或非沿途标注，打开信息卡片。若要使用偏离路线标注，需要启用流量图层。信息卡片会提供有关中断的更多详细信息。

概览信息卡片

您可以使用 showsIncidentCards 控制用户是否可以点按路线概览中的中断标注来显示更多信息。

mapView.settings.showsIncidentCards = true

有效导航期间的标注信息卡片

在主动导航期间，用户可以点按路线上的或路线外的中断标注，打开信息卡片。该卡片会显示中断类型和上次报告时间，并包含一些按钮，供用户投票表决中断是否仍然存在。

用户可以对距离自己 5 公里以内的路线中和路线外的中断情况进行投票，但不包括道路封闭。Google 会处理这些投票，以帮助确定是否继续显示中断信息。投票结果也可能会显示在地图上，供其他 Google 地图和 Navigation SDK 用户查看。

正在进行导航的信息卡片

您可以使用 shouldDisplayPrompts 控制在有效导航期间中断信息框的显示和可点按性，该方法还可控制沿路线显示信息框以及在用户接近中断时显示自动提醒。

mapView.navigator.shouldDisplayPrompts = true

在导航期间自动显示中断提醒并提供投票功能

在主动导航期间，当用户接近路线上的中断点时，系统会显示一条提示，其中包含有关中断点的信息以及用于投票选择中断点是否仍然存在的按钮。 用户提交的投票由 Google 处理，可能会在地图上显示给其他 Google 地图和 Navigation SDK 用户，也可能会用于确定是否继续显示中断信息。

“正在进行导航”信息卡片

您可以使用 shouldDisplayPrompts 配置在有效导航期间显示提醒提示，该属性还可控制沿路线显示的标注。

mapView.navigator.shouldDisplayPrompts = true

在导航期间报告路况异常

在主动导航模式下，导航界面上会显示一个按钮，用户可以通过该按钮报告沿途的新中断情况。当用户点按该按钮时，系统会显示一个菜单，其中列出了可报告的干扰类型。 用户提交的报告会由 Google 处理，并可能会在地图上显示给其他 Google 地图和 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

Objective-C

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

Objective-C

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