Attribution

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

Datenformat

Anfragen zu zugeordneten Kondensstreifen enthalten Daten mit folgender Struktur:

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

object (Attribution)

Eine Liste von Zuordnungen, eine für jeden Ressourcennamen, der in BatchGetAttributionsRequest.names angegeben ist. Die Reihenfolge der Zuordnungen in dieser Liste entspricht der Reihenfolge der Namen in der BatchGetAttributionsRequest. Wenn ein Flug nicht gefunden wurde, ist in der entsprechenden Zuordnungsnachricht 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, in dem alle zugeordneten Kondensstreifensegmente zusammengefasst sind (z.B. Gesamtkilometer und Energie).

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

string

ID. Der Ressourcenname des Flugs.

Format :

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

Komponenten :

  • {carrier}: IATA-Code der Fluggesellschaft mit zwei Zeichen (z.B. "AA", "UA").
  • {flightNumber}: Flugnummer mit 1 bis 4 Ziffern (z.B. "123").
  • {departure_date}: Abflugdatum im Format YYYY-MM-DD.
  • {departure_airport}: IATA-Flughafencode mit drei Buchstaben (z.B. "JFK", "LHR").
flightDetails

object (FlightDetails)

Die detaillierten Informationen zu diesem Flug.
contrail

object (ContrailAttributes)

Aggregierte Kondensstreifenattribute für den gesamten Flug. Hier werden die Kondensstreifenattribute aus allen zugeordneten Segmenten zusammengefasst.

Interpretation des Status (innerhalb eines gefundenen Flugs) :

  • Vorhanden:Es wurde eine Kondensstreifenanalyse durchgeführt. Die Felder in ContrailAttributes geben die Ergebnisse an (z.B. lengthMeters > 0 bedeutet, dass Kondensstreifen zugeordnet wurden).
  • 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 in Bezug auf die Flugroute).
    • Das bedeutet NICHT, dass keine Kondensstreifen entstanden sind, sondern nur, dass keine Bestimmung möglich war.
segments[]

object (SegmentAttribution)

Kondensstreifenzuordnungen pro Segment. Jeder Eintrag steht für ein bestimmtes Zeitintervall des Flugs, dem Kondensstreifen zugeordnet wurden.

FlightDetails

Definiert alle 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 (z.B. „123“).
departureTime

string

Abflugdatum in der Zeitzone des Abflughafens; Ganzzahl: Unix-Epoche ODER String: ISO 8601.
icao24

string

ICAO-24-Bit-Flugzeugadresse
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 der Flugsicherung verwendet wird. Wenn das spezifische Rufzeichen der Flugsicherung nicht verfügbar ist oder mit der Standardflugnummer übereinstimmt, enthält dieses Feld die Standardflugnummer (in der Regel eine Kombination aus dem Code der Fluggesellschaft und der Flugnummer für kommerzielle Flüge).
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 in Metern der Teilmenge(n) der Flugroute, der Kondensstreifen zugeordnet wurden. Sie wird als Großkreisentfernung zwischen den Wegpunkten des Flugs berechnet.
effectiveEnergyForcingJoules

string (int64 format)

Gesamte effektive Kondensstreifenenergie in Joule. Sie wird derzeit auf der Grundlage klimatologischer Durchschnittswerte berechnet und kann sich ändern.

SegmentAttribution

Stellt die Kondensstreifenzuordnung für ein bestimmtes Zeitsegment eines Flugs dar.

JSON-Darstellung 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
Felder
startTime

string (Timestamp format)

Startzeit des Flugsegments, dem Kondensstreifen zugeordnet sind. Dieser Zeitstempel ist in UTC-Epochensekunden angegeben.
endTime

string (Timestamp format)

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

object (ContrailAttributes)

Kondensstreifenattribute für dieses Segment.
detectionEvidences[]

object (ContrailDetectionEvidence)

Einzelne Satelliten-Kondensstreifenerkennungen, die Beweise für die Zuordnung zu diesem Flugsegment liefern.

ContrailDetectionEvidence

Details zu 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 die Startzeit des Scans. Dieser Zeitstempel ist in UTC-Epochensekunden angegeben.
observedLengthMeters

integer

Die beobachtete Länge des linearen Kondensstreifens in Metern, wie sie auf dem Satellitenbild erkannt wurde, das durch observationTime angegeben ist. Diese Länge kann sich von lengthMeters in SegmentAttribution.contrail unterscheiden, weil:

  • Der Kondensstreifen sich in der Atmosphäre zwischen Entstehung und Beobachtung weiterentwickelt hat (z. B. verbreitert oder verlängert).
  • Der Zuordnungsalgorithmus konnte nur einen Teil dieses Kondensstreifens mit Sicherheit 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 Kondensstreifenerkennung verwendet wurden. In Zukunft können weitere Werte hinzugefügt werden.

Derzeit sind GOES East und MTG als Satellitendaten verfügbar. Zuordnungen auf der Grundlage von GOES East haben Produktionsqualität, während Zuordnungen auf der Grundlage von MTG 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 Erde.
GOES_WEST_FULL_DISK Daten aus GOES-West-Scans der gesamten Erde.
MTG_000_FULL_DISK Daten aus MTG-000-Scans der gesamten Erde.
HIMAWARI_FULL_DISK Daten aus Himawari-Scans der gesamten Erde.

Lizenz

Die Daten, die von der ContrailWatch Attributions API bereitgestellt werden, sind unter der CC BY-NC 4.0-Lizenz lizenziert.