了解路线验证

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

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

路线状态

state 资源中的 SelectedRoute 字段表示其当前的 验证和运行状态。The 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（如 道路使用率较低的路线中所述）。