Method: flights.computeFlightEmissions

Statuslose Methode zum Abrufen von Emissionsschätzungen. Details zur Berechnung von Emissionsschätzungen finden Sie auf GitHub.

Die Antwort enthält alle Einträge, die den eingegebenen Flugstrecken entsprechen, in derselben Reihenfolge. Wenn für eine bestimmte Flugstrecke keine Schätzungen verfügbar sind, wird in der Antwort das Flugstreckenobjekt mit leeren Emissionsfeldern zurückgegeben. Die Anfrage wird trotzdem als erfolgreich betrachtet. Gründe für fehlende Emissionsschätzungen:

  • Der Flug ist dem Server nicht bekannt.
  • In der eingegebenen Flugstrecke fehlen eine oder mehrere IDs.
  • Das Flugdatum liegt in der Vergangenheit.
  • Der Flugzeugtyp wird vom Modell nicht unterstützt.
  • Die Sitzplatzkonfiguration fehlt.

Die Anfrage kann bis zu 1.000 Flugstrecken enthalten. Wenn die Anfrage mehr als 1.000 Direktflüge enthält, schlägt sie mit dem Fehler INVALID_ARGUMENT fehl.

HTTP-Anfrage

POST https://travelimpactmodel.googleapis.com/v1/flights:computeFlightEmissions

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
Felder
flights[]

object (Flight)

Erforderlich. Direktflüge, für die Emissionsschätzungen zurückgegeben werden sollen.

Antworttext

Ausgabedefinition für die Antwort flights.computeFlightEmissions.

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

JSON-Darstellung 
{
  "flightEmissions": [
    {
      object (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Felder
flightEmissions[]

object (FlightWithEmissions)

Liste der Flugstrecken mit Emissionsschätzungen.
modelVersion

object (ModelVersion)

Die Modellversion, mit der die Emissionsschätzungen für alle Flüge in dieser Antwort berechnet wurden.

Flug

Alle Details zu einem einzelnen Anfrageelement für Emissionsschätzungen für Direktflüge.

JSON-Darstellung 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
Felder
origin

string

Erforderlich. IATA-Flughafencode für den Abflughafen, z.B. „LHR“.
destination

string

Erforderlich. IATA-Flughafencode für den Zielflughafen, z.B. „JFK“.
operatingCarrierCode

string

Erforderlich. IATA-Code der Fluggesellschaft, z.B. „AA“.
flightNumber

integer

Erforderlich. Flugnummer, z.B. 324.
departureDate

object (Date)

Erforderlich. Datum des Flugs in der Zeitzone des Abflughafens. Muss ein Datum in der Gegenwart oder Zukunft sein.

FlightWithEmissions

Direktflug mit Emissionsschätzungen.

JSON-Darstellung 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
Felder
flight

object (Flight)

ID. Entspricht den Flug-IDs in der Anfrage. Hinweis: Alle IATA-Codes werden großgeschrieben.
source

enum (Source)

Optional. Quelle der Emissionsdaten.
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Optional. Emissionsschätzungen pro Passagier. Ist nicht vorhanden, wenn die Emissionen nicht berechnet werden konnten. Eine Liste der Gründe, warum die Emissionen nicht berechnet werden konnten, finden Sie unter flights.computeFlightEmissions.
easaLabelMetadata

object (EasaLabelMetadata)

Optional. Metadaten zum EASA-Label für Flugemissionen. Wird nur festgelegt, wenn die Emissionsdatenquelle die EASA ist.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Optional. Die Bedeutung der Erwärmung durch Kondensstreifen im Vergleich zu den gesamten CO2e-Emissionen.

Quelle

Die Quelle der Emissionsdaten.

Enums
SOURCE_UNSPECIFIED Die Quelle der Emissionsdaten ist nicht angegeben.
TIM Die Emissionsdaten stammen aus dem Travel Impact Model.
EASA Die Emissionsdaten stammen aus den Umweltlabels der EASA.

EasaLabelMetadata

Metadaten zum EASA-Label für Flugemissionen.

JSON-Darstellung 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
Felder
labelIssueDate

object (Date)

Das Datum, an dem das Label ausgestellt wurde.
labelExpiryDate

object (Date)

Das Datum, an dem das Label abläuft. Das Label kann bis zum Ende dieses Datums angezeigt werden.
labelVersion

string

Version des Labels.
safDiscountPercentage

number

Prozentsatz des Emissionsrabatts für nachhaltigen Flugkraftstoff (Sustainable Aviation Fuel, SAF), der auf das Label angewendet wird. Es wird als Dezimalzahl angegeben. Die Werte liegen im Intervall [0,1]. Beispiel: 0,0021 entspricht 0,21%.

Dieser Rabatt und die Reduzierung der Emissionen werden im EASA-Label angegeben, sind aber nicht in den CO2e-Schätzungen enthalten, die von dieser API bereitgestellt werden.

ContrailsImpactBucket

Die Bedeutung der Erwärmung durch Kondensstreifen im Vergleich zu den gesamten CO2e-Emissionen.

Enums
CONTRAILS_IMPACT_UNSPECIFIED Die Auswirkungen von Kondensstreifen sind nicht angegeben.
CONTRAILS_IMPACT_NEGLIGIBLE Die Auswirkungen von Kondensstreifen sind im Vergleich zu den gesamten CO2e-Emissionen vernachlässigbar.
CONTRAILS_IMPACT_MODERATE Die Auswirkungen von Kondensstreifen sind mit den gesamten CO2e-Emissionen vergleichbar.
CONTRAILS_IMPACT_SEVERE Die Auswirkungen von Kondensstreifen sind höher als die gesamten CO2e-Emissionen.