このページでは、モデルのトレーニングに使用される BigQuery テーブルのガイドを提供します。スキーマとフィールドの説明も含まれています。また、データを構成するスナップショット、アセット、観測というコアコンセプトの内訳と、必要に応じてテーブルを使用する方法の詳細についても説明します。
snapshots
スナップショットは、特定の時点におけるデータセットの固定された変更不可能なコピーです。スナップショット テーブルには、スナップショットに関連付けられたメタデータが用意されており、データの時間的状態を大まかに把握できます。
| 列名 | タイプ | 説明 |
|---|---|---|
snapshot_id |
STRING | スナップショットの一意の識別子。テーブルを結合するためのキーとして使用されます。 |
subscription_id |
STRING | サブスクリプションの一意の識別子。 |
creation_time |
TIMESTAMP |
スナップショットが最初に作成されたときのタイムスタンプ。ISO 8601 形式のタイムスタンプ（例: 2019-09-25 17:26:27.757171 UTC）。
|
all_observations
「観測」とは、現実世界のアセットの検出のことです。観測はアセットとは異なり、アセットの検出に関するメタデータ（画像の撮影時刻やカメラの位置など）が含まれています。
all_observations テーブルには、すべてのスナップショットからの観測が用意されています。このテーブルを使用して、スナップショット間の観測の違いを検出できます。
| 列名 | タイプ | 説明 |
|---|---|---|
observation_id |
STRING | 観測を一意に識別する文字列。 |
snapshot_id |
STRING | この観測を収集したスナップショットの一意の識別子。 |
asset_id |
STRING | この観測に関連付けられたアセットの一意の識別子。 |
asset_type |
STRING | アセットの主な分類。 有効な値は ASSET_CLASS_ROAD_SIGN と ASSET_CLASS_UTILITY_POLE です。 |
location |
STRUCT | 緯度/経度座標を浮動小数点数として含む構造体。 |
capture_time |
TIMESTAMP |
観測が最初にキャプチャされたときのタイムスタンプ。ISO 8601 形式のタイムスタンプ（例: 2019-09-25 17:26:27.757171 UTC）。
|
detection_time |
TIMESTAMP |
アセットが最初に検出されたときのタイムスタンプ。ISO 8601 形式のタイムスタンプ（例: 2019-09-25 17:26:27.757171 UTC）。
|
bbox |
STRUCT | アセットの境界ボックスを揃える x/y 座標を含む構造体の構造体。 |
camera_pose |
STRUCT | カメラの LLA とオイラー角の位置。緯度/経度、高度（メートル単位）、ピッチ、方角、ロールの浮動小数点数を含む構造体。 |
gcs_uri |
STRING | 画像がホストされている Google Cloud Storage URI。 |
map_url |
STRING | 観測の位置を示す Google マップの URL。 |
pano_id |
STRING | 360 度のスティッチ パノラマ画像の一意の識別子。この値は null 許容です。存在しない可能性があります。存在する場合は、Google マップ ストリートビュー Static API のアクセサ キーとして使用できます。 |
all_assets
「アセット」とは、現実世界のオブジェクトのことです。all_assets テーブルには、すべてのスナップショットからのアセットが用意されています。このテーブルを使用して、スナップショット間のアセットの違いを検出できます。
| 列名 | タイプ | 説明 |
|---|---|---|
asset_id |
STRING | この観測に関連付けられたアセットの一意の識別子。 |
snapshot_id |
STRING | この観測を収集したスナップショットの一意の識別子。 |
asset_type |
STRING | アセットの主な分類。 有効な値は ASSET_CLASS_ROAD_SIGN と ASSET_CLASS_UTILITY_POLE です。 |
observation_id |
STRING | 観測を一意に識別する文字列。 |
location |
STRUCT | 緯度/経度座標を浮動小数点数として含む構造体。 |
detection_time |
TIMESTAMP |
アセットが最初に検出されたときのタイムスタンプ。ISO 8601 形式のタイムスタンプ（例: 2019-09-25 17:26:27.757171 UTC）。
|
latest_observations
latest_observations テーブルには、最新のスナップショットからの観測のみが用意されています。
| 列名 | タイプ | 説明 |
|---|---|---|
observation_id |
STRING | 観測を一意に識別する文字列。 |
snapshot_id |
STRING | この観測を収集したスナップショットの一意の識別子。 |
asset_id |
STRING | この観測に関連付けられたアセットの一意の識別子。 |
asset_type |
STRING | アセットの主な分類。 有効な値は ASSET_CLASS_ROAD_SIGN と ASSET_CLASS_UTILITY_POLE です。 |
location |
STRUCT | 緯度/経度座標を浮動小数点数として含む構造体。 |
capture_time |
TIMESTAMP |
観測が最初にキャプチャされたときのタイムスタンプ。ISO 8601 形式のタイムスタンプ（例: 2019-09-25 17:26:27.757171 UTC）。
|
detection_time |
TIMESTAMP |
アセットが最初に検出されたときのタイムスタンプ。ISO 8601 形式のタイムスタンプ（例: 2019-09-25 17:26:27.757171 UTC）。
|
bbox |
STRUCT | アセットの境界ボックスを揃える x/y 座標を含む構造体の構造体。 |
camera_pose |
STRUCT | カメラの LLA とオイラー角の位置。緯度/経度、高度（メートル単位）、ピッチ、方角、ロールの浮動小数点数を含む構造体。 |
gcs_uri |
STRING | 画像がホストされている Google Cloud Storage URI。 |
map_url |
STRING | 観測の位置を示す Google マップの URL。 |
pano_id |
STRING | 360 度のスティッチ パノラマ画像の一意の識別子。この値は null 許容です。存在しない可能性があります。存在する場合は、Google マップ ストリートビュー Static API のアクセサ キーとして使用できます。 |
latest_assets
latest_assets テーブルには、最新のスナップショットからのアセットのみが用意されています。
| 列名 | タイプ | 説明 |
|---|---|---|
asset_id |
STRING | この観測に関連付けられたアセットの一意の識別子。 |
snapshot_id |
STRING | この観測を収集したスナップショットの一意の識別子。 |
asset_type |
STRING | アセットの主な分類。 有効な値は ASSET_CLASS_ROAD_SIGN と ASSET_CLASS_UTILITY_POLE です。 |
observation_id |
STRING | 観測を一意に識別する文字列。 |
location |
STRUCT | 緯度/経度座標を浮動小数点数として含む構造体。 |
detection_time |
TIMESTAMP |
アセットが最初に検出されたときのタイムスタンプ。ISO 8601 形式のタイムスタンプ（例: 2019-09-25 17:26:27.757171 UTC）。
|