Method: batchGetAttributions

Ruft mehrere Kondensstreifen-Zuweisungen anhand von Fluginformationen ab.

Bei Erfolg ist die Antwort eine Liste von Kondensstreifen-Attributen.

HTTP-Anfrage

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Die übergeordnete Ressource, die von allen abgerufenen Attributen gemeinsam genutzt wird. Format: Attributionen

Suchparameter

Parameter
names[]

string

Erforderlich. Die Ressourcennamen der abzurufenden Flüge. In einer einzelnen Anfrage können maximal 100 Namen angegeben werden.

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}: 1- bis 4-stellige Flugnummer (z.B. "123").
  • {departure_date}: Abflugdatum im Format YYYY-MM-DD.
  • {departure_airport}: Aus drei Buchstaben bestehender IATA-Flughafencode (z.B. "JFK", "LHR").

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort mit den zugeordneten Kontraktionen für „attributions.batchGet“.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

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

object (Attribution)

Eine Liste von Quellenangaben, eine für jeden im BatchGetAttributionsRequest.names angegebenen Ressourcennamen. Die Reihenfolge der Quellenangaben in dieser Liste entspricht der Reihenfolge der Namen in BatchGetAttributionsRequest. Wenn kein Flug gefunden wurde, ist in der entsprechenden Attributionsmeldung 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 zugehörigen 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}: 1- bis 4-stellige Flugnummer (z.B. "123").
  • {departure_date}: Abflugdatum im Format YYYY-MM-DD.
  • {departure_airport}: Aus drei Buchstaben bestehender 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 summiert.

Interpretation des Status (bei einem gefundenen Flug):

  • Falls vorhanden:Es wurde eine Contrail-Analyse durchgeführt. Die Felder in ContrailAttributes geben die Ergebnisse an (z.B. lengthMeters > 0 bedeutet, dass Kondensstreifen berücksichtigt wurden.
  • Falls nicht vorhanden:Für diesen Flug konnte KEINE Kondensstreifenanalyse durchgeführt werden.
    • Das liegt in der Regel an unzureichenden Eingabedaten, z.B. fehlenden Wetterdaten oder Unsicherheiten beim Flugpfad.
    • Das bedeutet NICHT, dass keine Kondensstreifen gebildet wurden, sondern nur, dass keine Entscheidung getroffen werden konnte.
segments[]

object (SegmentAttribution)

Beiträge von Kondensstreifen nach Segment. Jeder Eintrag steht für ein bestimmtes Zeitintervall des Flugs, dem Kondensstreifen zugeordnet wurden.

FlightDetails

Definiert die vollständigen 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 Flugs (z.B. „123“).
departureTime

string

Abflugdatum in der Zeitzone des Herkunftsflughafens int: Unix-Epoche; str: ISO 8601.
icao24

string

ICAO-24-Bit-Flugzeugadresse
originAirport

string

IATA-Code des Abflughafens
destinationAirport

string

IATA-Code des Zielflughafens
callSign

string

Rufzeichen des Flugzeugs. Dieses Feld enthält vorzugsweise das Rufzeichen, das in der Kommunikation mit der Flugsicherung (Air Traffic Control, ATC) verwendet wird. Wenn das spezifische ATC-Rufzeichen nicht verfügbar ist oder mit der Standardflugkennung übereinstimmt, enthält dieses Feld die Standardflugkennung (in der Regel eine Kombination aus Airline-Code und Flugnummer für kommerzielle Flüge).
analyzedFlightDistanceMeters

integer

Distanz des analysierten Flugs in Metern.

ContrailAttributes

Stellt die Kondensstreifenattribute für einen Flug oder Flugabschnitt dar.

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

integer

Die Länge der Teilmenge(n) des Flugpfads, denen Kondensstreifen zugeordnet wurden, in Metern. Sie wird als die Luftlinie zwischen den Wegpunkten des Flugs berechnet.
effectiveEnergyForcingJoules

string (int64 format)

Gesamte effektive Energie des Kondensstreifens in Joule. Sie wird derzeit auf Grundlage klimatologischer Durchschnittswerte berechnet und kann sich ändern.

SegmentAttribution

Stellt die Kondensstreifen-Attribution 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 werden. Dieser Zeitstempel wird in UTC-Epochensekunden angegeben.
endTime

string (Timestamp format)

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

object (ContrailAttributes)

Kondensstreifenattribute für dieses Segment.
detectionEvidences[]

object (ContrailDetectionEvidence)

Einzelne Satellitenkondensstreifenerkennungen, die als Beweis für die Zuordnung zu diesem Flugsegment dienen.

ContrailDetectionEvidence

Details zu einer einzelnen Satellitenbeobachtung eines Kondensstreifens.

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

string (Timestamp format)

Die Uhrzeit, zu der das Satellitenbild aufgenommen wurde, auf dem die Kondensstreifen zu sehen sind. Dies ist in der Regel die Startzeit des Scans. Dieser Zeitstempel wird in UTC-Epochensekunden angegeben.
observedLengthMeters

integer

Die beobachtete End-to-End-Länge des linearen Kondensstreifens in Metern, wie sie auf dem Satellitenbild erkannt wurde, das durch observationTime angegeben wird. Die Länge kann sich aus folgenden Gründen von der lengthMeters in SegmentAttribution.contrail unterscheiden:

  • Die Kondensstreifen haben sich möglicherweise in der Atmosphäre zwischen ihrer Entstehung und der Beobachtung verändert (z. B. ausgebreitet oder verlängert).
  • Der Zuordnungsalgorithmus 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 Kondensstreifenerkennung verwendet werden. In Zukunft werden möglicherweise weitere Werte hinzugefügt.

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-Vollscans.