Package google.travel.sustainability.travelimpactmodel.v1

Index

TravelImpactModelService

API zur Bereitstellung von Schätzungen des CO₂-Ausstoßes.

ComputeFlightEmissions

rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse)

Zustandslose Methode zum Abrufen von Emissionsschätzungen. Weitere Informationen 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 mindestens eine ID.
  • Das Flugdatum liegt in der Vergangenheit.
  • Der Flugzeugtyp wird vom Modell nicht unterstützt.
  • Fehlende Konfiguration der Nutzerlizenzen.

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

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse)

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.
ComputeTypicalFlightEmissions

rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse)

Ruft Schätzungen der typischen Flugemissionen zwischen zwei Flughäfen (auch als Markt bezeichnet) ab. Wenn für einen bestimmten Markt keine Schätzungen verfügbar sind, wird das Marktobjekt mit leeren Emissionsfeldern zurückgegeben. Die Anfrage gilt weiterhin als erfolgreich.

Details zur Berechnung der typischen Emissionsschätzungen finden Sie auf GitHub.

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

ComputeFlightEmissionsRequest

Eingabedefinition für die ComputeFlightEmissions-Anfrage.

Felder
flights[]

Flight

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

ComputeFlightEmissionsResponse

Ausgabedefinition für die ComputeFlightEmissions-Antwort.

Felder
flight_emissions[]

FlightWithEmissions

Liste der Flugabschnitte mit geschätzten Emissionen.
model_version

ModelVersion

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

ComputeScope3FlightEmissionsRequest

Eine Liste der Flugsegmente, für die die Scope 3-Emissionen angefordert werden sollen.

Felder
flights[]

Scope3FlightSegment

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

ModelVersion

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

ComputeScope3FlightEmissionsResponse

Eine Liste von Flügen mit Schätzungen der Emissionen der Kategorie 3.

Felder
flight_emissions[]

Scope3FlightEmissions

Liste der Flugsegmente mit geschätzten Emissionen.
model_version

ModelVersion

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

ComputeTypicalFlightEmissionsRequest

Eine Liste von Flughafenpaaren (Märkten), für die die typischen Emissionen angefordert werden sollen.

Felder
markets[]

Market

Erforderlich. Fordern Sie die Schätzungen der üblichen Flugemissionen für dieses Marktpaar an. Es können maximal 1.000 Märkte angefordert werden.

ComputeTypicalFlightEmissionsResponse

Die Antwort enthält die Emissionen, aber auch die Modellversion.

Felder
typical_flight_emissions[]

TypicalFlightEmissions

Die üblichen Flugemissionen des Markts wurden angefordert.
model_version

ModelVersion

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

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 Auswirkungen der gesamten CO₂e-Emissionen.

EasaLabelMetadata

Metadaten zum EASA-Label für Flugemissionen.

Felder
label_issue_date

Date

Das Datum, an dem das Label ausgestellt wurde.
label_expiry_date

Date

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

string

Version des Labels.
saf_discount_percentage

double

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

Dieser Rabatt und die Emissionsreduzierung werden durch das EASA-Label angegeben, sind aber nicht in den CO₂e-Schätzungen enthalten, die von dieser API bereitgestellt werden.

EmissionsGramsPerPax

Ergebnisse für gruppierte Emissionen pro Sitzklasse.

Felder
first

int32

Emissionen für einen Passagier in der First Class in Gramm. Dieses Feld wird immer berechnet und ausgefüllt, unabhängig davon, ob das Flugzeug First-Class-Sitze hat oder nicht.
business

int32

Emissionen für einen Passagier in der Business Class in Gramm. Dieses Feld wird immer berechnet und ausgefüllt, unabhängig davon, ob das Flugzeug Business-Class-Sitze hat oder nicht.
premium_economy

int32

Emissionen für einen Passagier in der Premium Economy Class in Gramm. Dieses Feld wird immer berechnet und ausgefüllt, unabhängig davon, ob das Flugzeug Premium Economy-Sitze hat oder nicht.
economy

int32

Emissionen für einen Passagier in der Economy Class in Gramm. Dieses Feld wird immer berechnet und ausgefüllt, unabhängig davon, ob das Flugzeug Economy-Class-Sitze hat oder nicht.

Flug

Alle Details zu einem einzelnen Anfrageelement für geschätzte Emissionen eines Direktflugs.

Felder
origin

string

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

string

Erforderlich. IATA-Flughafencode für das Flugziel, z.B. „JFK“.
operating_carrier_code

string

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

int32

Erforderlich. Flugnummer, z.B. 324.
departure_date

Date

Erforderlich. Das Datum des Fluges in der Zeitzone des Startflughafens. Muss ein Datum in der Gegenwart oder Zukunft sein.

FlightWithEmissions

Direktflug mit geschätzten Emissionen.

Felder
flight

Flight

Erforderlich. Entspricht den Flugkennungen in der Anfrage. Hinweis: Alle IATA-Codes werden großgeschrieben.
source

Source

Optional. Die Quelle der Emissionsdaten.
emissions_grams_per_pax

EmissionsGramsPerPax

Optional. Geschätzte Emissionszahlen 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 ComputeFlightEmissions.
easa_label_metadata

EasaLabelMetadata

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

ContrailsImpactBucket

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

Markt

Ein Paar Flughäfen.

Felder
origin

string

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

string

Erforderlich. IATA-Flughafencode für das Flugziel, z.B. „JFK“.

ModelVersion

Version des Travel Impact Model. Weitere Informationen zur Modellversionsverwaltung finden Sie auf GitHub.

Felder
major

int32

Hauptversionen: Wesentliche Änderungen an der Methodik, z.B. das Hinzufügen neuer Datenquellen zum Modell, die zu erheblichen Änderungen bei der Ausgabe führen. Solche Änderungen sind selten und werden rechtzeitig angekündigt. Möglicherweise sind Änderungen an der API-Version erforderlich, die den Google Cloud API-Richtlinien entsprechen.
minor

int32

Nebenversionen: Änderungen am Modell, die zwar über alle Schemaversionen hinweg konsistent sind, aber die Modellparameter oder die Implementierung ändern.
patch

int32

Patch-Versionen: Implementierungsänderungen zur Behebung von Fehlern oder Ungenauigkeiten in der Modellimplementierung.
dated

string

Datierte Versionen: Modelldatasets werden regelmäßig mit aktualisierten Eingabedaten neu erstellt, ohne dass die Algorithmen geändert werden.

Scope3FlightEmissions

Scope 3-Flug mit geschätzten Emissionen.

Felder
flight

Scope3FlightSegment

Erforderlich. Entspricht den Flugkennungen in der Anfrage.
wtw_emissions_grams_per_pax

int64

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.
ttw_emissions_grams_per_pax

int64

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

int64

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

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.

Scope3FlightSegment

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

Felder
departure_date

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.
cabin_class

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.
carrier_code

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).
flight_number

int32

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.
distance_km

int64

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

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 von den Umweltkennzeichnungen der EASA.

TypicalFlightEmissions

Geschätzte durchschnittliche Flugemissionen für einen bestimmten Markt

Felder
market

Market

Erforderlich. Entspricht den Flugkennungen in der Anfrage. Hinweis: Alle IATA-Codes werden großgeschrieben.
emissions_grams_per_pax

EmissionsGramsPerPax

Optional. Übliche Emissionen pro Passagier für den angeforderten Markt. Wird nicht angezeigt, wenn keine typischen Emissionen berechnet werden konnten. Eine Liste der Gründe, warum die typischen Flugemissionen nicht berechnet werden konnten, finden Sie auf GitHub.