Attribution

Zugeordnete Kondensstreifensegmente für eine bestimmte Liste von Flügen.

Datenformat

Anfragen für zugeordnete Kondensstreifen enthalten Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
Felder
attributions[]

object (Attribution)

Eine Liste von Attributen, jeweils eines für jeden in BatchGetAttributionsRequest.names angegebenen Ressourcennamen. Die Reihenfolge der Attributions in dieser Liste entspricht der Reihenfolge der Namen in BatchGetAttributionsRequest. Wenn ein Flug nicht gefunden wurde, wird in der entsprechenden Attribution-Nachricht in der Antwort nur das Feld name ausgefüllt, während flightDetails und contrail leer sind.

Attribution

Stellt ein aggregiertes Kondensstreifenereignis für einen bestimmten Flug dar, das alle zugeordneten Kondensstreifensegmente zusammenfasst (z.B. Gesamtkilometer und Energie).

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

string

ID. Der Ressourcenname des Flugs.

Format:

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

Komponenten:

  • {carrier}: zweistelliger IATA-Flugliniencode (z.B. "AA", "UA").
  • {flightNumber}: 1- bis 4-stellige Flugnummer (z.B. "123").
  • {departure_date}: Abflugdatum gemäß der Ortszeit des Abflughafens im Format YYYY-MM-DD (verfügbar ab 2024).
  • {departure_airport}: dreistelliger IATA-Flughafencode (z.B. "JFK", "LHR").
flightDetails

object (FlightDetails)

Die Detailinformationen für diesen Flug.
contrail

object (ContrailAttributes)

Aggregierte Kondensstreifenattribute für den gesamten Flug. Hier werden die Kondensstreifenattribute aller zugeordneten Segmente zusammengefasst.

Statusinterpretation (innerhalb eines gefundenen Flugs):

  • Falls vorhanden: Es wurde eine Kondensstreifenanalyse durchgeführt. Die Felder in ContrailAttributes geben die Ergebnisse an (z.B. bedeutet lengthMeters > 0, dass Kondensstreifen zugeordnet wurden). Wenn eine leere ContrailAttributes-Nachricht vorhanden ist, bedeutet das, dass die Analyse durchgeführt wurde, aber sowohl lengthMeters als auch das Energie-Forcing mit null bewertet wurden.
  • Wenn nicht vorhanden: Für diesen Flug konnte KEINE Kondensstreifenanalyse durchgeführt werden.
    • Das liegt in der Regel an unzureichenden Eingabedaten (z.B. fehlende Wetterdaten oder Unsicherheit bei der Flugroute).
    • Das bedeutet NICHT, dass keine Kondensstreifen entstanden sind, sondern nur, dass keine Bestimmung möglich war.
segments[]

object (SegmentAttribution)

Kondensstreifen-Attributionen pro Segment. Jeder Eintrag steht für ein bestimmtes Zeitintervall des Fluges, dem Kondensstreifen zugeordnet wurden.
visualizationUrl

string

Nur Ausgabe. Link zu einer interaktiven Visualisierung der Kondensstreifenzuordnung dieses Fluges auf der ContrailWatch-Seite von ContrailExplorer. Sie zeigt die Flugroute, die mit den von Satelliten erkannten Kondensstreifen übereinstimmt.

Wird nur für gefundene Flüge ausgefüllt, wenn die Ansicht ATTRIBUTION_VIEW_OBSERVATION verwendet wird.

FlightDetails

Definiert den vollständigen Satz von Fluginformationen, die in der Antwort zurückgegeben werden.

JSON-Darstellung 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
Felder
carrier

string

IATA-Code der Fluggesellschaft (z.B. „AA“).
flightNumber

integer

Flugnummer des Fluges (z.B. „123“).
departureTime

string

Abreisedatum in der Zeitzone des Abflughafens im Format JJJJMMTT.
icao24

string

24-Bit-ICAO-Adresse der Lieferdrohne
originAirport

string

IATA-Flughafencode des Abflugorts
destinationAirport

string

IATA-Flughafencode des Zielflughafens
callSign

string

Rufzeichen des Flugzeugs. Dieses Feld enthält vorzugsweise das Rufzeichen, das in der Kommunikation mit der Flugsicherung (ATC) verwendet wird. Wenn das spezifische ATC-Rufzeichen nicht verfügbar ist oder mit der Standard-Flugbezeichnung übereinstimmt, enthält dieses Feld die Standard-Flugbezeichnung (bei kommerziellen Flügen in der Regel eine Kombination aus Flugliniencode und Flugnummer).
analyzedFlightDistanceMeters

integer

Entfernung des analysierten Flugs in Metern.

ContrailAttributes

Stellt die Kondensstreifenattribute für einen Flug oder ein Flugsegment dar.

JSON-Darstellung 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
Felder
lengthMeters

integer

Die Länge der Teilmengen der Flugbahn in Metern, denen Kondensstreifen zugeordnet wurden. Diese wird als Großkreisentfernung zwischen den Wegpunkten des Flugs berechnet.
effectiveEnergyForcingJoules

string (int64 format)

Gesamte effektive Kondensstreifen-Energieerzwingung in Joule. Dieser wird abgeleitet, indem der effektive Strahlungsantrieb aus den 4D-gitterbasierten CoCiP-Prognoseausgaben extrahiert und linear interpoliert wird. Diese Methodik kann sich ändern.

SegmentAttribution

Stellt die Zuordnung von Kondensstreifen für ein bestimmtes Zeitsegment eines Fluges dar.

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

string (Timestamp format)

Beginn des Flugsegments, dem Kondensstreifen zugeordnet werden. Dieser Zeitstempel wird in UTC-Epochensekunden angegeben.
endTime

string (Timestamp format)

Ende des Flugsegments, dem Kondensstreifen zugeordnet sind. Dieser Zeitstempel wird in UTC-Epochensekunden angegeben.
contrail

object (ContrailAttributes)

Kondensstreifenattribute für dieses bestimmte Segment.
detectionEvidences[]

object (ContrailDetectionEvidence)

Einzelne Satellitenerkennungen von Kondensstreifen, die als Beleg für die Zuordnung zu diesem Flugsegment dienen.
attributionMethod

enum (AttributionMethod)

Nur Ausgabe. Die Methode, mit der Kondensstreifen diesem Segment zugeordnet werden (z.B. CoCiP-Modell oder direkte Beobachtung).
longGapInterpolation

boolean

Nur Ausgabe. „True“, wenn die Flugbahn des Segments durch Interpolation über eine lange ADS-B-Datenlücke (> 5 Minuten) generiert wurde.
waypointAttributions[]

object (WaypointAttribution)

Nur Ausgabe. Wegpunktspezifische Kondensstreifenattribute, die diesem Segment zugeordnet sind.

ContrailDetectionEvidence

Details einer einzelnen Satellitenbeobachtung eines Kondensstreifens.

JSON-Darstellung 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
Felder
observationTime

string (Timestamp format)

Zeitpunkt, zu dem das Satellitenbild aufgenommen wurde, auf dem der Kondensstreifen erkannt wurde. Dies ist in der Regel der Beginn des Scans. Dieser Zeitstempel wird in UTC-Epochensekunden angegeben.
observedLengthMeters

integer

Die beobachtete Gesamtlänge des linearen Kondensstreifens in Metern, wie im Satellitenbild observationTime erkannt. Diese Länge kann sich aus folgenden Gründen von der lengthMeters in SegmentAttribution.contrail unterscheiden:

  • Der Kondensstreifen kann sich zwischen der Bildung und der Beobachtung in der Atmosphäre verändert haben (z.B. ausgebreitet, verlängert usw.).
  • Der Attributionsalgorithmus konnte nur einen Teil dieses Kondensstreifens diesem Flug zuordnen.
dataSource

enum (DataSource)

Nur Ausgabe. Die Quelle der Satellitendaten, die für diese Erkennung verwendet wurden.

DataSource

Die Quelle der Satellitendaten, die für die Erkennung von Kondensstreifen verwendet werden. In Zukunft werden möglicherweise weitere Werte hinzugefügt.

Unter den verfügbaren Satellitendaten haben die GOES-East- und Himawari-basierten Zuordnungen Produktionsqualität, während die MTG-basierten Zuordnungen noch in der Betaphase sind und aktiv verbessert werden.

Enums
DATA_SOURCE_UNSPECIFIED Nicht angegebene Datenquelle.
GOES_EAST_FULL_DISK Daten aus GOES-East-Scans der gesamten Erdscheibe.
GOES_WEST_FULL_DISK Daten aus GOES-West-Scans der gesamten Erdscheibe.
MTG_000_FULL_DISK Daten aus MTG-000-Vollscans.
HIMAWARI_FULL_DISK Daten aus Himawari-Scans der gesamten Erdscheibe.

Die Satellitenbilder der Contrails API basieren auf:

WaypointAttribution

Stellt Kondensstreifenattribute für einen bestimmten Wegpunkt in einem Flugsegment dar.

JSON-Darstellung 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
Felder
time

string (Timestamp format)

Die Zeit am Wegpunkt in UTC-Epochensekunden.
contrailAttributes

object (ContrailAttributes)

Die an diesem Wegpunkt zugeordneten Kondensstreifenattribute.

AttributionMethod

Definiert das spezifische Verfahren oder die Methodik, die für die Attribution verwendet wird.

Enums
ATTRIBUTION_METHOD_OBSERVATION Die Zuordnung erfolgt ausschließlich durch Abgleich mit Satellitendaten zu Kondensstreifen.
ATTRIBUTION_METHOD_COCIP Attributionen, die ausschließlich auf physikbasierter CoCiP-Modellierung beruhen.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

Hybrid-Attribution, bei der Prognosen des CoCiP-Modells mit Satellitenerkennungen kombiniert werden.

  • Mit Erkennungen: Wenn detectionEvidences vorhanden ist, wurde die Kondensstreifenbildung vorhergesagt und durch Beobachtung bestätigt. Sie erhält eine höhere Gewichtung für die Erwärmung.
  • Ohne Erkennungen: Wenn detectionEvidences fehlt, wurde die Kondensstreifenbildung vorhergesagt, aber nicht beobachtet. Die berechnete Erwärmung wird daher nicht berücksichtigt.
ATTRIBUTION_METHOD_UNSPECIFIED Nicht angegebene Methode.

Hinweise

Jede DataSource verwendet unterschiedliche Grenzen für die Verarbeitung beobachtungsbasierter Ansichten:

Begrenzungsrahmen für die Satellitenabdeckung (flache Mercator-Ansicht)

Lizenz

Die von der ContrailWatch Attributions API bereitgestellten Daten sind unter CC BY-NC 4.0 lizenziert.