累積的道路資料

累積道路資料是指您可針對所選路線，隨著時間累積的資料。使用 Roads Selection API 建立路線後，您就會開始接收資料。這項資料隨後就會用於深入分析、策略規劃，以及瞭解路線的長期行為。

累積的道路資料會以時間序列資料的形式提供，包括：

  • 行程期間
  • 快速朗讀間隔 (SRI)
  • 路線幾何圖形

設定 BigQuery

如要在 BigQuery 中存取道路資料，您必須先設定 Google Cloud 專案並訂閱資料交換。

必要條件

確認 Google Cloud 雲端專案和帳戶符合下列設定：

  1. 啟用 BigQuery API。如需操作說明，請參閱「使用 Google Cloud 控制台查詢公開資料集」。
  2. 啟用 Analytics Hub API。請參閱 Analytics Hub API。
  3. 授予必要 IAM 角色。請確認帳戶具備下列角色，可執行訂閱者工作和建立資料集：
  4. Analytics Hub 訂閱者 (roles/analyticshub.subscriber)

訂閱資料交換庫

系統會透過 BigQuery (Analytics Hub) 的私人資料交換服務，與您共用道路資料。你會收到 Google 合作夥伴提供的特定訂閱連結，用來存取資料。這個資料集遵循下列命名慣例：

historical_roads_data_PROJECT_NUMBER.

如要訂閱資料，請按照下列步驟操作：

  1. 按一下 Google 合作夥伴提供的訂閱連結。這個連結會直接將您帶往 Google Cloud 控制台的資料交換頁面。
  2. 在 Google Cloud 控制台中，查看資料交換詳細資料。
  3. 按一下對話方塊中的「訂閱」按鈕。
  4. 訂閱完成後，連結的資料集會顯示在 Google Cloud 控制台的 BigQuery Explorer 面板中。現在您可以使用「Explorer」面板中顯示的資料表名稱，在 SQL 查詢中存取資料。

BigQuery 資料表

所選路線累積的道路資料會託管在 Google 擁有的雲端專案中，與其他資料隔離的 BigQuery 資料集。系統會透過 BigQuery sharing (原 Analytics Hub) 專為您建立的私有資料交換服務，與您共用資料。如要存取資料，請訂閱資料交換庫，並在 Google Cloud 雲端專案下建立連結的資料集。

共用的 BigQuery 資料集包含 Google 定義及建立的幾個 BigQuery 資料表。以下是各個表格的詳細資料。

historical_travel_time 個資料表

以下是 BigQuery 資料表 historical_travel_time 的結構定義：

名稱 模式 類型 說明
selected_route_id 可以為空值 STRING selected_route_id 的路線
display_name 可以為空值 STRING 路由的顯示名稱
record_time 可以為空值 時間戳記 計算路線資料的時間戳記
duration_in_seconds 可以為空值 FLOAT 路線的車流量感知時間長度
static_duration_in_seconds 可以為空值 FLOAT 路線的車流量不明時間
route_geometry 可以為空值 地理位置 路線的車流量監測折線幾何圖形
road_segment_ids REPEATED STRING 路線沿途的路段，以地點 ID 表示

資料表行為和事實

  • 資料表會按天分區，且每個分區的到期日都設為 10 年。
  • 系統每小時會以批次寫入的方式，更新資料表中的最新交通資訊。
  • 在 Roads Selection API 中建立新路線後，請等待最多 1 小時，即可在這個資料表中查看資料。
  • 從 Roads Selection API 刪除路線後，系統就不會再將新資料寫入該路線的資料表。不過，歷來資料仍會保留至到期為止。
  • 路線上的路段會依拓撲順序排列，且一律相連。

recent_roads_data 個資料表

注意：只有在合約包含即時道路資料時，才會顯示這張表格。

與 historical_travel_time 不同，這個資料表也會保留 SpeedReadingInterval 資料。以下是 BigQuery 中的結構定義：

名稱 模式 類型 說明
selected_route_id 可以為空值 STRING selected_route_id 的路線
display_name 可以為空值 STRING 路由的顯示名稱
record_time 可以為空值 時間戳記 計算路線資料的時間戳記
duration_in_seconds 可以為空值 FLOAT 路線的車流量感知時間長度
static_duration_in_seconds 可以為空值 FLOAT 路線的車流量不明時間
route_geometry 可以為空值 地理位置 路線的車流量監測折線幾何圖形
speed_reading_intervals REPEATED RECORD 代表路線交通密度的間隔。請參閱 Routes API 中的原始定義
speed_reading_intervals.interval_coordinates REPEATED 地理位置 這個間隔的幾何圖形
speed_reading_intervals.speed 可以為空值 STRING 這個間歇的配速分類。可能的值： NORMAL、SLOW、TRAFFIC_JAM
road_segment_ids REPEATED STRING 路線沿途的路段，以地點 ID 表示

資料表行為和事實

  • 資料表按天分區，且每個分區的到期日都設為 60 天。
  • 系統每小時會以批次寫入的方式，更新資料表中的最新交通資訊。
  • 在 Roads Selection API 中建立新路線後，請等待最多 1 小時，即可在這個資料表中查看資料。
  • 從 Roads Selection API 刪除路線後，系統就不會再將新資料寫入該路線的資料表。不過，歷來資料仍會保留至到期為止。
  • 路線上的路段會依拓撲順序排列，且一律相連。

routes_status 個資料表

表格會顯示所選路徑的中繼資料和狀態資訊。方便您查看所有路線和狀態。您可以將這個資料表與其他兩個資料表彙整，以篩選資料。以下是 BigQuery 中的結構定義：

名稱 模式 類型 說明
selected_route_id 可以為空值 STRING selected_route_id 的路線
display_name 可以為空值 STRING 路由的顯示名稱
狀態* 可以為空值 STRING 路線狀態
validation_error 可以為空值 STRING 路線驗證錯誤
low_road_usage_start_time 可以為空值 時間戳記 路線在重新驗證期間首次觀察到道路使用率偏低的時間。這項錯誤與 VALIDATION_ERROR_LOW_ROAD_USAGE 相關聯。
route_attributes 可以為空值 STRING 所選路線的自訂屬性

*本表中的路線狀態會以 STATUS_ 開頭，而非 STATE_。否則與 Roads Selection API 一致。

資料表行為和事實

  • 只有 STATUS_RUNNING 或 STATUS_INVALID 狀態的路由會納入這個表格。
  • 路線中繼資料和狀態每小時更新一次，不會中斷。
  • 在 Roads Selection API 中建立新路線後，最多可能需要等待 1 小時，才能在這個表格中看到該路線。
  • 從 Roads Selection API 刪除路線後，最多可能需要 1 小時，所選路線才會從這個表格中移除。