累积道路数据

累积道路数据是指您可以针对所选路线随时间推移而构建的数据。使用 Roads Selection API 创建路线后，您便会开始接收数据。然后，这些数据可用于深入分析、制定战略规划，以及了解路线的长期行为。

累积道路数据以时间序列数据的形式提供，其中包括每条路线的行程时长、速度读取间隔 (SRI) 和路线几何图形。这些数据通过 BigQuery 进行存储和访问。

设置 BigQuery

在 BigQuery 中访问道路数据之前，您必须设置 Google Cloud 项目并订阅数据交换。

前提条件

确保您的 Google Cloud 项目和账号具有以下配置：

  1. 启用 BigQuery API。如需了解相关说明，请参阅使用 Google Cloud 控制台查询公共数据集。
  2. 启用 Analytics Hub API。请参阅 Analytics Hub API。
  3. 授予必要的 IAM 角色。确保您的账号具有以下角色，以便执行订阅者任务和创建数据集：

订阅数据交换

您的道路数据通过 BigQuery (Analytics Hub) 中的私有数据交换与您共享。您将收到 Google 合作伙伴提供的特定订阅链接，以便访问您的数据。此数据集遵循以下命名惯例：

historical_roads_data_PROJECT_NUMBER.

如需订阅您的数据，请执行以下操作：

  1. 点击 Google 合作伙伴提供的订阅链接。此链接会将您直接带到 Google Cloud 控制台中的数据交易所。
  2. 在 Google Cloud 控制台中，查看数据交换详情。
  3. 点击对话框中的订阅按钮。
  4. 订阅完成后，关联的数据集会显示在 Google Cloud 控制台的 BigQuery 探索器面板中。现在，您可以使用“探索器”面板中显示的表名称在 SQL 查询中访问数据。

BigQuery 表

您所选路线的累积道路数据托管在 Google 自有云项目的隔离 BigQuery 数据集下。通过 BigQuery Sharing（Analytics Hub）中专门为您创建的私有数据交换服务与您共享。如需访问数据，您需要订阅数据交易所，并在您的 Google Cloud 项目下创建关联数据集。

共享的 BigQuery 数据集包含一些由 Google 定义和创建的 BigQuery 表。以下是每个表格的详细信息。

historical_travel_time 个表

以下是 BigQuery 表 historical_travel_time 的架构：

名称 模式 类型 说明
selected_route_id NULLABLE STRING selected_route_id 的路线
display_name NULLABLE STRING 路线的显示名称
record_time NULLABLE TIMESTAMP 计算路线数据时的时间戳
duration_in_seconds NULLABLE FLOAT 考虑路况的路线时长
static_duration_in_seconds NULLABLE FLOAT 路线在不考虑路况时的时长
route_geometry NULLABLE 地理位置 路线的考虑了路况的多段线几何图形

表格行为和事实

  • 该表按天分区，并为每个分区设置了 10 年的过期时间。
  • 该表每小时更新一次，其中包含以批处理方式写入的最新流量数据。
  • 在 Roads Selection API 中创建新路线后，您可能需要等待最多 1 小时才能看到此表中的数据。
  • 从 Roads Selection API 中删除路线后，系统不会再向该路线对应的表中写入新数据。不过，历史数据会保留到过期。

recent_roads_data 个表

注意：只有当您的合同包含实时道路数据时，此表才可用。

与 historical_travel_time 不同，此表还包含 SpeedReadingInterval 数据。以下是 BigQuery 中的架构：

名称 模式 类型 说明
selected_route_id NULLABLE STRING selected_route_id 的路线
display_name NULLABLE STRING 路线的显示名称
record_time NULLABLE TIMESTAMP 计算路线数据时的时间戳
duration_in_seconds NULLABLE FLOAT 考虑路况的路线时长
static_duration_in_seconds NULLABLE FLOAT 路线在不考虑路况时的时长
route_geometry NULLABLE 地理位置 路线的考虑了路况的多段线几何图形
speed_reading_intervals REPEATED RECORD 表示整个路线上的交通密度的区间。请参阅 Routes API 中的原始定义
speed_reading_intervals.interval_coordinates REPEATED 地理位置 相应间隔的几何图形
speed_reading_intervals.speed NULLABLE STRING 相应区间的速度分类。可能的值：NORMAL、SLOW、TRAFFIC_JAM

表格行为和事实

  • 该表按天分区，每个分区的过期时间都设置为 60 天。
  • 该表每小时更新一次，其中包含以批处理方式写入的最新流量数据。
  • 在 Roads Selection API 中创建新路线后，您可能需要等待最多 1 小时才能看到此表中的数据。
  • 从 Roads Selection API 中删除路线后，系统不会再将新数据写入该路线对应的此表中。不过，历史数据会保留到过期。

routes_status 个表

该表包含所选路线的元数据和状态信息。旨在提供一种更简便的方式来查看所有路线和状态。它可以与另外两个表联接，以进行数据过滤。以下是 BigQuery 中的架构：

名称 模式 类型 说明
selected_route_id NULLABLE STRING selected_route_id 的路线
display_name NULLABLE STRING 路线的显示名称
状态 NULLABLE STRING 路线的状态
validation_error NULLABLE STRING 路线的验证错误
low_road_usage_start_time NULLABLE TIMESTAMP 在重新验证期间，路线首次被发现道路使用率较低的时间。它与 VALIDATION_ERROR_LOW_ROAD_USAGE 相关联。
route_attributes NULLABLE STRING 所选路线的自定义属性

表格行为和事实

  • 此表中仅包含状态为 STATE_RUNNING 或 STATE_INVALID 的路线。
  • 路线元数据和状态每小时更新一次，不间断。
  • 在 Roads Selection API 中创建新路线后，您可能需要等待最多 1 小时才能在此表中看到该路线。
  • 从 Roads Selection API 中删除路线后，预计最多需要等待 1 小时，才能看到所选路线从该表中移除。