Method: flights.computeScope3FlightEmissions

Ruft Schätzungen zu Treibhausgasemissionen für eine Reihe von Flugsegmenten für die Scope-3-Berichterstellung ab.

Die Antwort enthält alle Einträge, die mit den eingegebenen Scope3FlightSegment-Flugsegmenten übereinstimmen, in der angegebenen Reihenfolge. Die Schätzungen werden anhand der folgenden kaskadierenden Logik berechnet (wobei die erste verfügbare Option verwendet wird):

  1. TIM-basierte Emissionen für origin, destination, carrier, flightNumber, departureDate und cabinClass.
  2. Typische Flugemissionen für origin, destination, Jahr in departureDate und cabinClass.
  3. Entfernungsbasierte Emissionen, berechnet anhand von distanceKm, Jahr in departureDate und cabinClass.

Wenn in diesem Kalenderjahr ein zukünftiger Flug angefragt wird, werden Emissionen der Stufe 1 nicht unterstützt und wir greifen auf Emissionen der Stufe 2 oder 3 zurück. Wenn der angeforderte zukünftige Flug nicht in diesem Kalenderjahr liegt, wird eine leere Antwort zurückgegeben. Wir empfehlen, für zukünftige Flüge stattdessen die computeFlightEmissions API zu verwenden.

Wenn für einen bestimmten Flug mit keiner der drei Methoden Schätzungen verfügbar sind, wird in der Antwort ein Scope3FlightEmissions-Objekt mit leeren Emissionsfeldern zurückgegeben. Die Anfrage wird trotzdem als erfolgreich betrachtet. In der Regel fehlen Emissionsschätzungen, wenn der Flug dem Server nicht bekannt ist (z.B. wenn kein bestimmter Flug existiert oder für das angeforderte Paar keine üblichen Flugemissionen verfügbar sind).

Die Anfrage schlägt mit dem Fehler INVALID_ARGUMENT fehl, wenn:

  • Die Anfrage enthält mehr als 1.000 Flugstrecken.
  • In der Eingabe für den Flugabschnitt fehlen eine oder mehrere Kennungen. Beispiel: Fehlender Start-/Zielort ohne gültige Entfernung für den Typabgleich TIM_EMISSIONS oder TYPICAL_FLIGHT_EMISSIONS oder fehlende Entfernung für den Typabgleich DISTANCE_BASED_EMISSIONS (wenn Sie auf entfernungsbasierte Emissionen zurückgreifen oder eine entfernungsbasierte Emissionsschätzung möchten, müssen Sie eine Entfernung angeben).
  • Das Flugdatum liegt vor 2019 (Scope-3-Daten sind nur für 2019 und später verfügbar).
  • Die Flugdistanz ist 0 oder niedriger.
  • Kabinenklasse fehlt.

Da die Anfrage mit einer Fallback-Logik verarbeitet wird, ist es möglich, dass falsch konfigurierte Anfragen gültige Emissionsschätzungen mithilfe von Fallback-Methoden zurückgeben. Wenn eine Anfrage beispielsweise die falsche Flugnummer enthält, aber den Abflug- und Zielort angibt, ist die Anfrage trotzdem erfolgreich. Die zurückgegebenen Emissionen basieren dann jedoch ausschließlich auf den typischen Flugemissionen. Wenn in einer Anfrage der Abflugort für eine typische Anfrage zu Flugemissionen fehlt, aber eine gültige Entfernung angegeben ist, kann die Anfrage allein auf Grundlage der entfernungsbasierten Emissionen erfolgreich sein. Daher sollten Sie die Quelle der zurückgegebenen Emissionen (source) prüfen, um sicherzustellen, dass die Ergebnisse wie erwartet sind.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object (Scope3FlightSegment)

Erforderlich. Flüge, für die Schätzungen zum CO₂-Ausstoß zurückgegeben werden sollen.
modelVersion

object (ModelVersion)

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

Antworttext

Eine Liste von Flügen mit Schätzungen zu Scope-3-Emissionen.

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

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

object (Scope3FlightEmissions)

Liste der Flugsegmente mit geschätzten Emissionen.
modelVersion

object (ModelVersion)

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

Scope3FlightSegment

Flugparameter, mit denen die Scope-3-Emissionen abgerufen werden.

JSON-Darstellung 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Felder
departureDate

object (Date)

Erforderlich. Datum des Fluges in der Zeitzone des Abflughafens. Für typische Flug- und entfernungsbasierte Emissionsmodelle ist nur das Jahr erforderlich. Die Werte für Monat und Tag werden ignoriert und können daher entweder weggelassen, auf 0 gesetzt oder auf ein gültiges Datum festgelegt werden. Wenn für TIM-Emissionen kein bestimmtes Datum angegeben ist, greifen wir auf die üblichen Flugemissionen (oder entfernungsbasierten Emissionen) zurück.
cabinClass

enum (Scope3FlightSegment.CabinClass)

Erforderlich. Die Kabinenklasse des Flugs.
origin

string

Optional. IATA-Flughafencode mit 3 Zeichen für den Abflughafen, z.B. YVR. Wird verwendet, um einen bestimmten Flug abzugleichen, wenn sie zusammen mit dem Ziel, der Fluggesellschaft und der Flugnummer angegeben wird. Wenn es keine Übereinstimmung gibt, versuchen wir zuerst, den Flug einem typischen Flug zwischen dem angegebenen Start- und Zielflughafen zuzuordnen. Andernfalls wird das entfernungsbasierte Emissionsmodell verwendet, sofern die Flugentfernung angegeben ist.
destination

string

Optional. IATA-Flughafencode mit 3 Zeichen für das Flugziel, z.B. ICN. Wird verwendet, um einen bestimmten Flug zuzuordnen, wenn er zusammen mit dem Abflugort, der Fluggesellschaft und der Flugnummer angegeben wird. Wenn es keine Übereinstimmung gibt, versuchen wir zuerst, den Flug einem typischen Flug zwischen dem angegebenen Start- und Zielflughafen zuzuordnen. Andernfalls wird das entfernungsbasierte Emissionsmodell verwendet, sofern die Flugentfernung angegeben ist.
carrierCode

string

Optional. Zweistelliger IATA-Code für Transportunternehmen, z.B. KE. Dies ist erforderlich, wenn ein Abgleich mit bestimmten Flügen gewünscht ist. Andernfalls wird dieser Wert für typische Flug- und entfernungsbasierte Emissionsmodelle nicht verwendet. Dies kann sowohl der Code der ausführenden als auch der vermarktenden Fluggesellschaft sein (d.h. Codesharing ist abgedeckt).
flightNumber

integer

Optional. Bis zu 4-stellige Flugnummer, z.B. 71, von [1, 9999]. Diese wird zuerst verwendet, um einen bestimmten Flug abzugleichen, wenn eine Flugnummer zusammen mit Start, Ziel und Fluggesellschaft angegeben ist. Wenn keine Flugnummer angegeben ist, versuchen wir zuerst, den Flug einem typischen Flug zwischen dem angegebenen Abflug- und Zielflughafen zuzuordnen. Wenn das nicht funktioniert und/oder Start- und Zielort nicht angegeben sind, verwenden wir das entfernungsbasierte Emissionsmodell basierend auf der angegebenen Flugstrecke.
distanceKm

string (int64 format)

Optional. Entfernung in Kilometern, z.B. 2423, von [1, 1e12) km. Damit wird ein Flug den entfernungsbasierten Emissionen zugeordnet, wenn Start- und Zielort nicht angegeben sind oder keine passenden typischen Flüge vorhanden sind.

Scope3FlightSegment.CabinClass

Die Kabinenklasse des Flugs.

Enums
CABIN_CLASS_UNSPECIFIED Nicht angegebene Kabinenklasse.
ECONOMY Economy Class.
PREMIUM_ECONOMY Premium Economy Class.
BUSINESS Business Class.
FIRST First Class.

Scope3FlightEmissions

Scope-3-Flug mit geschätzten Emissionen.

JSON-Darstellung 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType),
  "modelVersion": string
}
Felder
flight

object (Scope3FlightSegment)

ID. Stimmt mit den Flugkennungen in der Anfrage überein.
wtwEmissionsGramsPerPax

string (int64 format)

Optional. Gesamtemissionen des Flugs (Summe aus Well-to-Tank und Tank-to-Wake) pro Passagier basierend auf den angeforderten Informationen. Dies sind die Gesamtemissionen. Sofern Sie keine bestimmten Gründe für die Verwendung von TTW- oder WTT-Emissionen haben, sollten Sie diese Zahl verwenden.
ttwEmissionsGramsPerPax

string (int64 format)

Optional. Tank-to-Wake-Flugemissionen pro Passagier basierend auf den angeforderten Informationen.
wttEmissionsGramsPerPax

string (int64 format)

Optional. Well-to-Tank-Flugemissionen pro Passagier basierend auf den angeforderten Informationen.
source

enum (Scope3FlightEmissions.Scope3DataType)

Optional. Die Quelle der Emissionsdaten.
modelVersion

string

Optional. Die Modellversion, mit der die Emissionen berechnet wurden.

Scope3FlightEmissions.Scope3DataType

Die Art des Abgleichs, die zur Berechnung von Scope-3-Emissionen verwendet wird. Dies wird für die Scope-3-Antwort verwendet, um anzugeben, welche der Methoden zur Berechnung der Emissionen verwendet wurde.

Enums
SCOPE3_DATA_TYPE_UNSPECIFIED Nicht angegebener Datentyp.
TIM_EMISSIONS TIM-basierte Emissionen nach Abflugort, Zielort, Fluggesellschaft, Flugnummer, Abflugdatum und Jahr.
TYPICAL_FLIGHT_EMISSIONS Übliche Flugemissionen für einen bestimmten Abflugort, ein bestimmtes Reiseziel und ein bestimmtes Jahr.
DISTANCE_BASED_EMISSIONS Entfernungsbasierte Emissionen basierend auf der zurückgelegten Strecke und dem Jahr.