Method: flights.computeFlightEmissions

Zustandslose Methode zum Abrufen von Emissionsschätzungen. Details zur Berechnung der Emissionen: https://github.com/google/travel-impact-model

Die Antwort enthält alle Einträge in derselben Reihenfolge, die mit den Eingabe-Flight-Abschnitten übereinstimmen. Wenn für einen bestimmten Streckenabschnitt keine Schätzungen verfügbar sind, wird in der Antwort das Streckenabschnitt-Objekt mit leeren Emissionsfeldern zurückgegeben. Die Anfrage gilt dennoch als erfolgreich. Gründe für fehlende Schätzungen der Emissionen:

  • Der Flight ist dem Server nicht bekannt.
  • Im Eingabe-Flight-Abschnitt fehlt mindestens eine Kennung.
  • Die Laufzeit liegt in der Vergangenheit.
  • Der Flugzeugtyp wird vom Modell nicht unterstützt.
  • Sitzkonfiguration fehlt.

Die Anfrage kann bis zu 1.000 Flugabschnitte enthalten. Wenn die Anfrage mehr als 1.000 Direktflüge enthält, schlägt bei den Werten INVALID_ARGUMENT fehl.

HTTP-Anfrage

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

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 Rückgabe von geschätzten Emissionen.

Antworttext

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

Ausgabedefinition für die Antwort [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions].

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

object (FlightWithEmissions)

Liste der Streckenabschnitte mit geschätzten Emissionen.
modelVersion

object (ModelVersion)

Die Modellversion, unter der die geschätzten Emissionen für alle Flüge in dieser Antwort berechnet wurden.

Fahrt

Alle Details zu einem einzelnen Element, das nach einer Schätzung der Emissionen eines direkten Flugs angefragt wird.

JSON-Darstellung 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
Felder
origin

string

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

string

Erforderlich. IATA-Flughafencode des Flugziels, z. B. „SXF“
operatingCarrierCode

string

Erforderlich. IATA-Code des Mobilfunkanbieters, z.B. „AA“.
flightNumber

integer

Erforderlich. Flugnummer, z.B. 324.
departureDate

object (Date)

Erforderlich. Flugdatum in der Zeitzone des Startflughafens Das Datum muss in der Gegenwart oder in der Zukunft liegen.

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Tageszeit und Zeitzone werden entweder an anderer Stelle angegeben oder sind unbedeutend. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes bedeuten:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag ungleich null.
  • Monat und Tag mit einem Jahr 0 (z. B. ein Jahrestag)
  • Ein Jahr für sich allein, mit einem Monat 0 und einem Tag 0.
  • Ein Jahr und ein Monat mit einem Tag null (z. B. das Ablaufdatum einer Kreditkarte).

Ähnliche Typen:

JSON-Darstellung 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen, oder 0, um ein Datum ohne Jahr anzugeben.
month

integer

Monat eines Jahres. Muss zwischen 1 und 12 liegen, oder 0, um ein Jahr ohne Monat und Tag anzugeben.
day

integer

Tag eines Monats Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Mit 0 können Sie ein Jahr allein oder ein Jahr und einen Monat angeben, bei dem der Tag nicht von Bedeutung ist.

FlightWithEmissions

Direktflug mit geschätzten Emissionen.

JSON-Darstellung 
{
  "flight": {
    object (Flight)
  },
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Felder
flight

object (Flight)

Erforderlich. Gleicht die Flug-IDs in der Anfrage ab. Hinweis: Alle IATA-Codes werden großgeschrieben.
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Optional. Geschätzte Emissionen pro Passagier. Ist nicht vorhanden, wenn keine Emissionen berechnet werden konnten. Eine Liste der Gründe, warum Emissionen nicht berechnet werden konnten, finden Sie unter [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions].

EmissionsGramsPerPax

Ergebnisse der gruppierten Emissionen pro Sitzklasse.

JSON-Darstellung 
{
  "first": integer,
  "business": integer,
  "premiumEconomy": integer,
  "economy": integer
}
Felder
first

integer

Emissionen eines Passagiers in der ersten Klasse in Gramm. Dieses Feld wird immer berechnet und ausgefüllt, unabhängig davon, ob das Flugzeug First-Class-Sitze hat oder nicht.
business

integer

Emissionen eines Passagiers in der Business Class in Gramm. Dieses Feld wird immer berechnet und ausgefüllt, unabhängig davon, ob das Flugzeug über Sitze in der Business Class verfügt oder nicht.
premiumEconomy

integer

Emissionen eines Passagiers in der Premium Economy Class in Gramm. Dieses Feld wird immer berechnet und ausgefüllt, unabhängig davon, ob das Flugzeug Premium-Sitzplätze in der Economy Class hat oder nicht.
economy

integer

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

ModelVersion

Version des Travel Impact Model. Weitere Informationen zur Modellversionsverwaltung finden Sie unter https://github.com/google/travel-impact-model/#versioning.

JSON-Darstellung 
{
  "major": integer,
  "minor": integer,
  "patch": integer,
  "dated": string
}
Felder
major

integer

Hauptversionen: Größere Änderungen an der Methodik, z.B. das Hinzufügen neuer Datenquellen zum Modell, die zu erheblichen Ausgabeänderungen führen. Solche Änderungen werden nur selten vorgenommen und rechtzeitig im Voraus angekündigt. Möglicherweise werden API-Versionsänderungen vorgenommen, die den Richtlinien unter https://cloud.google.com/endpoints/docs/openapi/versioning-an-api#backwards-incompatible entsprechen.
minor

integer

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

integer

Patchversionen: Implementierungsänderungen zur Behebung von Fehlern oder Ungenauigkeiten in der Modellimplementierung.
dated

string

Datierte Versionen: Modell-Datasets werden mit aktualisierten Eingabedaten, jedoch ohne regelmäßige Änderung der Algorithmen, neu erstellt.