累積道路データとは、選択したルートについて経時的に構築できるデータを指します。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 | 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 年間の有効期限が設定されています。
- テーブルは 1 時間ごとに更新され、最新のトラフィック データがバッチで書き込まれます。
- Roads Selection API で新しいルートが作成されると、このテーブルでデータが利用可能になるまでに最大 1 時間かかることがあります。
- 道路選択 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 日間の有効期限が設定されています。
- テーブルは 1 時間ごとに更新され、最新のトラフィック データがバッチで書き込まれます。
- Roads Selection API で新しいルートが作成されると、このテーブルでデータが利用可能になるまでに最大 1 時間かかることがあります。
- ルートが Roads Selection API から削除されると、そのルートの新しいデータはこのテーブルに書き込まれなくなります。ただし、過去のデータは有効期限が切れるまで残ります。
routes_status 個のテーブル
このテーブルには、選択したルートのメタデータとステータス情報が表示されます。すべてのルートとステータスを簡単に確認できるようにすることを目的としています。他の 2 つのテーブルと結合して、データをフィルタできます。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 ステータスのルートのみが含まれます。
- ルートのメタデータとステータスは 1 時間ごとに継続的に更新されます。
- Roads Selection API で新しいルートが作成されると、この表にルートが表示されるまでに最大 1 時間ほどかかることがあります。
- ルートが Roads Selection API から削除されると、選択したルートがこのテーブルから削除されるまでに最大 1 時間かかることがあります。