了解路线验证

创建路线后,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 资源的 stateSTATE_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 表来监控路线的验证状态。

排查无效路线

如果您的路线 stateSTATE_INVALID,请根据您收到的 validationError 按照以下问题排查指南操作:

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

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