Attribuzioni

Segmenti di scie di condensazione attribuiti per un elenco specifico di voli.

Formato dei dati

Le richieste di scie di condensazione attribuite contengono dati con la seguente struttura:

Rappresentazione JSON 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
Campi
attributions[]

object (Attribution)

Un elenco di attribuzioni, una per ogni nome di risorsa specificato in BatchGetAttributionsRequest.names. L'ordine delle attribuzioni in questo elenco corrisponderà all'ordine dei nomi in BatchGetAttributionsRequest. Se non è stato trovato un volo, il messaggio di attribuzione corrispondente nella risposta conterrà solo il campo name, mentre flightDetails e contrail saranno vuoti.

Attribuzione

Rappresenta un evento di scie di condensazione aggregato per un volo specifico che riepiloga tutti i segmenti di scie di condensazione attribuiti (ad es. chilometri totali ed energia).

Rappresentazione JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
Campi
name

string

Identificatore. Il nome della risorsa del volo.

Formato:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

Componenti:

  • {carrier}: codice IATA del vettore di 2 caratteri (ad es. "AA", "UA").
  • {flightNumber}: numero del volo di 1-4 cifre (ad es. "123").
  • {departure_date}: data di partenza del volo nel formato YYYY-MM-DD.
  • {departure_airport}: codice aeroporto IATA di 3 lettere (ad es. "JFK", "LHR").
flightDetails

object (FlightDetails)

Le informazioni dettagliate per questo volo.
contrail

object (ContrailAttributes)

Attributi di scie di condensazione aggregati per l'intero volo. Questo riassume gli attributi di scie di condensazione di tutti i segmenti attribuiti.

Interpretazione dello stato (all'interno di un volo trovato):

  • Se presente: è stata eseguita l'analisi delle scie di condensazione. I campi all'interno di ContrailAttributes indicano i risultati (ad es. lengthMeters > 0 significa che sono state attribuite scie di condensazione).
  • Se assente: l'analisi delle scie di condensazione NON è stata eseguita per questo volo.
    • In genere, questo è dovuto a dati di input insufficienti (ad es. dati meteorologici mancanti o incertezza del percorso di volo).
    • Ciò NON significa che non si siano formate scie di condensazione, ma solo che non è stato possibile determinarlo.
segments[]

object (SegmentAttribution)

Attribuzioni di scie di condensazione per segmento. Ogni voce rappresenta un intervallo di tempo distinto del volo a cui sono state attribuite le scie di condensazione.

FlightDetails

Definisce l'insieme completo di informazioni sul volo restituite nella risposta.

Rappresentazione JSON 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
Campi
carrier

string

Codice IATA del vettore del volo (ad es. "AA").
flightNumber

integer

Numero del volo (ad es. "123").
departureTime

string

Data di partenza nel fuso orario dell'aeroporto di partenza; int: epoca Unix O str: ISO 8601.
icao24

string

Indirizzo dell'aeromobile ICAO a 24 bit
originAirport

string

Codice aeroporto IATA di partenza.
destinationAirport

string

Codice aeroporto IATA di destinazione.
callSign

string

Nominativo di chiamata dell'aeromobile. Questo campo contiene preferibilmente il nominativo di chiamata utilizzato nelle comunicazioni del controllo del traffico aereo (ATC). Se il nominativo di chiamata ATC specifico non è disponibile o è uguale al designatore di volo standard, questo campo contiene il designatore di volo standard (in genere una combinazione di codice della compagnia aerea e numero del volo per i voli commerciali).
analyzedFlightDistanceMeters

integer

Distanza del volo analizzato, in metri.

ContrailAttributes

Rappresenta gli attributi di scie di condensazione per un volo o un segmento di volo.

Rappresentazione JSON 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
Campi
lengthMeters

integer

La lunghezza, in metri, del sottoinsieme o dei sottoinsiemi del percorso di volo a cui sono state attribuite le scie di condensazione. Viene calcolata come la distanza del cerchio massimo tra i waypoint del volo.
effectiveEnergyForcingJoules

string (int64 format)

Forza energetica totale effettiva delle scie di condensazione, in joule. Al momento, questo valore viene calcolato in base alle medie climatologiche ed è soggetto a modifiche.

SegmentAttribution

Rappresenta l'attribuzione di scie di condensazione per un segmento di tempo specifico di un volo.

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
Campi
startTime

string (Timestamp format)

Ora di inizio del segmento di volo a cui sono attribuite le scie di condensazione. Questo timestamp è in secondi di epoca UTC.
endTime

string (Timestamp format)

Ora di fine del segmento di volo a cui sono attribuite le scie di condensazione. Questo timestamp è in secondi di epoca UTC.
contrail

object (ContrailAttributes)

Attributi di scie di condensazione per questo segmento specifico.
detectionEvidences[]

object (ContrailDetectionEvidence)

Rilevamenti di scie di condensazione satellitari individuali che forniscono prove dell'attribuzione a questo segmento di volo.

ContrailDetectionEvidence

Dettagli di una singola osservazione satellitare di una scia di condensazione.

Rappresentazione JSON 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
Campi
observationTime

string (Timestamp format)

Ora in cui è stata scattata l'immagine satellitare in cui è stata rilevata la scia di condensazione. In genere, si tratta dell'ora di inizio della scansione. Questo timestamp è in secondi di epoca UTC.
observedLengthMeters

integer

La lunghezza end-to-end osservata della funzionalità di scie di condensazione lineare in metri, come rilevata nell'immagine satellitare specificata da observationTime. Questa lunghezza può differire da lengthMeters in SegmentAttribution.contrail perché:

  • La scia di condensazione potrebbe essersi evoluta (ad es. si è diffusa, allungata e così via) nell'atmosfera tra la formazione e l'osservazione.
  • L'algoritmo di attribuzione è stato in grado di attribuire con certezza solo una parte di questa scia di condensazione a questo volo.
dataSource

enum (DataSource)

Solo output. L'origine dei dati satellitari utilizzati per questo rilevamento.

DataSource

L'origine dei dati satellitari utilizzati per il rilevamento delle scie di condensazione. In futuro potrebbero essere aggiunti altri valori.

Al momento, gli output dei dati satellitari disponibili sono GOES East e MTG. Le attribuzioni basate su GOES East hanno una qualità a livello di produzione, mentre le attribuzioni basate su MTG sono ancora in fase beta e sono in fase di miglioramento della qualità.

Enum
DATA_SOURCE_UNSPECIFIED Origine dati non specificata.
GOES_EAST_FULL_DISK Dati provenienti dalle scansioni del disco completo GOES-East.
GOES_WEST_FULL_DISK Dati provenienti dalle scansioni del disco completo GOES-West.
MTG_000_FULL_DISK Dati provenienti dalle scansioni del disco completo MTG-000.
HIMAWARI_FULL_DISK Dati provenienti dalle scansioni del disco completo Himawari.