蓄積された道路データ

累積道路データとは、選択したルートについて、時間の経過とともに蓄積できるデータのことです。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 交通状況を考慮したルートの所要時間。has_road_closure が true の場合は省略（NULL）。
static_duration_in_seconds NULLABLE FLOAT 交通状況を考慮しないルートの所要時間
route_geometry NULLABLE 地域 交通状況を考慮したルートのポリライン ジオメトリ
road_segment_ids REPEATED STRING ルート沿いの道路セグメント（プレイス ID として表される）
has_road_closure NULLABLE BOOLEAN ルート上に完全な通行止めがあるかどうか。true の場合、ルートが通行不能であるため、duration_in_seconds は省略されます（NULL）。NULL の値は、道路閉鎖情報が未確定であることを示します。

テーブルの動作とファクト

  • テーブルは日単位でパーティション分割され、各パーティションには 10 年の有効期限が設定されています。
  • このテーブルは、バッチで書き込まれた最新のトラフィック データで 1 時間ごとに更新されます。
  • Roads Selection API で新しいルートが作成されてから、このテーブルでデータが利用可能になるまで、最大 1 時間ほどかかります。
  • Roads Selection API からルートが削除されると、そのルートの新しいデータはこのテーブルに書き込まれません。ただし、過去のデータは有効期限が切れるまで保持されます。
  • ルートに沿った道路セグメントはトポロジ順に並んでおり、常に接続されています。
  • has_road_closure フラグは、Google マップの道路の完全な通行止めステータスと一致します。

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 交通状況を考慮したルートの所要時間。has_road_closure が true の場合は省略（NULL）。
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 ルート全体の交通密度を表す、オフセットベースの速度読み取り間隔。各間隔は、ルートの開始地点からの距離オフセットによって区切られます。has_road_closure が true の場合は省略されます。速度の読み取り間隔をご覧ください。
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 日より利用可能）
has_road_closure NULLABLE BOOLEAN ルート上に完全な通行止めがあるかどうか。true の場合、ルートが通行不能であるため、duration_in_seconds と speed_reading_offsets は省略されます。NULL の値は、道路閉鎖情報が未確定であることを示します。

テーブルの動作とファクト

  • テーブルは日単位でパーティショニングされ、各パーティションに 60 日間の有効期限が設定されています。
  • このテーブルは、バッチで書き込まれた最新のトラフィック データで 1 時間ごとに更新されます。
  • Roads Selection API で新しいルートが作成されてから、このテーブルでデータが利用可能になるまで、最大 1 時間ほどかかります。
  • Roads Selection API からルートが削除されると、そのルートの新しいデータはこのテーブルに書き込まれなくなります。ただし、過去のデータは有効期限が切れるまで保持されます。
  • ルートに沿った道路セグメントはトポロジ順に並んでおり、常に接続されています。
  • speed_reading_offsets 列には、2026 年 10 月 8 日以降に記録された行が入力されます。前の行には空の配列があります。
  • 以前の speed_reading_intervals 列は、2026 年 11 月 9 日以降にデータが入力されなくなる可能性があります。代わりに speed_reading_offsets を使用してください。
  • has_road_closure フラグは、Google マップの道路の完全な通行止めステータスと一致します。

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 選択したルートのカスタム属性
dynamic_routing NULLABLE BOOLEAN ルートが動的（true）か固定（false）かを示します。dynamicRouting をご覧ください。
origin NULLABLE 地域 ルートの出発地のウェイポイント
destination NULLABLE 地域 ルートの目的地のウェイポイント
中間体 REPEATED 地域 ルートの中間ウェイポイント
static_route_geometry NULLABLE 地域 ウェイポイントからライブ交通情報なしで計算された静的ルートのポリライン ジオメトリ
road_segment_ids REPEATED STRING ライブ トラフィックなしで計算された静的ルートに沿った道路セグメント（プレイス ID として表されます）

テーブルの動作とファクト

  • このテーブルには、STATUS_RUNNING または STATUS_INVALID ステータスのルートのみが含まれます。
  • ルートのメタデータとステータスは、1 時間ごとに更新されます。
  • Roads Selection API で新しいルートが作成されてから、このテーブルにルートが表示されるまで、最大 1 時間かかることがあります。
  • Roads Selection API からルートが削除されると、選択したルートがこのテーブルから削除されるまでに最大 1 時間かかることがあります。
  • 固定ルート（dynamic_routing: false）の場合、road_segment_ids のプレイス ID は、Google の道路ネットワークの変更を反映して自動的に更新されますが、同じルートを表します。動的ルート（dynamic_routing: true）の場合、road_segment_ids は更新されません。