Method: flights.computeDetailedFlightEmissions

Ruft detaillierte Schätzungen der Emissionen ab.

Detaillierte Flugemissionen sind transparente Schätzungen der Treibhausgasemissionen pro Passagier, die durch umfassende Metadaten ergänzt werden, in denen die Berechnungsmethode, die Aufschlüsselung der Emissionen, die Auswirkungen von Kondensstreifen und die Datenherkunft beschrieben werden.

Details zur Berechnung von Emissionsschätzungen finden Sie auf GitHub.

Die Antwort enthält alle Einträge, die mit den eingegebenen Flugabschnitten übereinstimmen, in derselben Reihenfolge. Wenn für einen bestimmten Flugabschnitt keine Schätzungen verfügbar sind, wird das Flugabschnittsobjekt mit leeren Emissionsfeldern zurückgegeben. Die Anfrage gilt weiterhin als erfolgreich. Gründe für fehlende Emissionsschätzungen:

  • Der Flug ist dem Server nicht bekannt.
  • Für den eingegebenen Flugabschnitt fehlen eine oder mehrere Kennungen.
  • Das Flugdatum liegt in der Vergangenheit.
  • Der Flugzeugtyp wird vom Modell nicht unterstützt.
  • Fehlende Konfiguration der Nutzerlizenzen.

Die Anfrage kann bis zu 100 Flugsegmente enthalten. Wenn die Anfrage mehr als 100 Flugabschnitte enthält, schlägt sie mit dem Fehler INVALID_ARGUMENT fehl.

HTTP-Anfrage

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

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 Schätzungen zum CO₂-Ausstoß zurückgegeben werden sollen.

Antworttext

Ausgabedefinition für die flights.computeDetailedFlightEmissions-Antwort.

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

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

object (FlightWithDetailedEmissions)

Liste der Flugsegmente mit Schätzungen zum CO₂-Ausstoß.
modelVersion

object (ModelVersion)

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

FlightWithDetailedEmissions

Direktflug mit Details zu geschätzten Emissionen.

JSON-Darstellung 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
Felder
flight

object (Flight)

Nur Ausgabe. Entspricht den Flight-IDs in der Anfrage. Hinweis: Alle IATA-Codes werden großgeschrieben.
flightEmissionsDetails

object (FlightEmissionsDetails)

Nur Ausgabe. Alle Daten zu Flugemissionen.
emissionsMetadata

object (EmissionsMetadata)

Nur Ausgabe. Zusätzliche Metadaten zur Berechnung der Flugemissionen.

FlightEmissionsDetails

Details zu den Emissionen des jeweiligen Flugs.

JSON-Darstellung 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
Felder
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Nur Ausgabe. Geschätzte Emissionszahlen pro Passagier. Wird nicht angezeigt, wenn die Emissionen nicht berechnet werden konnten. Eine Liste der Gründe, warum die Emissionen nicht berechnet werden konnten, finden Sie unter flights.computeDetailedFlightEmissions.
emissionsBreakdown

object (EmissionsBreakdown)

Nur Ausgabe. Details zu den verschiedenen Emissionsanteilen des Gesamtwerts „GramsPerPax“. Der Wert der summierten Aufschlüsselungen sollte immer „emissionsGramsPerPax“ entsprechen.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Nur Ausgabe. Die Bedeutung der Erwärmung durch Kondensstreifen im Vergleich zu den gesamten CO₂e-Emissionen.
source

enum (Source)

Nur Ausgabe. Die Quelle der Emissionsdaten.

EmissionsBreakdown

Details zu den verschiedenen Emissionsanteilen des Gesamtwerts „GramsPerPax“. Der Wert der summierten Aufschlüsselungen sollte immer „emissionsGramsPerPax“ entsprechen.

JSON-Darstellung 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Felder
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Geschätzte Well-to-Tank-Emissionen pro Passagier. Wird nicht angezeigt, wenn die Emissionen nicht berechnet werden konnten. Eine Liste der Gründe, warum Emissionen nicht berechnet werden konnten, finden Sie unter flights.computeFlightEmissions.
ttwEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Geschätzte Tank-to-Wake-Emissionswerte pro Passagier. Wird nicht angezeigt, wenn die Emissionen nicht berechnet werden konnten. Eine Liste der Gründe, warum Emissionen nicht berechnet werden konnten, finden Sie unter flights.computeFlightEmissions.

EmissionsMetadata

Alle zusätzlichen Metadaten.

JSON-Darstellung 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
Felder
emissionsProvenance

object (EmissionsProvenance)

Nur Ausgabe. Details zur Herkunft der Daten, die zur Berechnung der Emissionsdaten verwendet werden, einschließlich der Faktoren mit ihren Datenquellen.
easaLabelMetadata

object (EasaLabelMetadata)

Nur Ausgabe. Metadaten zum EASA-Label für Flugemissionen. Nur festgelegt, wenn die Emissionsdatenquelle EASA ist.
timWebsiteEmissionsCalculatorUrl

string

Nur Ausgabe. Link zur Website des travelimpactmodel.org-Emissionsrechners. Beispiel: https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225.

EmissionsProvenance

Informationen zur Herkunft der Daten, die zur Berechnung der Emissionsschätzungen verwendet werden, einschließlich der beitragenden Faktoren und ihrer Datenquellen.

JSON-Darstellung 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
Felder
provenanceEntries[]

object (EmissionsProvenance.EmissionsProvenanceEntry)

Nur Ausgabe. Alle Faktoren, die zur Berechnung der Emissionen verwendet werden.

EmissionsProvenance.EmissionsProvenanceEntry

Details zu einem einzelnen Faktor, der zur Berechnung der Emissionen beiträgt.

JSON-Darstellung 
{
  "provenanceEntryType": enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType),
  "source": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource),
  "sourceVersion": string,
  "dataCategory": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory),

  // Union field data_strategy can be only one of the following:
  "fuelBurnEeaStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy),
  "loadFactorsT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy),
  "loadFactorsChAviationStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy),
  "cargoMassFractionT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy),
  "seatAreaRatioIataStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy),
  "distanceAdjustmentStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)
  // End of list of possible types for union field data_strategy.

  // Union field data_value can be only one of the following:
  "loadFactorsData": number,
  "cargoMassFractionData": number,
  "seatAreaRatioData": {
    object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)
  },
  "estimatedFlightDistanceKm": integer
  // End of list of possible types for union field data_value.
}
Felder
provenanceEntryType

enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType)

Nur Ausgabe. Der Typ des Herkunftseintrags.
source

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource)

Nur Ausgabe. Die Quelle der Daten.
sourceVersion

string

Nur Ausgabe. Die Version der Quelldaten. Beispiel: „2025/04“.
dataCategory

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory)

Nur Ausgabe. Datenkategorie der Datenquelle.
Union-Feld data_strategy. Die Strategie, die zum Berechnen der Emissionen für die angegebene Datenquelle verwendet wird. Die Feldgruppe entspricht dem Typ der Datenquelle. Für data_strategy ist nur einer der folgenden Werte zulässig:
fuelBurnEeaStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy)

Nur Ausgabe. Strategie für den Kraftstoffverbrauch im EWR.
loadFactorsT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy)

Nur Ausgabe. Strategie für T100-Auslastungsfaktoren.
loadFactorsChAviationStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy)

Nur Ausgabe. Strategie für die Auslastungsfaktoren von CH Aviation.
cargoMassFractionT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy)

Nur Ausgabe. Strategie für den Massenanteil der Fracht bei T100.
seatAreaRatioIataStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy)

Nur Ausgabe. Strategie für IATA-Sitzplatzbereichsverhältnisse.
distanceAdjustmentStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)

Nur Ausgabe. Strategie für die Distanzanpassung.
Union-Feld data_value. Der Datenwert für die angegebene Datenquelle. Der Feldsatz entspricht dem provenance_entry_type. Für data_value ist nur einer der folgenden Werte zulässig:
loadFactorsData

number

Nur Ausgabe. Der Datenwert für die Lastfaktoren. Wenn nicht festgelegt, ist der Wert für die Ladefaktoren nicht verfügbar.
cargoMassFractionData

number

Nur Ausgabe. Der Wert des Frachtmassenanteils. Wenn er nicht festgelegt ist, ist der Wert für den Frachtmassenanteil nicht verfügbar.
seatAreaRatioData

object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)

Nur Ausgabe. Der Wert für das Sitzplatzflächenverhältnis für jede Buchungsklasse. Wenn nicht festgelegt, ist der Wert für das Sitzbereichsverhältnis nicht verfügbar.
estimatedFlightDistanceKm

integer

Nur Ausgabe. Die geschätzte Flugdistanz in der CCD-Flugphase in Kilometern, berechnet mit dem Distanzanpassungsfaktor (Distance Adjustment Factor, DAF). Wenn nicht festgelegt, ist der geschätzte Wert für die Flugdistanz nicht verfügbar.

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

Der Typ des Herkunftseintrags. In Zukunft werden möglicherweise neue Werte hinzugefügt. Clients sollten darauf vorbereitet sein, unbekannte ENUM-Werte ordnungsgemäß zu verarbeiten.

Enums
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED Nicht angegebener Herkunftseintragstyp.
FUEL_BURN Typ des Eintrags für den Kraftstoffverbrauch.
LOAD_FACTORS Eintragstyp für Ladefaktoren.
CARGO_MASS_FRACTION Eintragstyp für den Massenanteil der Ladung.
SEATING_CONFIG Eintragstyp für die Sitzkonfiguration.
SEAT_AREA_RATIOS Eintragstyp: Verhältnis der Sitzfläche.
DISTANCE_ADJUSTMENT Eintragstyp für die Distanzanpassung.

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

Die Datenquelle für die Faktoren zur Herkunft von Emissionen. In Zukunft werden möglicherweise neue Werte hinzugefügt. Clients sollten darauf vorbereitet sein, unbekannte ENUM-Werte ordnungsgemäß zu verarbeiten.

Enums
DATA_SOURCE_UNSPECIFIED Datenquelle nicht angegeben
EEA Daten der Europäischen Umweltagentur (EUA).
T100 Daten aus dem T-100-Dataset, das vom US Bureau of Transportation Statistics bereitgestellt wird.
CH_AVIATION Daten bereitgestellt von ch-aviation.
OAG Daten bereitgestellt vom Official Aviation Guide (OAG).
OPERATING_CARRIER Daten, die vom ausführenden Transportunternehmen bereitgestellt werden.
AIRCRAFT_MODEL_TYPICAL Typische Daten basierend auf dem Flugzeugmodell.
GLOBAL_DEFAULT Ein globaler Standardwert, der verwendet wird, wenn keine andere Datenquelle verfügbar ist.
IATA Daten der International Air Transport Association (IATA).
ICL Daten bereitgestellt vom Imperial College London.

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

Strategie für den Kraftstoffverbrauch im EWR. In Zukunft werden möglicherweise neue Werte hinzugefügt. Clients sollten darauf vorbereitet sein, unbekannte ENUM-Werte ordnungsgemäß zu verarbeiten.

Enums
STRATEGY_UNSPECIFIED Strategie nicht angegeben.
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR Es wurde ein statischer Korrekturfaktor angewendet.
AIRCRAFT_MAPPING_EXACT Es wurde eine genaue Flugzeugzuordnung verwendet.
AIRCRAFT_MAPPING_FALLBACK Es wurde eine Fallback-Flugzeugzuordnung verwendet.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

Strategie für T100-Auslastungsfaktoren. In Zukunft werden möglicherweise neue Werte hinzugefügt. Clients sollten darauf vorbereitet sein, unbekannte ENUM-Werte ordnungsgemäß zu verarbeiten.

Enums
STRATEGY_UNSPECIFIED Strategie nicht angegeben.
CARRIER_ROUTE_MONTH Daten nach Fluggesellschaft, Route und Reisemonat.
CARRIER_MONTH Daten nach Fluggesellschaft und Reisemonat.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH Verlaufsdaten, die mit dem Transportunternehmen, der Route, dem Jahr und dem Monat übereinstimmen.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

Strategie für die Auslastungsfaktoren von CH-Aviation. In Zukunft werden möglicherweise neue Werte hinzugefügt. Clients sollten darauf vorbereitet sein, unbekannte ENUM-Werte ordnungsgemäß zu verarbeiten.

Enums
STRATEGY_UNSPECIFIED Strategie nicht angegeben.
CARRIER_MONTH Daten nach Fluggesellschaft und Reisemonat.
ACTUAL_CARRIER_YEAR_MONTH Verlaufsdaten, die mit dem Mobilfunkanbieter, dem Jahr und dem Monat übereinstimmen.

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

Strategie für den Massenanteil der Fracht bei T100. In Zukunft werden möglicherweise neue Werte hinzugefügt. Clients sollten darauf vorbereitet sein, unbekannte ENUM-Werte ordnungsgemäß zu verarbeiten.

Enums
STRATEGY_UNSPECIFIED Strategie nicht angegeben.
CARRIER_ROUTE_AIRCRAFT_CLASS Daten nach Transportunternehmen, Route und Flugzeugklasse.
ROUTE_AIRCRAFT_CLASS Daten nach Route und Flugzeugklasse.
DISTANCE_AIRCRAFT_CLASS Daten nach Distanzbereich und Flugzeugklasse.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS Verlaufsdaten, die mit der Fluggesellschaft, der Route, dem Jahr, dem Monat und der Flugzeugklasse übereinstimmen.

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

Strategie für IATA-Sitzplatzbereichsverhältnisse. In Zukunft werden möglicherweise neue Werte hinzugefügt. Clients sollten darauf vorbereitet sein, unbekannte ENUM-Werte ordnungsgemäß zu verarbeiten.

Enums
STRATEGY_UNSPECIFIED Strategie nicht angegeben.
NARROW_AIRCRAFT_BODY Es wurden die Sitzplatzverhältnisse für Schmalrumpfflugzeuge verwendet.
WIDE_AIRCRAFT_BODY Es wurden die Sitzplatzverhältnisse für Großraumflugzeuge verwendet.

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

Strategie für die Distanzanpassung. In Zukunft werden möglicherweise neue Werte hinzugefügt. Clients sollten darauf vorbereitet sein, unbekannte ENUM-Werte ordnungsgemäß zu verarbeiten.

Enums
STRATEGY_UNSPECIFIED Strategie nicht angegeben.
ORIGIN_DESTINATION Faktor zur Anpassung der Entfernung, der anhand des Paars aus Start- und Zielflughafen ermittelt wird.
COUNTRY_PAIR Entfernungsanpassungsfaktor, der durch das Herkunfts- und Ziellandpaar bestimmt wird.
DEFAULT Der Anpassungsfaktor für die Entfernung basiert auf dem Standardwert, da wir keinen flughafen- oder länderspezifischen Anpassungsfaktor gefunden haben.

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

Die Datenkategorie der Datenquelle. In Zukunft werden möglicherweise neue Werte hinzugefügt. Clients sollten darauf vorbereitet sein, unbekannte ENUM-Werte ordnungsgemäß zu verarbeiten.

Enums
DATA_CATEGORY_UNSPECIFIED Datenkategorie nicht angegeben.
PRIMARY Primärdaten gemäß ISO 14083.
MODELED Modellierte Daten gemäß ISO 14083.
DEFAULT Standardwertdaten gemäß ISO 14083.