配置实时中断

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

实时中断功能

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 显示的任何提示在显示时都正确分层在您的自定义界面元素之上。如果您无法使用自定义控件，请使用提示可见性 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)