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, nel messaggio di attribuzione corrispondente nella risposta verrà compilato solo il campo name, mentre flightDetails e contrail saranno vuoti.

Attribuzione

Rappresenta un evento di scia di condensazione aggregato per un volo specifico che riassume tutti i segmenti di scia di condensazione attribuiti (ad esempio, chilometri ed energia totali).

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

string

Identificatore. Il nome della risorsa del volo.

Formato:

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

Componenti:

  • {carrier}: codice vettore IATA di 2 caratteri (ad es. "AA", "UA").
  • {flightNumber}: numero del volo da 1 a 4 cifre (ad es. "123").
  • {departure_date}: data di partenza del volo in base all'ora locale dell'aeroporto di origine nel formato YYYY-MM-DD (disponibile dal 2024 in poi).
  • {departure_airport}: codice aeroportuale IATA di 3 lettere (ad es. "JFK", "LHR").
flightDetails

object (FlightDetails)

Le informazioni dettagliate per questo volo.
contrail

object (ContrailAttributes)

Attributi aggregati delle scie di condensazione per l'intero volo. In questo modo vengono sommati gli attributi della scia di condensazione di tutti i segmenti attribuiti.

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

  • Se presente: è stata eseguita l'analisi della scia di condensazione. I campi all'interno di ContrailAttributes indicano i risultati (ad es. lengthMeters > 0 indica che le scie di condensazione sono state attribuite). Se è presente un messaggio ContrailAttributes vuoto, significa che l'analisi è stata eseguita, ma sia lengthMeters che il forzante energetico sono stati valutati come pari a zero.
  • Se assente: NON è stato possibile eseguire l'analisi delle scie di condensazione per questo volo.
    • In genere, ciò è dovuto a dati di input insufficienti (ad es. dati meteo mancanti o incertezza sulla traiettoria di volo).
    • Ciò NON significa che non si siano formate scie di condensazione, ma solo che non è stato possibile determinarlo.
segments[]

object (SegmentAttribution)

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

string

Solo output. Link a una visualizzazione interattiva dell'attribuzione della scia di condensazione di questo volo nella pagina ContrailWatch di ContrailExplorer. Mostra la traiettoria di volo abbinata alle scie di condensazione rilevate dai satelliti.

Compilato solo per i voli trovati quando utilizzi la visualizzazione ATTRIBUTION_VIEW_OBSERVATION.

FlightDetails

Definisce l'insieme completo di informazioni sui voli 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 vettore IATA del volo (ad es. "AA").
flightNumber

integer

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

string

Data di partenza nel fuso orario dell'aeroporto di origine nel formato AAAAMMGG.
icao24

string

Indirizzo dell'aeromobile a 24 bit ICAO
originAirport

string

Codice aeroporto IATA di partenza.
destinationAirport

string

Codice aeroporto IATA di destinazione.
callSign

string

Indicativo di chiamata dell'aeromobile. Questo campo contiene preferibilmente il nominativo utilizzato nelle comunicazioni del controllo del traffico aereo (ATC). Se il nominativo ATC specifico non è disponibile o è uguale all'indicativo di volo standard, questo campo contiene l'indicativo 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 della scia di condensazione per un volo o un segmento di volo.

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

integer

La lunghezza, in metri, dei sottoinsiemi della traiettoria di volo a cui sono state attribuite le scie di condensazione. Viene calcolata come la distanza ortodromica tra i waypoint del volo.
effectiveEnergyForcingJoules

string (int64 format)

Forzatura energetica totale effettiva delle scie di condensazione, in joule. Questo valore viene ottenuto estraendo il forzante radiativo effettivo dagli output delle previsioni CoCiP con griglia 4D e interpolandoli in modo lineare. Questa metodologia è soggetta a modifiche.

SegmentAttribution

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

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
Campi
startTime

string (Timestamp format)

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

string (Timestamp format)

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

object (ContrailAttributes)

Attributi della scia di condensazione per questo segmento specifico.
detectionEvidences[]

object (ContrailDetectionEvidence)

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

enum (AttributionMethod)

Solo output. Il metodo utilizzato per attribuire le scie di condensazione a questo segmento (ad es. modello CoCiP o osservazione diretta).
longGapInterpolation

boolean

Solo output. True se la traiettoria di volo del segmento è stata generata interpolando un lungo intervallo di dati ADS-B (>5 minuti).
waypointAttributions[]

object (WaypointAttribution)

Solo output. Attributi della scia di condensazione per waypoint mappati in questo segmento.

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 è espresso in secondi epoch UTC.
observedLengthMeters

integer

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

  • La scia di condensazione potrebbe essersi evoluta (ad es. diffusa, allungata ecc.) 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. La fonte dei dati satellitari utilizzati per questo rilevamento.

Origine dati

La fonte dei dati satellitari utilizzati per il rilevamento delle scie di condensazione. In futuro potrebbero essere aggiunti altri valori.

Tra gli output dei dati satellitari disponibili, le attribuzioni basate su GOES East e Himawari hanno una qualità a livello di produzione, mentre quelle basate su MTG sono ancora in fase beta e sono in corso miglioramenti della qualità.

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

Le immagini satellitari dell'API Contrails si basano su:

WaypointAttribution

Rappresenta gli attributi della scia di condensazione per un waypoint specifico in un segmento di volo.

Rappresentazione JSON 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
Campi
time

string (Timestamp format)

L'ora del waypoint in secondi epoch UTC.
contrailAttributes

object (ContrailAttributes)

Gli attributi della scia di condensazione mappati in questo waypoint specifico.

AttributionMethod

Definisce la procedura o la metodologia specifica utilizzata per l'attribuzione.

Enum
ATTRIBUTION_METHOD_OBSERVATION Attribuzione derivata rigorosamente dalla corrispondenza con i rilevamenti satellitari delle scie di condensazione.
ATTRIBUTION_METHOD_COCIP Attribuzioni basate esclusivamente sulla modellazione CoCiP basata sulla fisica.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

Attribuzione ibrida che combina le previsioni del modello CoCiP con i rilevamenti satellitari.

  • Con rilevamenti: se è presente detectionEvidences, la scia di condensazione è stata prevista e confermata dall'osservazione, ricevendo un peso di riscaldamento maggiore.
  • Senza rilevamenti: se detectionEvidences non è presente, la scia di condensazione è stata prevista, ma non osservata, pertanto il riscaldamento calcolato viene scontato.
ATTRIBUTION_METHOD_UNSPECIFIED Metodo non specificato.

Note

Ogni DataSource utilizza limiti diversi per l'elaborazione delle visualizzazioni basate sull'osservazione:

Riquadri di delimitazione della copertura satellitare (visualizzazione Mercatore piatta)

Licenza

I dati esposti dall'API ContrailWatch Attributions sono concessi in licenza ai sensi della licenza CC BY-NC 4.0.