Method: flights.computeScope3FlightEmissions

Statuslose 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 mit den Scope3FlightSegment-Flugsegmenten der Eingabe übereinstimmen, in derselben Reihenfolge. Die Schätzungen werden mit der folgenden kaskadierenden Logik berechnet (die erste verfügbare wird verwendet):

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

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

Wenn für einen bestimmten Flug mit keiner der drei Methoden Schätzungen verfügbar sind, gibt die Antwort ein Scope3FlightEmissions-Objekt mit leeren Emissionsfeldern zurück. Die Anfrage wird trotzdem als erfolgreich betrachtet. Fehlende Emissionsschätzungen treten in der Regel auf, wenn der Flug dem Server unbekannt ist (z.B. wenn kein bestimmter Flug vorhanden ist oder keine typischen Emissionen für das angefragte Paar verfügbar sind).

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

  • Die Anfrage enthält mehr als 1.000 Flugstrecken.
  • In der Eingabe-Flugstrecke fehlen eine oder mehrere IDs. Beispiel: Es fehlen Start- und Zielort ohne gültige Entfernung für eine Übereinstimmung vom Typ TIM_EMISSIONS oder TYPICAL_FLIGHT_EMISSIONS oder es fehlt die Entfernung für eine Übereinstimmung vom 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 nur für 2019 und danach verfügbar.
  • Die Flugentfernung beträgt 0 oder weniger.
  • Die Kabinenklasse fehlt.

Da die Anfrage mit Fallback-Logik verarbeitet wird, ist es möglich, dass falsch konfigurierte Anfragen mit Fallback-Methoden gültige Emissionsschätzungen zurückgeben. Wenn eine Anfrage beispielsweise die falsche Flugnummer hat, aber Start- und Zielort angegeben sind, ist die Anfrage trotzdem erfolgreich. Die zurückgegebenen Emissionen basieren jedoch ausschließlich auf den typischen Emissionen des Flugs. Wenn in einer Anfrage für typische Emissionen der Startort fehlt, aber eine gültige Entfernung angegeben ist, kann die Anfrage auch nur auf Grundlage der entfernungsbasierten Emissionen erfolgreich sein. Daher sollten Sie die Quelle der zurückgegebenen Emissionen (source) prüfen, um zu bestätigen, 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 Emissionsschätzungen 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 Stufe 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 Emissionsschätzungen.
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 Emissionen der Stufe 3 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. Datum des Flugs in der Zeitzone des Abflughafens. Für Modelle für typische Emissionen und entfernungsbasierte Emissionen ist nur das Jahr erforderlich. Die Werte für Monat und Tag werden ignoriert und können daher entweder weggelassen, auf 0 gesetzt oder für diese Fälle auf ein gültiges Datum gesetzt werden. Wenn für TIM-Emissionen kein bestimmtes Datum angegeben wird, greifen wir auf typische Emissionen (oder entfernungsbasierte Emissionen) zurück.
cabinClass

enum (CabinClass)

Erforderlich. Die Kabinenklasse des Flugs.
origin

string

Optional. IATA-Flughafencode mit drei Zeichen für den Abflughafen, z.B. YVR. Dieser wird verwendet, um einen bestimmten Flug abzugleichen, wenn er zusammen mit Zielort, Fluggesellschaft und Flugnummer angegeben wird. Wenn keine Übereinstimmung gefunden wird, versuchen wir zuerst, den Flug mit einem typischen Flug zwischen den angegebenen Abflug- und Zielflughäfen abzugleichen. Andernfalls verwenden wir das Modell für entfernungsbasierte Emissionen, wenn die Flugentfernung angegeben ist.
destination

string

Optional. IATA-Flughafencode mit drei Zeichen für den Zielflughafen, z.B. ICN. Dieser wird verwendet, um einen bestimmten Flug abzugleichen, wenn er zusammen mit Startort, Fluggesellschaft und Flugnummer angegeben wird. Wenn keine Übereinstimmung gefunden wird, versuchen wir zuerst, den Flug mit einem typischen Flug zwischen den angegebenen Abflug- und Zielflughäfen abzugleichen. Andernfalls verwenden wir das Modell für entfernungsbasierte Emissionen, wenn die Flugentfernung angegeben ist.
carrierCode

string

Optional. IATA-Code der Fluggesellschaft mit zwei Zeichen, z.B. KE. Dieser ist erforderlich, wenn ein bestimmter Flug abgeglichen werden soll. Andernfalls wird er für Modelle für typische Emissionen und entfernungsbasierte Emissionen nicht verwendet. Dies kann sowohl der Code der ausführenden als auch der Marketing-Fluggesellschaft sein (d.h. Codesharing wird berücksichtigt).
flightNumber

integer

Optional. Flugnummer mit bis zu vier Ziffern, z.B. 71, aus [1, 9999]. Diese wird zuerst verwendet, um einen bestimmten Flug abzugleichen, wenn eine Flugnummer zusammen mit Startort, Zielort und Fluggesellschaft angegeben wird. Wenn keine Flugnummer angegeben ist, versuchen wir zuerst, den Flug mit einem typischen Flug zwischen den angegebenen Abflug- und Zielflughäfen abzugleichen. Wenn das fehlschlägt und/oder Start- und Zielort nicht angegeben sind, verwenden wir das Modell für entfernungsbasierte Emissionen auf Grundlage der angegebenen Flugentfernung.
distanceKm

string (int64 format)

Optional. Entfernung in Kilometern, z. B. 2423, aus [1, 2,5e16) km. Diese wird verwendet, um einen Flug mit entfernungsbasierten Emissionen abzugleichen, wenn Start- und Zielort nicht angegeben sind oder keine übereinstimmenden typischen Flüge vorhanden sind.

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

Flug der Stufe 3 mit Emissionsschätzungen.

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

object (Scope3FlightSegment)

ID. Entspricht den Flug-IDs in der Anfrage.
wtwEmissionsGramsPerPax

string (int64 format)

Optional. Gesamte Emissionen des Flugs (Summe von „Well-to-Tank“ und „Tank-to-Wake“) pro Passagier basierend auf den angefragten 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. Emissionen des Flugs von „Tank-to-Wake“ pro Passagier basierend auf den angefragten Informationen.
wttEmissionsGramsPerPax

string (int64 format)

Optional. Emissionen des Flugs von „Well-to-Tank“ pro Passagier basierend auf den angefragten Informationen.
source

enum (Scope3DataType)

Optional. Die Quelle der Emissionsdaten.

Scope3DataType

Der Typ der Übereinstimmung, der zur Berechnung der Emissionen der Stufe 3 verwendet wird. Dieser wird für die Antwort zu Scope 3 verwendet und gibt an, welche der Methoden zur Berechnung der Emissionen verwendet wurde.

Enums
SCOPE3_DATA_TYPE_UNSPECIFIED Nicht angegebener Datentyp.
TIM_EMISSIONS TIM-basierte Emissionen für Startort, Zielort, Fluggesellschaft, Flugnummer, Abflugdatum und Jahr.
TYPICAL_FLIGHT_EMISSIONS Typische Emissionen für Flüge für Startort, Zielort und Jahr.
DISTANCE_BASED_EMISSIONS Entfernungsbasierte Emissionen basierend auf der zurückgelegten Entfernung und dem Jahr.