Attribuzioni

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

Formato dei dati

Le richieste di scie di aerei 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 avrà compilato 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 ed energia totali).

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 vettore IATA di due caratteri (ad es. "AA", "UA").
  • {flightNumber}: numero di volo di 1-4 cifre (ad es. "123").
  • {departure_date}: data di partenza del volo in base all'ora locale dell'aeroporto di partenza nel formato YYYY-MM-DD.
  • {departure_airport}: codice IATA a tre lettere dell'aeroporto (ad es. "JFK", "LHR").
flightDetails

object (FlightDetails)

Le informazioni dettagliate su questo volo.
contrail

object (ContrailAttributes)

Attributi aggregati delle scie di condensazione per l'intero volo. Somma 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 delle scie di condensazione. I campi all'interno di ContrailAttributes indicano i risultati (ad es. lengthMeters > 0 significa che le scie di condensazione sono state attribuite). Se è presente un messaggio ContrailAttributes vuoto, significa che è stata eseguita l'analisi, ma sia lengthMeters che l'imposizione di energia sono pari a zero.
  • In caso di assenza:l'analisi delle scie di condensazione NON è stata eseguita per questo volo.
    • Ciò è in genere dovuto a dati di input insufficienti (ad es. dati meteo mancanti o incertezza della traiettoria di volo).
    • Ciò NON significa che non si siano formate scie di condensazione, ma solo che non è stato possibile effettuare una determinazione.
segments[]

object (SegmentAttribution)

Attribuzioni di scie di condensa 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 della compagnia aerea 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 nel formato AAAAMMGG.
icao24

string

Indirizzo ICAO a 24 bit dell'aeromobile
originAirport

string

Codice IATA dell'aeroporto di partenza.
destinationAirport

string

Codice IATA dell'aeroporto di destinazione.
callSign

string

Il nominativo dell'aeromobile. Questo campo contiene preferibilmente il nominativo utilizzato nelle comunicazioni del controllo del traffico aereo (ATC). Se l'indicativo 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 di volo per i voli commerciali).
analyzedFlightDistanceMeters

integer

Distanza del volo analizzato, in metri.

ContrailAttributes

Rappresenta gli attributi delle 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 della traiettoria di volo a cui sono state attribuite le scie di condensazione. Viene calcolata come distanza ortodromica tra i waypoint del volo.
effectiveEnergyForcingJoules

string (int64 format)

Forzante energetica totale effettiva delle scie di condensazione, in joule. Questo valore viene derivato estraendo il forzante radiativo effettivo dagli output di previsione CoCiP con griglia 4D e interpolandoli linearmente. 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 è 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 epoch UTC.
contrail

object (ContrailAttributes)

Attributi Contrail per questo segmento specifico.
detectionEvidences[]

object (ContrailDetectionEvidence)

Rilevamenti individuali di scie di condensazione dei satelliti 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. Vero 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 delle scie di condensazione per punto di controllo 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 è l'ora di inizio della scansione. Questo timestamp è in secondi di epoca UTC.
observedLengthMeters

integer

La lunghezza end-to-end osservata della scia lineare in metri, rilevata nell'immagine satellitare specificata da observationTime. Questa durata può essere diversa 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.

Origine dati

L'origine 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 delle scansioni del disco completo GOES-East.
GOES_WEST_FULL_DISK Dati delle scansioni del disco completo GOES-West.
MTG_000_FULL_DISK Dati delle scansioni del disco completo MTG-000.
HIMAWARI_FULL_DISK Dati delle scansioni del disco completo di Himawari.

Le immagini satellitari dell'API Contrails si basano su:

WaypointAttribution

Rappresenta gli attributi delle scie di condensazione per un punto di controllo specifico in un segmento di volo.

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

string (Timestamp format)

L'ora al waypoint in secondi di epoca 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 eseguire l'attribuzione.

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

Attribuzione ibrida che combina le previsioni del modello CoCiP corrette in base ai rilevamenti satellitari.

  • Con rilevamenti:se è presente detectionEvidences, la scia di condensazione è stata prevista e confermata dall'osservazione, ricevendo un peso maggiore per il riscaldamento.
  • Senza rilevamenti:se detectionEvidences non è presente, la scia è stata prevista ma non osservata, quindi 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.