蓄積された道路データ

蓄積された道路データとは、選択したルートについて時間経過とともに構築できるデータを指します。Roads Selection API でルートを作成すると、データの受信が開始されます。このデータは、詳細な分析、戦略的計画、ルートの長期的な動作の把握に使用できます。

蓄積された道路データは、次のような時系列データとして提供されます。

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 の [エクスプローラ] パネルに表示されます。[エクスプローラ] パネルに表示されているテーブル名を使用して、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 地域 ルートの交通状況を考慮したポリライン ジオメトリ
road_segment_ids REPEATED STRING ルート沿いの道路区間（プレイス ID で表されます）

テーブルの動作と事実

  • テーブルは日付でパーティション分割され、各パーティションに 10 年間の有効期限が設定されています。
  • テーブルは 1 時間ごとに更新され、最新の交通データがバッチで書き込まれます。
  • Roads Selection API で新しいルートが作成されると、このテーブルでデータが利用可能になるまでに最大 1 時間かかることがあります。
  • Routes Selection API からルートが削除されると、このルートの新しいデータはこのテーブルに書き込まれなくなります。ただし、過去のデータは有効期限まで残ります。
  • ルートに沿った道路セグメントはトポロジ順に並び、常に接続されています。

recent_roads_data 個のテーブル

注: この表は、契約にリアルタイムの道路データが含まれている場合にのみ使用できます。

historical_travel_time とは異なり、このテーブルにはオフセット ベースの高速読み取り間隔（speed_reading_offsets）と、座標ベースの高速読み取り間隔（speed_reading_intervals）も含まれています。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 座標ベースの従来の速読間隔。2026 年 11 月 9 日以降、入力されなくなる可能性があります。代わりに speed_reading_offsets を使用してください。速読の間隔をご覧ください。
speed_reading_intervals.interval_coordinates REPEATED 地域 レガシー。2026 年 11 月 9 日以降、データが入力されなくなる可能性があります。代わりに speed_reading_offsets を使用してください。この間隔のジオメトリ
speed_reading_intervals.speed NULLABLE STRING レガシー。2026 年 11 月 9 日以降、データが入力されなくなる可能性があります。代わりに speed_reading_offsets を使用してください。このインターバルの速度の分類。有効な値: NORMAL、SLOW、TRAFFIC_JAM。この以前のフィールドでは、ひどい渋滞（濃い赤）も TRAFFIC_JAM として報告されます。TRAFFIC_JAM_HEAVY は使用されません。
road_segment_ids REPEATED STRING ルート沿いの道路区間（プレイス ID で表されます）
speed_reading_offsets REPEATED RECORD ルート全体の交通密度を表すオフセット ベースの速度読み取り間隔。各間隔は、ルートの開始地点からの距離オフセットで区切られます。速読の間隔をご覧ください。
speed_reading_offsets.start_offset NULLABLE INTEGER インターバルの開始（この値を含む）のルートの開始からの距離オフセット（メートル単位）
speed_reading_offsets.end_offset NULLABLE INTEGER 間隔の終了地点のルートの開始地点からの距離オフセット（メートル単位、この値は含まれない。次の間隔の start_offset と同じ）
speed_reading_offsets.speed NULLABLE STRING このインターバルの速度の分類。Google マップの交通状況レイヤの色と一致します。指定できる値: NORMAL（緑）、SLOW（黄）、TRAFFIC_JAM（赤）、TRAFFIC_JAM_HEAVY（濃い赤、2026 年 10 月 8 日より利用可能）

テーブルの動作と事実

  • テーブルは日単位でパーティション分割され、各パーティションに 60 日間の有効期限が設定されています。
  • テーブルは 1 時間ごとに更新され、最新の交通データがバッチで書き込まれます。
  • Roads Selection API で新しいルートが作成されると、このテーブルでデータが利用可能になるまでに最大 1 時間かかることがあります。
  • Routes Selection API からルートが削除されると、そのルートの新しいデータはこのテーブルに書き込まれなくなります。ただし、過去のデータは有効期限まで残ります。
  • ルートに沿った道路セグメントはトポロジ順に並び、常に接続されています。
  • speed_reading_offsets 列には、2026 年 10 月 8 日以降に記録された行の値が入力されます。前の行には空の配列があります。
  • 以前の speed_reading_intervals 列へのデータの入力は、2026 年 11 月 9 日以降に停止される可能性があります。代わりに speed_reading_offsets を使用してください。

routes_status 個のテーブル

このテーブルには、選択したルートのメタデータとステータス情報が含まれています。すべてのルートとステータスを簡単に確認できるようにすることを目的としています。他の 2 つのテーブルと結合して、データをフィルタできます。BigQuery のスキーマは次のとおりです。

名前 モード タイプ 説明
selected_route_id NULLABLE STRING selected_route_id のルート
display_name NULLABLE STRING ルートの表示名
status* NULLABLE STRING ルートのステータス
validation_error NULLABLE STRING ルートの検証エラー
low_road_usage_start_time NULLABLE TIMESTAMP 再検証中にルートの道路使用率が低いことが最初に確認された時刻。VALIDATION_ERROR_LOW_ROAD_USAGE に関連付けられています。
route_attributes NULLABLE STRING 選択したルートのカスタム属性

*この表のルート ステータスは STATE_ ではなく STATUS_ で始まります。それ以外は Roads Selection API と同じです。

テーブルの動作と事実

  • この表には、STATUS_RUNNING または STATUS_INVALID ステータスのルートのみが含まれます。
  • ルートのメタデータとステータスは 1 時間ごとに継続的に更新されます。
  • Roads Selection API で新しいルートが作成されると、この表にルートが表示されるまでに最大 1 時間ほどかかることがあります。
  • 道路選択 API からルートが削除されると、選択したルートがこのテーブルから削除されるまでに最大 1 時間かかることがあります。