配置实时中断

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

实时异常功能

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

• 沿途的互动式中断标注。
• 在有效导航期间，通过投票功能自动发出干扰提醒。
• 在有效导航期间报告中断。

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

沿途异常情况互动式标注

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

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

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

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

点按中断标注可打开信息卡片，查看更多详细信息。这适用于路线内和路线外标注，但路线外标注仅在启用路况图层时才会显示。该卡片会显示中断类型、上次报告的时间，有时还会显示一个选项，供您投票说明中断是否仍然存在。信息卡类型及其配置选项因用户是否处于主动导航状态而异。

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

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

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

// Using the SupportNavigationFragment
mNavFragment.setTrafficIncidentCardsEnabled(true);

// Using the NavigationView
navigationView.setTrafficIncidentCardsEnabled(true);

在导航期间显示标注信息卡片

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

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

您可以使用 setTrafficPromptsEnabled 控制在主动导航期间是否显示中断标注以及中断标注是否可点按，该方法还可控制是否沿路线显示标注以及是否在用户接近中断时显示自动提醒。

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

在导航过程中自动发出异常提醒，并提供投票功能

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

您可以使用 setTrafficPromptsEnabled 配置在主动导航期间显示提醒提示，该方法还可控制沿路线显示标注。

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

在导航期间报告异常路况

在主动导航模式下，导航界面上会显示一个按钮，用户可以通过该按钮报告沿途的新中断情况。用户点按该按钮后，系统会显示一个菜单，其中包含可报告的干扰类型。 用户提交的报告会由 Google 处理，并可能会在地图上向其他 Google 地图和 Navigation SDK 用户显示。

报告封路情况可能会显示一条绕过封闭路段的备用路线，并提示用户确认或拒绝重新规划路线。此功能视供应情况而定。

显示或隐藏标准报告按钮

您可以使用 setReportIncidentButtonEnabled 配置在主动导航期间标准报告按钮的可见性。

// Enables the incident reporting button to show in situations where incident
// reporting is possible.

// Using the SupportNavigationFragment
mNavFragment.setReportIncidentButtonEnabled(true);

// Using the NavigationView
navigationView.setReportIncidentButtonEnabled(true);

添加自定义报告按钮

您可以向导航界面添加自定义报告按钮，以取代标准路况报告按钮。当用户点击自定义按钮时，您可以通过调用 showReportIncidentsPanel 方法来触发举报菜单的显示。在添加自定义报告按钮之前，请调用 isIncidentReportingAvailable，验证应用是否处于主动导航状态，以及用户是否位于已启用报告功能的国家/地区。如果其中任何一项不符合要求，举报菜单都不会显示。

  Button customReportIncidentButton = findViewById(R.id.custom_reporting_button);
  
  // Check if reporting is available before displaying your button
  customReportIncidentButton.setVisibility(
      navigationView.isReportingAvailable ? View.VISIBLE : View.GONE);
  
  // Trigger the reporting flow if the button is clicked
  customReportIncidentButton.setOnClickListener(v ->
      navigationView.showReportIncidentsPanel());
  

使用自定义导航界面

如果您的 Navigation SDK 实现包含自定义界面元素，则需要考虑实时中断元素，以避免冲突。

举报按钮位置

默认情况下，中断报告按钮位于地图的底部末端/尾角，对于从左到右书写的语言，该按钮位于右侧；对于从右到左书写的语言，该按钮位于左侧。如果您需要移动报告按钮，以便为自定义界面元素腾出空间，请添加 BOTTOM_END_BELOW 或 FOOTER 自定义控件，这会将按钮的位置向上推。将您自己的自定义界面放置在自定义控件中，还可确保 Navigation SDK 显示的任何提示在显示时都能正确地叠加在自定义界面元素上。如果您无法使用自定义控件，请使用 Prompt Visibility API 来管理潜在的界面冲突。

Prompt Visibility API（实验性）

Prompt Visibility API 可帮助您避免 Navigation SDK 生成的界面元素与您自己的自定义界面元素之间发生冲突，方法是添加一个监听器，以便在 Navigation SDK 界面元素即将出现之前以及该元素被移除后立即接收回调。您可以接收实时干扰元素（包括信息卡、提示和干扰报告菜单）以及 Navigation SDK 生成的其他通知的回调。

// Sample listener
val listener: PromptVisibilityChangedListener = { isVisible ->
	if (isVisible) {
		customFab.visibility = false
		customFooter.visibility = false
		moveSomeOtherThingsAround()
	} else {
		customFab.visibility = true
		customFooter.visibility = true
		moveSomeThingsBackToWhereTheyWereBefore()
	}
}

// Inside onCreate()
navigationView.addPromptVisibilityChangedListener(listener)

// Inside onDestroy()
navigationView.removePromptVisibilityChangedListener(listener)