本頁面提供用於訓練模型的 BigQuery 資料表指南，包括結構定義和欄位說明。您也會看到構成資料的核心概念 (快照、資產和觀測結果) 的細目，以及如何使用相關資料表的詳細資料。
資料表名稱會加上產品類型前置字元 (cropped_、full_frame_ 或 pano_)，且資料集只會顯示訂閱方案包含的產品資料表。結尾為 _all 的資料表包含所有快照的資料，結尾為 _latest 的資料表則僅包含最新快照的資料。只有在訂閱方案啟用光達時，資料集才會包含光達中繼資料表 (*_lidar_metadata_all 和 *_lidar_metadata_latest)。
核心概念
- 快照：資料集在特定時間點的固定、不可變更副本。
- 資產：現實世界中的物件，例如路標或電線桿。素材資源適用於裁切和全幅產品。
- 觀測：擷取事件的圖片記錄。對於裁剪和全幅產品，觀測結果是指偵測到資產，並包含該偵測作業的中繼資料，例如圖片擷取時間和相機位置。如果是全景產品，觀測項目是指 360 度拍攝的個別圖片影格，與資產無關。
- 光達中繼資料：與資產觀測資料相關聯的 3D 雷射點雲 (
.laz檔案) 中繼資料和 Cloud Storage 檔案位置。啟用 LiDAR 時，適用於裁剪和全幅產品，每個點雲都會在空間上裁剪到偵測到的資產周圍的即時 3D 區域。
snapshots
快照是資料集在特定時間點的固定、不可變更副本。快照資料表提供與快照相關聯的中繼資料，讓您大致瞭解資料的時間狀態。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
snapshot_id |
STRING | 快照的專屬 ID。做為彙整資料表的索引鍵。 |
subscription_id |
STRING | 訂閱項目的專屬 ID。 |
creation_time |
時間戳記 | 快照建立時間的時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
product_types |
ARRAY<STRING> | 與快照相關聯的產品類型。 有效值為 SV_CROPPED_ASSETS、SV_FULL_FRAME_ASSETS 和 SV_PANO。 |
cropped_observations_all
cropped_observations_all 資料表提供所有快照的裁剪資產觀測資料。您可以使用這個資料表，偵測不同快照之間的觀測值差異。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
snapshot_id |
STRING | 收集這項觀測資料的快照專屬 ID。 |
asset_id |
STRING | 與這項觀測資料相關聯的資產專屬 ID。 |
asset_type |
STRING | 資產的主要分類。 有效值為 ASSET_CLASS_ROAD_SIGN、ASSET_CLASS_UTILITY_POLE 和 ASSET_CLASS_MAINTENANCE_COVER。 |
location |
STRUCT | 包含經緯度座標 (浮點數) 的結構。觀測資料的擷取位置。 |
detection_time |
時間戳記 | 指定資產的最新觀測資料 capture_time。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
observation_id |
STRING | 用於識別觀測值的專屬字串。 |
bbox |
STRUCT | 包含 x/y 座標的結構體，用於對齊素材資源的定界框。 |
camera_pose |
STRUCT | 攝影機 LLA 和歐拉角的位置。包含經緯度、高度 (以公尺為單位)、俯仰角、航向和滾轉角 (以度為單位) 浮點數的結構。 |
capture_time |
時間戳記 | 觀測資料的擷取時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
pano_id |
STRING | 360 度拼接全景圖片的專屬 ID。這個值可為空值，不一定會顯示。如有，可做為 Google 地圖街景服務 Static API 的存取子金鑰。 |
gcs_uri |
STRING | 託管圖片的 Google Cloud Storage URI。 |
map_url |
STRING | 顯示資產位置的 Google 地圖網址。 |
cropped_assets_all
cropped_assets_all 資料表提供所有快照的裁剪資產。您可以使用這個資料表，偵測快照之間的資產差異。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
asset_id |
STRING | 資產的專屬 ID。 |
snapshot_id |
STRING | 收集這項資產的快照專屬 ID。 |
asset_type |
STRING | 資產的主要分類。 有效值為 ASSET_CLASS_ROAD_SIGN、ASSET_CLASS_UTILITY_POLE 和 ASSET_CLASS_MAINTENANCE_COVER。 |
location |
STRUCT | 包含經緯度座標的結構，以浮點數表示資產的大概位置。 |
detection_time |
時間戳記 | 指定資產的最新觀測資料 capture_time。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
cropped_lidar_metadata_all
cropped_lidar_metadata_all 資料表提供 LiDAR 點雲中繼資料，用於所有快照中裁剪的資產觀測資料。您可以使用這個資料表，偵測快照之間的 LiDAR 點雲差異。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
uri |
STRING | 託管壓縮光達點雲 (.laz) 檔案的 Google Cloud Storage URI (gs://...)。 |
observation_id |
STRING | 用於識別觀測值的專屬字串。 |
asset_id |
STRING | 與這項觀測資料相關聯的資產專屬 ID。 |
snapshot_id |
STRING | 收集這項觀測資料的快照專屬 ID。 |
device_number |
INT64 | 產生這個點雲的擷取車輛光學雷達感應器索引。多個光學雷達感應器可能會記錄同一個擷取事件的觀測資料。 |
device_specs |
STRUCT | 旋轉式光學雷達感應器的硬體規格。包含 shots_per_beam_rotation (INT64) 和 rotation_rate_hz (INT64) 的結構。 |
count_points |
INT64 | 點雲檔案中包含的 3D 雷射回傳點總數。 |
centroid_lat |
FLOAT64 | 點雲中所有雷射回波空間質心的 WGS84 緯度 (以度為單位)。 |
centroid_lon |
FLOAT64 | 點雲中所有雷射回波空間質心的 WGS84 經度 (以度為單位)。 |
start_time |
時間戳記 | 記錄光達掃描中第一個點的時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
end_time |
時間戳記 | 記錄光達掃描最終點的時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
cropped_observations_latest
cropped_observations_latest 資料表只會提供最新快照的裁剪資產觀測資料。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
snapshot_id |
STRING | 收集這項觀測資料的快照專屬 ID。 |
asset_id |
STRING | 與這項觀測資料相關聯的資產專屬 ID。 |
asset_type |
STRING | 資產的主要分類。 有效值為 ASSET_CLASS_ROAD_SIGN、ASSET_CLASS_UTILITY_POLE 和 ASSET_CLASS_MAINTENANCE_COVER。 |
location |
STRUCT | 包含經緯度座標 (浮點數) 的結構。觀測資料的擷取位置。 |
detection_time |
時間戳記 | 指定資產的最新觀測資料 capture_time。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
observation_id |
STRING | 用於識別觀測值的專屬字串。 |
bbox |
STRUCT | 包含 x/y 座標的結構體，用於對齊素材資源的定界框。 |
camera_pose |
STRUCT | 攝影機 LLA 和歐拉角的位置。包含經緯度、高度 (以公尺為單位)、俯仰角、航向和滾轉角 (以度為單位) 浮點數的結構。 |
capture_time |
時間戳記 | 觀測資料的擷取時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
pano_id |
STRING | 360 度拼接全景圖片的專屬 ID。這個值可為空值，不一定會顯示。如有，可做為 Google 地圖街景服務 Static API 的存取子金鑰。 |
gcs_uri |
STRING | 託管圖片的 Google Cloud Storage URI。 |
map_url |
STRING | 顯示資產位置的 Google 地圖網址。 |
cropped_assets_latest
cropped_assets_latest 資料表只會提供最新快照中的裁剪資產。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
asset_id |
STRING | 資產的專屬 ID。 |
snapshot_id |
STRING | 收集這項資產的快照專屬 ID。 |
asset_type |
STRING | 資產的主要分類。 有效值為 ASSET_CLASS_ROAD_SIGN、ASSET_CLASS_UTILITY_POLE 和 ASSET_CLASS_MAINTENANCE_COVER。 |
location |
STRUCT | 包含經緯度座標的結構，以浮點數表示資產的大概位置。 |
detection_time |
時間戳記 | 指定資產的最新觀測資料 capture_time。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
cropped_lidar_metadata_latest
cropped_lidar_metadata_latest 資料表提供 LiDAR 點雲中繼資料，僅限最新快照中裁剪資產觀測資料。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
uri |
STRING | 託管壓縮光達點雲 (.laz) 檔案的 Google Cloud Storage URI (gs://...)。 |
observation_id |
STRING | 用於識別觀測值的專屬字串。 |
asset_id |
STRING | 與這項觀測資料相關聯的資產專屬 ID。 |
snapshot_id |
STRING | 收集這項觀測資料的快照專屬 ID。 |
device_number |
INT64 | 產生這個點雲的擷取車輛光學雷達感應器索引。多個光學雷達感應器可能會記錄同一個擷取事件的觀測資料。 |
device_specs |
STRUCT | 旋轉式光學雷達感應器的硬體規格。包含 shots_per_beam_rotation (INT64) 和 rotation_rate_hz (INT64) 的結構。 |
count_points |
INT64 | 點雲檔案中包含的 3D 雷射回傳點總數。 |
centroid_lat |
FLOAT64 | 點雲中所有雷射回波空間質心的 WGS84 緯度 (以度為單位)。 |
centroid_lon |
FLOAT64 | 點雲中所有雷射回波空間質心的 WGS84 經度 (以度為單位)。 |
start_time |
時間戳記 | 記錄光達掃描中第一個點的時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
end_time |
時間戳記 | 記錄光達掃描最終點的時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
full_frame_observations_all
full_frame_observations_all 資料表提供所有快照的全幅 (未裁剪) 資產觀測資料。您可以使用這個表格，偵測不同快照之間的觀測值差異。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
snapshot_id |
STRING | 收集這項觀測資料的快照專屬 ID。 |
asset_id |
STRING | 與這項觀測資料相關聯的資產專屬 ID。 |
asset_type |
STRING | 資產的主要分類。 有效值為 ASSET_CLASS_ROAD_SIGN、ASSET_CLASS_UTILITY_POLE 和 ASSET_CLASS_MAINTENANCE_COVER。 |
location |
STRUCT | 包含經緯度座標 (浮點數) 的結構。觀測資料的擷取位置。 |
detection_time |
時間戳記 | 指定資產的最新觀測資料 capture_time。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
observation_id |
STRING | 用於識別觀測值的專屬字串。 |
bbox |
STRUCT | 包含 x/y 座標的結構體，用於對齊素材資源的定界框。 |
camera_pose |
STRUCT | 攝影機 LLA 和歐拉角的位置。包含經緯度、高度 (以公尺為單位)、俯仰角、航向和滾轉角 (以度為單位) 浮點數的結構。 |
capture_time |
時間戳記 | 觀測資料的擷取時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
pano_id |
STRING | 360 度拼接全景圖片的專屬 ID。這個值可為空值，不一定會顯示。如有，可做為 Google 地圖街景服務 Static API 的存取子金鑰。 |
gcs_uri |
STRING | 託管圖片的 Google Cloud Storage URI。 |
map_url |
STRING | 顯示資產位置的 Google 地圖網址。 |
full_frame_assets_all
full_frame_assets_all 資料表提供所有快照的全幅 (未裁剪) 素材資源。您可以使用這個資料表，偵測不同快照之間的資產差異。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
asset_id |
STRING | 資產的專屬 ID。 |
snapshot_id |
STRING | 收集這項資產的快照專屬 ID。 |
asset_type |
STRING | 資產的主要分類。 有效值為 ASSET_CLASS_ROAD_SIGN、ASSET_CLASS_UTILITY_POLE 和 ASSET_CLASS_MAINTENANCE_COVER。 |
location |
STRUCT | 包含經緯度座標的結構，以浮點數表示資產的大概位置。 |
detection_time |
時間戳記 | 指定資產的最新觀測資料 capture_time。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
full_frame_lidar_metadata_all
full_frame_lidar_metadata_all 資料表提供 LiDAR 點雲中繼資料，用於所有快照的全影格 (未裁剪) 資產觀測。您可以使用這個資料表，偵測不同快照之間的 LiDAR 點雲差異。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
uri |
STRING | 託管壓縮光達點雲 (.laz) 檔案的 Google Cloud Storage URI (gs://...)。 |
observation_id |
STRING | 用於識別觀測值的專屬字串。 |
asset_id |
STRING | 與這項觀測資料相關聯的資產專屬 ID。 |
snapshot_id |
STRING | 收集這項觀測資料的快照專屬 ID。 |
device_number |
INT64 | 產生這個點雲的擷取車輛光學雷達感應器索引。多個光學雷達感應器可能會記錄同一個擷取事件的觀測資料。 |
device_specs |
STRUCT | 旋轉式光學雷達感應器的硬體規格。包含 shots_per_beam_rotation (INT64) 和 rotation_rate_hz (INT64) 的結構。 |
count_points |
INT64 | 點雲檔案中包含的 3D 雷射回傳點總數。 |
centroid_lat |
FLOAT64 | 點雲中所有雷射回波空間質心的 WGS84 緯度 (以度為單位)。 |
centroid_lon |
FLOAT64 | 點雲中所有雷射回波空間質心的 WGS84 經度 (以度為單位)。 |
start_time |
時間戳記 | 記錄光達掃描中第一個點的時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
end_time |
時間戳記 | 記錄光達掃描最終點的時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
full_frame_observations_latest
full_frame_observations_latest 資料表僅提供最新快照的全幅 (未裁剪) 資產觀測資料。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
snapshot_id |
STRING | 收集這項觀測資料的快照專屬 ID。 |
asset_id |
STRING | 與這項觀測資料相關聯的資產專屬 ID。 |
asset_type |
STRING | 資產的主要分類。 有效值為 ASSET_CLASS_ROAD_SIGN、ASSET_CLASS_UTILITY_POLE 和 ASSET_CLASS_MAINTENANCE_COVER。 |
location |
STRUCT | 包含經緯度座標 (浮點數) 的結構。觀測資料的擷取位置。 |
detection_time |
時間戳記 | 指定資產的最新觀測資料 capture_time。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
observation_id |
STRING | 用於識別觀測值的專屬字串。 |
bbox |
STRUCT | 包含 x/y 座標的結構體，用於對齊素材資源的定界框。 |
camera_pose |
STRUCT | 攝影機 LLA 和歐拉角的位置。包含經緯度、高度 (以公尺為單位)、俯仰角、航向和滾轉角 (以度為單位) 浮點數的結構。 |
capture_time |
時間戳記 | 觀測資料的擷取時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
pano_id |
STRING | 360 度拼接全景圖片的專屬 ID。這個值可為空值，不一定會顯示。如有，可做為 Google 地圖街景服務 Static API 的存取子金鑰。 |
gcs_uri |
STRING | 託管圖片的 Google Cloud Storage URI。 |
map_url |
STRING | 顯示資產位置的 Google 地圖網址。 |
full_frame_assets_latest
full_frame_assets_latest 資料表只會提供最新快照中的全幅 (未裁剪) 素材資源。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
asset_id |
STRING | 資產的專屬 ID。 |
snapshot_id |
STRING | 收集這項資產的快照專屬 ID。 |
asset_type |
STRING | 資產的主要分類。 有效值為 ASSET_CLASS_ROAD_SIGN、ASSET_CLASS_UTILITY_POLE 和 ASSET_CLASS_MAINTENANCE_COVER。 |
location |
STRUCT | 包含經緯度座標的結構，以浮點數表示資產的大概位置。 |
detection_time |
時間戳記 | 指定資產的最新觀測資料 capture_time。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
full_frame_lidar_metadata_latest
full_frame_lidar_metadata_latest 資料表提供 LiDAR 點雲中繼資料，僅適用於最新快照的全幅 (未裁剪) 資產觀測資料。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
uri |
STRING | 託管壓縮光達點雲 (.laz) 檔案的 Google Cloud Storage URI (gs://...)。 |
observation_id |
STRING | 用於識別觀測值的專屬字串。 |
asset_id |
STRING | 與這項觀測資料相關聯的資產專屬 ID。 |
snapshot_id |
STRING | 收集這項觀測資料的快照專屬 ID。 |
device_number |
INT64 | 產生這個點雲的擷取車輛光學雷達感應器索引。多個光學雷達感應器可能會記錄同一個擷取事件的觀測資料。 |
device_specs |
STRUCT | 旋轉式光學雷達感應器的硬體規格。包含 shots_per_beam_rotation (INT64) 和 rotation_rate_hz (INT64) 的結構。 |
count_points |
INT64 | 點雲檔案中包含的 3D 雷射回傳點總數。 |
centroid_lat |
FLOAT64 | 點雲中所有雷射回波空間質心的 WGS84 緯度 (以度為單位)。 |
centroid_lon |
FLOAT64 | 點雲中所有雷射回波空間質心的 WGS84 經度 (以度為單位)。 |
start_time |
時間戳記 | 記錄光達掃描中第一個點的時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
end_time |
時間戳記 | 記錄光達掃描最終點的時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
pano_observations_all
pano_observations_all 表格提供所有快照的全景 (完整場景) 觀測資料。與資產觀測不同，全景觀測包含 360 度擷取事件的影格層級相機中繼資料和空間方向，而非局部資產偵測。您可以使用這個表格，偵測快照之間全景觀測結果的差異。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
capture_id |
STRING | 代表單一全景拍攝事件的專屬 ID。 |
observation_id |
STRING | 個別圖片影格的專屬 ID，用於構成 360 度全景拍攝的單一區隔。 |
snapshot_id |
STRING | 收集這項觀測資料的快照專屬 ID。 |
capture_location |
STRUCT | Struct 包含經緯度座標 (以浮點數表示)，代表擷取觀測資料時車輛的中心點。 |
capture_time |
時間戳記 | 觀測資料的擷取時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
camera_pose |
STRUCT | 攝影機 LLA 和歐拉角的位置。包含經緯度、高度 (以公尺為單位)、俯仰角、航向和滾轉角 (以度為單位) 浮點數的結構。 |
gcs_uri |
STRING | 託管圖片的 Google Cloud Storage URI。 |
map_url |
STRING | 顯示觀察記錄拍攝位置的 Google 地圖網址。 |
pano_id |
STRING | 360 度拼接全景圖片的專屬 ID。這個值可為空值，不一定會顯示。如有，可做為 Google 地圖街景服務 Static API 的存取子金鑰。 |
pano_observations_latest
pano_observations_latest 資料表僅提供最新快照的全景 (完整場景) 觀測資料。
| 資料欄名稱 | 類型 | 說明 |
|---|---|---|
capture_id |
STRING | 代表單一全景拍攝事件的專屬 ID。 |
observation_id |
STRING | 個別圖片影格的專屬 ID，用於構成 360 度全景拍攝的單一區隔。 |
snapshot_id |
STRING | 收集這項觀測資料的快照專屬 ID。 |
capture_location |
STRUCT | Struct 包含經緯度座標 (以浮點數表示)，代表擷取觀測資料時車輛的中心點。 |
capture_time |
時間戳記 | 觀測資料的擷取時間戳記。ISO 8601 格式的時間戳記，例如 2019-09-25 17:26:27.757171 UTC。 |
camera_pose |
STRUCT | 攝影機 LLA 和歐拉角的位置。包含經緯度、高度 (以公尺為單位)、俯仰角、航向和滾轉角 (以度為單位) 浮點數的結構。 |
gcs_uri |
STRING | 託管圖片的 Google Cloud Storage URI。 |
map_url |
STRING | 顯示觀察記錄拍攝位置的 Google 地圖網址。 |
pano_id |
STRING | 360 度拼接全景圖片的專屬 ID。這個值可為空值，不一定會顯示。如有，可做為 Google 地圖街景服務 Static API 的存取子金鑰。 |