Riferimento

Questa pagina fornisce una guida alle tabelle BigQuery utilizzate per l'addestramento dei modelli, inclusi i relativi schemi e le descrizioni dei campi. Troverai anche una suddivisione dei concetti fondamentali (snapshot, asset e osservazioni) che strutturano i dati, oltre a dettagli su come utilizzare le tabelle, se pertinente.

I nomi delle tabelle sono preceduti dal tipo di prodotto (cropped_, full_frame_ o pano_) e nel set di dati sono presenti solo le tabelle dei prodotti inclusi nei tuoi abbonamenti. Le tabelle che terminano con _all includono i dati di tutti gli snapshot, mentre quelle che terminano con _latest includono solo i dati dello snapshot più recente. Le tabelle dei metadati LiDAR (*_lidar_metadata_all e *_lidar_metadata_latest) sono incluse nel set di dati solo se LiDAR è attivato per il tuo abbonamento.

Concetti principali

  • Snapshot: una copia fissa e immutabile di un set di dati in un momento specifico.
  • Asset: un oggetto nel mondo reale, ad esempio un segnale stradale o un palo della luce. Gli asset sono disponibili per i prodotti con sensore ritagliato e full frame.
  • Osservazione: un record di immagini di un evento di acquisizione. Per i prodotti ritagliati e full-frame, un'osservazione è un rilevamento di un asset e contiene i metadati relativi a quel rilevamento, ad esempio l'ora in cui è stata acquisita l'immagine e la posizione della fotocamera. Per il prodotto panoramico, un'osservazione è un singolo fotogramma di un'acquisizione a 360 gradi e non è associata a un asset.
  • Metadati LiDAR: metadati e posizioni dei file Cloud Storage per le nuvole di punti laser 3D (file .laz) associate alle osservazioni degli asset. Disponibile per i prodotti ritagliati e full-frame quando LiDAR è abilitato, ogni nuvola di punti viene ritagliata spazialmente nella regione 3D immediata che circonda un asset rilevato.

snapshots

Uno snapshot è una copia fissa e immutabile di un set di dati in un momento specifico. La tabella degli snapshot fornisce i metadati associati agli snapshot, per consentirti di comprendere lo stato temporale dei dati a un livello generale.

Nome colonna Tipo Descrizione
snapshot_id STRING Identificatore univoco dello snapshot. Utilizzato come chiave per unire le tabelle.
subscription_id STRING Identificatore univoco dell'abbonamento.
creation_time TIMESTAMP Timestamp della creazione dello snapshot. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
product_types ARRAY<STRINGA> I tipi di prodotto associati allo snapshot.
I valori validi sono SV_CROPPED_ASSETS, SV_FULL_FRAME_ASSETS e SV_PANO.

cropped_observations_all

La tabella cropped_observations_all fornisce osservazioni degli asset ritagliati da tutti gli snapshot. Puoi utilizzare questa tabella per rilevare le differenze nelle osservazioni tra gli snapshot.

Nome colonna Tipo Descrizione
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa osservazione.
asset_id STRING Identificatore univoco della risorsa associata a questa osservazione.
asset_type STRING Classificazione principale dell'asset.
I valori validi sono ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE e ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Struct contenente le coordinate di latitudine/longitudine come valori float. La località in cui è stata acquisita l'osservazione.
detection_time TIMESTAMP L'osservazione più recente capture_time per l'asset specificato. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
observation_id STRING Stringa che identifica in modo univoco l'osservazione.
bbox STRUCT Struttura di strutture contenenti le coordinate x/y che allineano il riquadro di delimitazione dell'asset.
camera_pose STRUCT La posizione della fotocamera LLA e gli angoli di Eulero. Struct contenente valori float per latitudine/longitudine, altitudine (in metri), inclinazione, direzione e rollio (in gradi).
capture_time TIMESTAMP Timestamp di quando è stata acquisita l'osservazione. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
pano_id STRING Identificatore univoco di un'immagine panoramica unita a 360 gradi. Questo valore è nullable; potrebbe non essere presente. Se presente, può essere utilizzata come chiave di accesso con l'API Google Maps Street View Static.
gcs_uri STRING URI Google Cloud Storage in cui è ospitata l'immagine.
map_url STRING URL di Google Maps che mostra la posizione dell'asset.

cropped_assets_all

La tabella cropped_assets_all fornisce asset ritagliati da tutti gli snapshot. Puoi utilizzare questa tabella per rilevare le differenze negli asset tra gli snapshot.

Nome colonna Tipo Descrizione
asset_id STRING Identificatore univoco della risorsa.
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa risorsa.
asset_type STRING Classificazione principale dell'asset.
I valori validi sono ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE e ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Struct contenente le coordinate di latitudine/longitudine come valori float che rappresentano la posizione approssimativa dell'asset.
detection_time TIMESTAMP L'osservazione più recente capture_time per l'asset specificato. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.

cropped_lidar_metadata_all

La tabella cropped_lidar_metadata_all fornisce i metadati della nuvola di punti LiDAR per le osservazioni degli asset ritagliati da tutti gli snapshot. Puoi utilizzare questa tabella per rilevare le differenze nelle nuvole di punti LiDAR tra gli snapshot.

Nome colonna Tipo Descrizione
uri STRING URI Google Cloud Storage (gs://...) in cui è ospitato il file della nuvola di punti LiDAR compressa (.laz).
observation_id STRING Stringa che identifica in modo univoco l'osservazione.
asset_id STRING Identificatore univoco della risorsa associata a questa osservazione.
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa osservazione.
device_number INT64 Indice del sensore LiDAR sul veicolo di acquisizione che ha prodotto questa nuvola di punti. Più sensori LiDAR possono registrare osservazioni per lo stesso evento di acquisizione.
device_specs STRUCT Specifiche hardware del sensore LiDAR rotante. Struct contenente shots_per_beam_rotation (INT64) e rotation_rate_hz (INT64).
count_points INT64 Numero totale di punti di ritorno laser 3D contenuti nel file della nuvola di punti.
centroid_lat FLOAT64 Latitudine WGS84 (in gradi) del baricentro spaziale di tutti i ritorni laser nella nuvola di punti.
centroid_lon FLOAT64 Longitudine WGS84 (in gradi) del baricentro spaziale di tutti i ritorni laser nella nuvola di punti.
start_time TIMESTAMP Timestamp di quando è stato registrato il primo punto nella scansione LiDAR. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
end_time TIMESTAMP Timestamp di registrazione del punto finale della scansione LiDAR. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.

cropped_observations_latest

La tabella cropped_observations_latest fornisce osservazioni sugli asset ritagliati solo dallo snapshot più recente.

Nome colonna Tipo Descrizione
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa osservazione.
asset_id STRING Identificatore univoco della risorsa associata a questa osservazione.
asset_type STRING Classificazione principale dell'asset.
I valori validi sono ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE e ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Struct contenente le coordinate di latitudine/longitudine come valori float. La località in cui è stata acquisita l'osservazione.
detection_time TIMESTAMP L'osservazione più recente capture_time per l'asset specificato. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
observation_id STRING Stringa che identifica in modo univoco l'osservazione.
bbox STRUCT Struttura di strutture contenenti le coordinate x/y che allineano il riquadro di delimitazione dell'asset.
camera_pose STRUCT La posizione della fotocamera LLA e gli angoli di Eulero. Struct contenente valori float per latitudine/longitudine, altitudine (in metri), inclinazione, direzione e rollio (in gradi).
capture_time TIMESTAMP Timestamp di quando è stata acquisita l'osservazione. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
pano_id STRING Identificatore univoco di un'immagine panoramica unita a 360 gradi. Questo valore è nullable; potrebbe non essere presente. Se presente, può essere utilizzata come chiave di accesso con l'API Google Maps Street View Static.
gcs_uri STRING URI Google Cloud Storage in cui è ospitata l'immagine.
map_url STRING URL di Google Maps che mostra la posizione dell'asset.

cropped_assets_latest

La tabella cropped_assets_latest fornisce asset ritagliati solo dallo snapshot più recente.

Nome colonna Tipo Descrizione
asset_id STRING Identificatore univoco della risorsa.
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa risorsa.
asset_type STRING Classificazione principale dell'asset.
I valori validi sono ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE e ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Struct contenente le coordinate di latitudine/longitudine come valori float che rappresentano la posizione approssimativa dell'asset.
detection_time TIMESTAMP L'osservazione più recente capture_time per l'asset specificato. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.

cropped_lidar_metadata_latest

La tabella cropped_lidar_metadata_latest fornisce i metadati della nuvola di punti LiDAR per le osservazioni degli asset ritagliati solo dall'istantanea più recente.

Nome colonna Tipo Descrizione
uri STRING URI Google Cloud Storage (gs://...) in cui è ospitato il file della nuvola di punti LiDAR compressa (.laz).
observation_id STRING Stringa che identifica in modo univoco l'osservazione.
asset_id STRING Identificatore univoco della risorsa associata a questa osservazione.
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa osservazione.
device_number INT64 Indice del sensore LiDAR sul veicolo di acquisizione che ha prodotto questa nuvola di punti. Più sensori LiDAR possono registrare osservazioni per lo stesso evento di acquisizione.
device_specs STRUCT Specifiche hardware del sensore LiDAR rotante. Struct contenente shots_per_beam_rotation (INT64) e rotation_rate_hz (INT64).
count_points INT64 Numero totale di punti di ritorno laser 3D contenuti nel file della nuvola di punti.
centroid_lat FLOAT64 Latitudine WGS84 (in gradi) del baricentro spaziale di tutti i ritorni laser nella nuvola di punti.
centroid_lon FLOAT64 Longitudine WGS84 (in gradi) del baricentro spaziale di tutti i ritorni laser nella nuvola di punti.
start_time TIMESTAMP Timestamp di quando è stato registrato il primo punto nella scansione LiDAR. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
end_time TIMESTAMP Timestamp di registrazione del punto finale della scansione LiDAR. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.

full_frame_observations_all

La tabella full_frame_observations_all fornisce osservazioni degli asset a frame intero (non ritagliati) da tutti gli snapshot. Puoi utilizzare questa tabella per rilevare le differenze nelle osservazioni tra gli snapshot.

Nome colonna Tipo Descrizione
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa osservazione.
asset_id STRING Identificatore univoco della risorsa associata a questa osservazione.
asset_type STRING Classificazione principale dell'asset.
I valori validi sono ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE e ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Struct contenente le coordinate di latitudine/longitudine come valori float. La località in cui è stata acquisita l'osservazione.
detection_time TIMESTAMP L'osservazione più recente capture_time per l'asset specificato. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
observation_id STRING Stringa che identifica in modo univoco l'osservazione.
bbox STRUCT Struttura di strutture contenenti le coordinate x/y che allineano il riquadro di delimitazione dell'asset.
camera_pose STRUCT La posizione della fotocamera LLA e gli angoli di Eulero. Struct contenente valori float per latitudine/longitudine, altitudine (in metri), inclinazione, direzione e rollio (in gradi).
capture_time TIMESTAMP Timestamp di quando è stata acquisita l'osservazione. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
pano_id STRING Identificatore univoco di un'immagine panoramica unita a 360 gradi. Questo valore è nullable; potrebbe non essere presente. Se presente, può essere utilizzata come chiave di accesso con l'API Google Maps Street View Static.
gcs_uri STRING URI Google Cloud Storage in cui è ospitata l'immagine.
map_url STRING URL di Google Maps che mostra la posizione dell'asset.

full_frame_assets_all

La tabella full_frame_assets_all fornisce asset a frame intero (non ritagliati) di tutti gli snapshot. Puoi utilizzare questa tabella per rilevare le differenze negli asset tra gli snapshot.

Nome colonna Tipo Descrizione
asset_id STRING Identificatore univoco della risorsa.
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa risorsa.
asset_type STRING Classificazione principale dell'asset.
I valori validi sono ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE e ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Struct contenente le coordinate di latitudine/longitudine come valori float che rappresentano la posizione approssimativa dell'asset.
detection_time TIMESTAMP L'osservazione più recente capture_time per l'asset specificato. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.

full_frame_lidar_metadata_all

La tabella full_frame_lidar_metadata_all fornisce i metadati della nuvola di punti LiDAR per le osservazioni degli asset a frame intero (non ritagliati) di tutte le istantanee. Puoi utilizzare questa tabella per rilevare le differenze nelle nuvole di punti LiDAR tra gli snapshot.

Nome colonna Tipo Descrizione
uri STRING URI Google Cloud Storage (gs://...) in cui è ospitato il file della nuvola di punti LiDAR compressa (.laz).
observation_id STRING Stringa che identifica in modo univoco l'osservazione.
asset_id STRING Identificatore univoco della risorsa associata a questa osservazione.
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa osservazione.
device_number INT64 Indice del sensore LiDAR sul veicolo di acquisizione che ha prodotto questa nuvola di punti. Più sensori LiDAR possono registrare osservazioni per lo stesso evento di acquisizione.
device_specs STRUCT Specifiche hardware del sensore LiDAR rotante. Struct contenente shots_per_beam_rotation (INT64) e rotation_rate_hz (INT64).
count_points INT64 Numero totale di punti di ritorno laser 3D contenuti nel file della nuvola di punti.
centroid_lat FLOAT64 Latitudine WGS84 (in gradi) del baricentro spaziale di tutti i ritorni laser nella nuvola di punti.
centroid_lon FLOAT64 Longitudine WGS84 (in gradi) del baricentro spaziale di tutti i ritorni laser nella nuvola di punti.
start_time TIMESTAMP Timestamp di quando è stato registrato il primo punto nella scansione LiDAR. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
end_time TIMESTAMP Timestamp di registrazione del punto finale della scansione LiDAR. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.

full_frame_observations_latest

La tabella full_frame_observations_latest fornisce osservazioni degli asset a frame intero (non ritagliati) solo dallo snapshot più recente.

Nome colonna Tipo Descrizione
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa osservazione.
asset_id STRING Identificatore univoco della risorsa associata a questa osservazione.
asset_type STRING Classificazione principale dell'asset.
I valori validi sono ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE e ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Struct contenente le coordinate di latitudine/longitudine come valori float. La località in cui è stata acquisita l'osservazione.
detection_time TIMESTAMP L'osservazione più recente capture_time per l'asset specificato. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
observation_id STRING Stringa che identifica in modo univoco l'osservazione.
bbox STRUCT Struttura di strutture contenenti le coordinate x/y che allineano il riquadro di delimitazione dell'asset.
camera_pose STRUCT La posizione della fotocamera LLA e gli angoli di Eulero. Struct contenente valori float per latitudine/longitudine, altitudine (in metri), inclinazione, direzione e rollio (in gradi).
capture_time TIMESTAMP Timestamp di quando è stata acquisita l'osservazione. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
pano_id STRING Identificatore univoco di un'immagine panoramica unita a 360 gradi. Questo valore è nullable; potrebbe non essere presente. Se presente, può essere utilizzata come chiave di accesso con l'API Google Maps Street View Static.
gcs_uri STRING URI Google Cloud Storage in cui è ospitata l'immagine.
map_url STRING URL di Google Maps che mostra la posizione dell'asset.

full_frame_assets_latest

La tabella full_frame_assets_latest fornisce asset full-frame (non ritagliati) solo dall'istantanea più recente.

Nome colonna Tipo Descrizione
asset_id STRING Identificatore univoco della risorsa.
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa risorsa.
asset_type STRING Classificazione principale dell'asset.
I valori validi sono ASSET_CLASS_ROAD_SIGN, ASSET_CLASS_UTILITY_POLE e ASSET_CLASS_MAINTENANCE_COVER.
location STRUCT Struct contenente le coordinate di latitudine/longitudine come valori float che rappresentano la posizione approssimativa dell'asset.
detection_time TIMESTAMP L'osservazione più recente capture_time per l'asset specificato. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.

full_frame_lidar_metadata_latest

La tabella full_frame_lidar_metadata_latest fornisce i metadati della nuvola di punti LiDAR per le osservazioni degli asset a frame intero (non ritagliati) solo dallo snapshot più recente.

Nome colonna Tipo Descrizione
uri STRING URI Google Cloud Storage (gs://...) in cui è ospitato il file della nuvola di punti LiDAR compressa (.laz).
observation_id STRING Stringa che identifica in modo univoco l'osservazione.
asset_id STRING Identificatore univoco della risorsa associata a questa osservazione.
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa osservazione.
device_number INT64 Indice del sensore LiDAR sul veicolo di acquisizione che ha prodotto questa nuvola di punti. Più sensori LiDAR possono registrare osservazioni per lo stesso evento di acquisizione.
device_specs STRUCT Specifiche hardware del sensore LiDAR rotante. Struct contenente shots_per_beam_rotation (INT64) e rotation_rate_hz (INT64).
count_points INT64 Numero totale di punti di ritorno laser 3D contenuti nel file della nuvola di punti.
centroid_lat FLOAT64 Latitudine WGS84 (in gradi) del baricentro spaziale di tutti i ritorni laser nella nuvola di punti.
centroid_lon FLOAT64 Longitudine WGS84 (in gradi) del baricentro spaziale di tutti i ritorni laser nella nuvola di punti.
start_time TIMESTAMP Timestamp di quando è stato registrato il primo punto nella scansione LiDAR. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
end_time TIMESTAMP Timestamp di registrazione del punto finale della scansione LiDAR. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.

pano_observations_all

La tabella pano_observations_all fornisce osservazioni panoramiche (scena completa) di tutti gli snapshot. A differenza delle osservazioni degli asset, le osservazioni panoramiche contengono metadati della fotocamera a livello di frame e l'orientamento spaziale per gli eventi di acquisizione a 360 gradi, anziché i rilevamenti degli asset localizzati. Puoi utilizzare questa tabella per rilevare le differenze nelle osservazioni panoramiche tra gli snapshot.

Nome colonna Tipo Descrizione
capture_id STRING Identificatore univoco che rappresenta un singolo evento di acquisizione panoramica.
observation_id STRING Identificatore univoco di un singolo fotogramma che forma un singolo segmento di un'acquisizione panoramica a 360 gradi.
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa osservazione.
capture_location STRUCT Struct contenente le coordinate di latitudine/longitudine come valori float che rappresentano il baricentro del veicolo quando è stata acquisita l'osservazione.
capture_time TIMESTAMP Timestamp di quando è stata acquisita l'osservazione. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
camera_pose STRUCT La posizione della fotocamera LLA e gli angoli di Eulero. Struct contenente valori float per latitudine/longitudine, altitudine (in metri), inclinazione, direzione e rollio (in gradi).
gcs_uri STRING URI Google Cloud Storage in cui è ospitata l'immagine.
map_url STRING URL di Google Maps che mostra la posizione di acquisizione dell'osservazione.
pano_id STRING Identificatore univoco di un'immagine panoramica unita a 360 gradi. Questo valore è nullable; potrebbe non essere presente. Se presente, può essere utilizzata come chiave di accesso con l'API Google Maps Street View Static.

pano_observations_latest

La tabella pano_observations_latest fornisce osservazioni panoramiche (scena completa) solo dallo snapshot più recente.

Nome colonna Tipo Descrizione
capture_id STRING Identificatore univoco che rappresenta un singolo evento di acquisizione panoramica.
observation_id STRING Identificatore univoco di un singolo fotogramma che forma un singolo segmento di un'acquisizione panoramica a 360 gradi.
snapshot_id STRING Identificatore univoco dello snapshot che ha raccolto questa osservazione.
capture_location STRUCT Struct contenente le coordinate di latitudine/longitudine come valori float che rappresentano il baricentro del veicolo quando è stata acquisita l'osservazione.
capture_time TIMESTAMP Timestamp di quando è stata acquisita l'osservazione. Timestamp formattato secondo lo standard ISO 8601, ad esempio 2019-09-25 17:26:27.757171 UTC.
camera_pose STRUCT La posizione della fotocamera LLA e gli angoli di Eulero. Struct contenente valori float per latitudine/longitudine, altitudine (in metri), inclinazione, direzione e rollio (in gradi).
gcs_uri STRING URI Google Cloud Storage in cui è ospitata l'immagine.
map_url STRING URL di Google Maps che mostra la posizione di acquisizione dell'osservazione.
pano_id STRING Identificatore univoco di un'immagine panoramica unita a 360 gradi. Questo valore è nullable; potrebbe non essere presente. Se presente, può essere utilizzata come chiave di accesso con l'API Google Maps Street View Static.

Tabelle ritirate