Method: flights.computeScope3FlightEmissions

Zustandslose Methode zum Abrufen von Schätzungen der Treibhausgasemissionen für eine Reihe von Flugsegmenten für die Berichterstattung zu Scope 3.

Die Antwort enthält alle Einträge, die den eingegebenen Scope3FlightSegment-Flugsegmenten entsprechen, in derselben Reihenfolge wie angegeben. Die Schätzungen werden mit der folgenden Kaskadenlogik berechnet (die erste verfügbare wird verwendet):

  1. TIM-basierte Emissionen bei origin, destination, carrier, flightNumber, departureDate und cabinClass.
  2. Typische Flugemissionen bei origin, destination, Jahr departureDate und cabinClass.
  3. Entfernungsbasierte Emissionen, die mit distanceKm, dem Jahr in departureDate und cabinClass berechnet werden.

Wenn in diesem Kalenderjahr ein zukünftiger Flug angefordert wird, unterstützen wir keine Emissionen der Stufe 1 und greifen auf Emissionen der Stufe 2 oder 3 zurück. Wenn der angeforderte zukünftige Flug nicht in diesem Kalenderjahr liegt, geben wir eine leere Antwort zurück. 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 gilt weiterhin als erfolgreich. Im Allgemeinen fehlen Emissionsschätzungen, wenn der Flug dem Server nicht bekannt ist, z.B. wenn kein bestimmter Flug vorhanden ist oder typische Flugemissionen für das angeforderte Paar nicht verfügbar sind.

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

  • Die Anfrage enthält mehr als 1.000 Flugabschnitte.
  • Für den eingegebenen Flugabschnitt fehlen mindestens eine ID. Beispiele: Ursprung/Ziel fehlt ohne gültige Entfernung für den Typ TIM_EMISSIONS oder TYPICAL_FLIGHT_EMISSIONS oder Entfernung fehlt für den Typ DISTANCE_BASED_EMISSIONS (wenn Sie auf entfernungsbasierte Emissionen zurückgreifen oder eine Schätzung der entfernungsbasierten Emissionen erhalten möchten, müssen Sie eine Entfernung angeben).
  • Das Flugdatum liegt vor 2019. Daten zu Scope 3 sind erst ab 2019 verfügbar.
  • Die Flugdistanz beträgt 0 oder weniger.
  • Kabinenklasse fehlt.

Da die Anfrage mit Fallback-Logik verarbeitet wird, ist es möglich, dass für falsch konfigurierte Anfragen mit Fallback-Methoden gültige Schätzungen der Emissionen zurückgegeben werden. Wenn eine Anfrage beispielsweise die falsche Flugnummer enthält, aber Start- und Zielort angegeben sind, ist die Anfrage trotzdem erfolgreich. Die zurückgegebenen Emissionen basieren dann jedoch ausschließlich auf den typischen Flugemissionen. Wenn bei einer Anfrage beispielsweise der Ursprung für eine typische Anfrage zu Flugemissionen fehlt, aber eine gültige Entfernung angegeben wird, kann die Anfrage nur auf Grundlage der entfernungsbasierten Emissionen erfolgreich sein. Daher sollte die Quelle der zurückgegebenen Emissionen (source) geprüft werden, um sicherzustellen, dass die Ergebnisse den Erwartungen entsprechen.

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 der Emissionen der Kategorie 3.

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 (CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Felder
departureDate

object (Date)

Erforderlich. Das Datum des Fluges in der Zeitzone des Startflughafens. Für typische emissionsbasierte Flug- und Entfernungsmodelle ist nur das Jahr erforderlich. Die Werte für Monat und Tag werden ignoriert und können daher entweder weggelassen, auf 0 oder auf ein gültiges Datum gesetzt werden. Wenn für TIM-Emissionen kein bestimmtes Datum angegeben wird, greifen wir auf die typischen Emissionen für Flüge (oder auf Distanzbasis) zurück.
cabinClass

enum (CabinClass)

Erforderlich. Die Kabinenklasse des Flugs.
origin

string

Optional. IATA-Flughafencode für den Abflugort, z.B. YVR. Wird verwendet, um einen bestimmten Flug abzugleichen, wenn er zusammen mit Zielort, Fluggesellschaft und Flugnummer angegeben wird. Wenn es keine Übereinstimmung gibt, versuchen wir zuerst, den Flug einem typischen Flug zwischen den angegebenen Herkunfts- und Zielflughäfen zuzuordnen. Andernfalls verwenden wir das emissionsbasierte Modell, wenn die Flugdistanz angegeben ist.
destination

string

Optional. IATA-Flughafencode für das Flugziel, z.B. ICN. Wird verwendet, um einen bestimmten Flug abzugleichen, wenn er zusammen mit Abflugort, Fluggesellschaft und Flugnummer angegeben wird. Wenn es keine Übereinstimmung gibt, versuchen wir zuerst, den Flug einem typischen Flug zwischen den angegebenen Herkunfts- und Zielflughäfen zuzuordnen. Andernfalls verwenden wir das emissionsbasierte Modell, wenn die Flugdistanz angegeben ist.
carrierCode

string

Optional. IATA-Code der Fluggesellschaft, z.B. KE. Dies ist erforderlich, wenn bestimmte Flüge abgeglichen werden sollen. Andernfalls wird sie für typische emissionsbasierte Modelle für Flüge und Entfernungen nicht verwendet. Das kann sowohl der Betriebs- als auch der Marketing-Carrier-Code sein (Codeshare ist also abgedeckt).
flightNumber

integer

Optional. Flugnummer, z.B. 71. Sie wird zuerst verwendet, um einen bestimmten Flug abzugleichen, wenn neben Start, Ziel und Fluggesellschaft auch eine Flugnummer angegeben wird. Wenn keine Flugnummer angegeben ist, versuchen wir zuerst, den Flug einem typischen Flug zwischen den angegebenen Herkunfts- und Zielflughäfen zuzuordnen. Wenn das fehlschlägt und/oder Start- und Zielort nicht angegeben sind, verwenden wir das emissionsbasierte Modell auf Grundlage der angegebenen Flugdistanz.
distanceKm

string (int64 format)

Optional. Entfernung in Kilometern, z.B. 2423. Damit werden Flüge mit distanzbezogenen Emissionen abgeglichen, wenn Start- und Zielort nicht angegeben sind oder keine übereinstimmenden typischen Flüge vorhanden sind. Dieses Feld unterstützt Werte zwischen 0 und 2,5e16 km.

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 (Scope3DataType)
}
Felder
flight

object (Scope3FlightSegment)

Erforderlich. Entspricht den Flugkennungen in der Anfrage.
wtwEmissionsGramsPerPax

string (int64 format)

Optional. Gesamtemissionen des Flugs (Summe von „Well-to-Tank“ und „Tank-to-Wake“) pro Passagier basierend auf den angeforderten Informationen. Dies sind die Gesamtemissionen. Sofern Sie keine besonderen 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 (Scope3DataType)

Optional. Die Quelle der Emissionsdaten.

Scope3DataType

Der Typ der Übereinstimmung, der zur Berechnung der Emissionen von Scope 3 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 basierend auf Herkunft, Zielort, Transportunternehmen, Flugnummer, Abflugdatum und Jahr.
TYPICAL_FLIGHT_EMISSIONS Übliche Flugemissionen für Abflugort, Zielort und Jahr.
DISTANCE_BASED_EMISSIONS Entfernungsbasierte Emissionen basierend auf der zurückgelegten Strecke und dem Jahr.