Method: batchGetAttributions

Ruft mehrere Kondensstreifenzuordnungen 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

Abfrageparameter

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}: Aus zwei Zeichen bestehender IATA-Airlinecode (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 Contrails 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 zugeordneten Kondensstreifensegmente zusammengefasst sind (z.B. Gesamtkilometer und Energie).

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

string

ID. Der Ressourcenname des Flugs.

Format:

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

Komponenten:

  • {carrier}: Aus zwei Zeichen bestehender IATA-Airlinecode (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)

Details zu Kondensstreifen, die dem Flug zugeordnet sind.

Interpretation des Status (innerhalb eines gefundenen Flugs):

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

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": string
}
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 Abflugorts int: Unix-Epoche; str: ISO 8601.
icao24

string

ICAO-Flugzeugadresse mit 24 Bit
originAirport

string

IATA-Code des Abflughafens
destinationAirport

string

IATA-Code des Zielflughafens
callSign

string

Das Rufzeichen des Flugzeugs, das dem Wegpunkt zugeordnet ist.
analyzedFlightDistanceMeters

string (int64 format)

Entfernung des analysierten Flugs in Metern.

ContrailAttributes

Stellt die Kondensstreifenattribute für einen Flug dar.

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

string (int64 format)

Geschätzte Länge der Kondensstreifenbildung in Metern.
effectiveEnergyForcingJoules

string (int64 format)

Die gesamte effektive Energie, die diesem Flug zugeschrieben wird, in Joule.