了解路线验证

创建路线后,Roads Selection API 会执行验证流程。此验证可确保路线适合在 Roads Management Insights 中进行数据收集和更新。此过程通常会在几分钟内完成。

您可以通过 API 响应中的 state 字段监控路由的验证状态。您可以使用 get 端点(如获取所选路线中所述)或检查 BigQuery 中的 routes_status 表来检查此情况。

路由状态

SelectedRoute 资源中的 state 字段指示其当前验证和运行状态。state 字段可以具有以下值:

  • STATE_UNSPECIFIED:此路线的验证状态未设置。
  • STATE_VALIDATING:正在验证路由。
  • STATE_RUNNING:路由已成功通过验证,现在处于活跃状态。API 正在积极收集数据,并定期向 BigQuery、Pub/Sub 或两者发送此路线的更新。
  • STATE_DELETING:路由已被标记为待删除,正在从系统中移除。
  • STATE_INVALID:路线未通过基于特定条件的验证。 当路线处于 STATE_INVALID 状态时,响应会包含 validationError 字段,其中详细说明了验证失败的原因。

验证错误

当 SelectedRoute 资源的 state 为 STATE_INVALID 时,API 响应会包含 validationError 字段。此字段提供验证失败的具体原因。

validationError 字段可以具有以下值:

  • VALIDATION_ERROR_UNSPECIFIED:未设置此路线的验证错误。
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION:路线超出了项目的授权管辖范围。
  • VALIDATION_ERROR_LOW_ROAD_USAGE:路线的道路使用率较低,这意味着无法收集足够的流量数据来进行有意义的分析。如果交通流量增加到预定阈值以上,因道路使用率低而被归类为无效的路线可能会再次变为有效。如需了解详情,请参阅低道路使用率路线。

低道路使用率路线

如果 API 确定没有足够的流量数据来进行一致的分析,则路线可能会被标记为 VALIDATION_ERROR_LOW_ROAD_USAGE。这可能会在初始验证期间或持续评估期间发生。

对于道路使用率较低的路线,您可能会遇到以下情况:

  • 继续向 BigQuery 发布数据:即使某条路线因道路使用率低而被归类为 STATE_INVALID,API 仍会继续处理该路线的任何可用数据并将其发布到 BigQuery。
  • Pub/Sub 更新停止:如果路线的 state 更改为 STATE_INVALID,则对 Pub/Sub 的定期实时更新将停止。
  • 季度评估:API 会按季度评估所有活跃路线的流量。
    • 如果在评估期间检测到流量较低,API 会在 SelectedRoute 资源中发出警告。
    • 如果流量连续四个季度保持低水平,则路由的 state 会更改为 STATE_INVALID,并且 Pub/Sub 更新会停止。
  • 可能会重新验证:即使路线为 STATE_INVALID,也仍会持续接受流量评估。如果后续评估发现该路线的流量超过预定阈值,则可能会将其重新归类为有效 (STATE_RUNNING)。
  • 监控状态:您可以通过 get 端点监控路由的验证状态(如获取所选路由中所述),也可以通过检查 BigQuery 中的 routes_status 表来监控路由的验证状态。

排查无效路由问题

如果您的路由 state 为 STATE_INVALID,请根据您收到的 validationError 遵循以下问题排查指南:

  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION:此错误表示定义的路线超出了为您的项目授权的地理区域。如需解决此问题,请删除现有路线并重新创建路线,确保其所有点(起点、终点和任何中间点)都在您获得授权的项目管辖范围内。

  • VALIDATION_ERROR_LOW_ROAD_USAGE:此错误表示所选路线没有足够的道路使用数据,无法进行有意义的分析和更新。如需解决此问题,请删除现有路线并重新创建路线,选择道路使用率或“繁忙程度”较高的区域进行数据收集。请注意,如果您的路线出现此错误,并且流量随着时间的推移而增加,则路线的状态可能会变回 STATE_RUNNING,如道路使用率低的路线中所述。