累積道路資料是指您可針對所選路線，隨著時間累積的資料。使用 Roads Selection API 建立路線後，您就會開始接收資料。這項資料可用於深入分析、策略規劃，以及瞭解路線的長期行為。
系統會以時間序列資料的形式提供累積的道路資料，包括每條路線的行程時間、速度讀取間隔 (SRI) 和路線幾何。這項資料會透過 BigQuery 儲存及存取。
設定 BigQuery
如要在 BigQuery 中存取道路資料，請先設定 Google Cloud 專案並訂閱資料交換服務。
必要條件
請確認 Google Cloud 專案和帳戶已完成下列設定：
- 啟用 BigQuery API。如需操作說明，請參閱「使用 Google Cloud 控制台查詢公開資料集」。
- 啟用 Analytics Hub API。請參閱 Analytics Hub API。
- 授予必要的 IAM 角色。請確認帳戶具備下列角色，才能執行訂閱者工作及建立資料集：
- Analytics Hub 訂閱者 (
roles/analyticshub.subscriber) - BigQuery 使用者 (
roles/bigquery.user)
- Analytics Hub 訂閱者 (
訂閱資料交換
我們會透過 BigQuery (Analytics Hub) 的私人資料交換服務，與您共用道路資料。您會收到 Google 合作夥伴提供的專屬訂閱連結，用來存取資料。這個資料集遵循下列命名慣例：
historical_roads_data_PROJECT_NUMBER.
如要訂閱資料，請按照下列步驟操作：
- 按一下 Google 合作夥伴提供的訂閱連結。這個連結會直接帶您前往 Google Cloud 控制台中的資料交換。
- 在 Google Cloud 控制台中，查看資料交換詳細資料。
- 按一下對話方塊中的「訂閱」按鈕。
- 訂閱完成後，連結的資料集會顯示在 Google Cloud 控制台的 BigQuery 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 | 可以為空值 | TIMESTAMP | 計算路線資料的時間戳記 |
| duration_in_seconds | 可以為空值 | FLOAT | 路線的車流量感知時間 |
| static_duration_in_seconds | 可以為空值 | FLOAT | 路線所需時間 (未考量路況) |
| route_geometry | 可以為空值 | 地理位置 | 路線的車流量監測折線幾何圖形 |
資料表行為和事實
- 資料表會依天分區，且每個分區的到期時間都設為 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 | 可以為空值 | TIMESTAMP | 計算路線資料的時間戳記 |
| 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 |
資料表行為和事實
- 資料表會依天分區，且每個分區的到期時間都設為 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 | 可以為空值 | TIMESTAMP | 在重新驗證期間，路線首次出現道路使用率偏低的情況。這項錯誤與 VALIDATION_ERROR_LOW_ROAD_USAGE 相關聯。 |
| route_attributes | 可以為空值 | STRING | 所選路線的自訂屬性 |
資料表行為和事實
- 只有處於 STATE_RUNNING 或 STATE_INVALID 狀態的路由會納入這個表格。
- 路線中繼資料和狀態每小時更新一次，不會中斷。
- 在 Roads Selection API 中建立新路線後，最多可能需要等待 1 小時，才能在這個表格中看到該路線。
- 從 Roads Selection API 刪除路徑後，最多需要 1 小時，所選路徑才會從這個表格中移除。