Method: flights.computeScope3FlightEmissions

Metoda bezstanowa do pobierania szacunkowych danych o emisji gazów cieplarnianych dla zestawu segmentów lotu na potrzeby raportowania w zakresie 3.

Odpowiedź będzie zawierać wszystkie wpisy pasujące do podanych Scope3FlightSegment etapów lotu w tej samej kolejności. Oszacowania będą obliczane przy użyciu tej logiki kaskadowej (zastosowana zostanie pierwsza dostępna wartość):

  1. Emisje na podstawie modelu wpływu podróży dla strumieni origin, destination, carrier, flightNumber, departureDate i cabinClass.
  2. Typowa emisja lotu na trasie origin–destination w departureDate roku, cabinClass.
  3. Emisja na podstawie odległości obliczana przy użyciu distanceKm, roku departureDate i cabinClass.

Jeśli w tym roku kalendarzowym jest zaplanowany lot w przyszłości, nie obsługujemy emisji poziomu 1 i przechodzimy do emisji poziomu 2 lub 3. Jeśli żądany przyszły lot nie przypada na bieżący rok kalendarzowy, zwrócimy pustą odpowiedź. W przypadku przyszłych lotów zalecamy używanie interfejsu computeFlightEmissions API.

Jeśli w przypadku danego lotu nie są dostępne żadne szacunki przy użyciu żadnej z 3 metod, odpowiedź zwróci obiekt Scope3FlightEmissions z pustymi polami emisji. Żądanie nadal będzie uznawane za wykonane. Zwykle brakujące szacunki emisji występują, gdy lot jest nieznany serwerowi (np. nie ma konkretnego lotu lub typowa emisja lotu nie jest dostępna dla żądanej pary).

Żądanie zakończy się niepowodzeniem z błędem INVALID_ARGUMENT, jeśli:

  • Żądanie zawiera ponad 1000 odcinków lotu.
  • W danych wejściowych dotyczących odcinka lotu brakuje co najmniej 1 identyfikatora. Na przykład brakujące miejsce początkowe lub docelowe bez prawidłowej odległości w przypadku dopasowania typu TIM_EMISSIONS lub TYPICAL_FLIGHT_EMISSIONS albo brakująca odległość w przypadku dopasowania typu DISTANCE_BASED_EMISSIONS (jeśli chcesz wrócić do emisji na podstawie odległości lub chcesz uzyskać szacunkową wartość emisji na podstawie odległości, musisz podać odległość).
  • Data lotu jest wcześniejsza niż 2019 r. (dane dotyczące zakresu 3 są dostępne tylko od 2019 r.).
  • Odległość lotu wynosi 0 km lub mniej.
  • Brak klasy podróży.

Żądanie jest przetwarzane z użyciem logiki awaryjnej, więc nieprawidłowo skonfigurowane żądania mogą zwracać prawidłowe szacunki emisji przy użyciu metod awaryjnych. Jeśli na przykład żądanie zawiera nieprawidłowy numer lotu, ale określa miejsce wylotu i miejsce docelowe, żądanie zostanie zrealizowane, ale zwrócone dane o emisji będą oparte wyłącznie na typowej emisji z lotu. Podobnie, jeśli w typowym żądaniu dotyczącym emisji z lotu brakuje pochodzenia, ale określono prawidłową odległość, żądanie może zostać zrealizowane na podstawie emisji związanych z odległością. Dlatego należy sprawdzić źródło zwróconych emisji (source), aby potwierdzić, że wyniki są zgodne z oczekiwaniami.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "flights": [
    {
      object (Scope3FlightSegment)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Pola
flights[]

object (Scope3FlightSegment)

Wymagane. Loty, dla których mają być zwracane szacunki emisji.
modelVersion

object (ModelVersion)

Opcjonalnie: Wersja modelu, na podstawie której obliczono szacunki emisji dla wszystkich lotów w tym żądaniu.

Treść odpowiedzi

Lista lotów z szacunkowymi emisjami z zakresu 3.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "flightEmissions": [
    {
      object (Scope3FlightEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Pola
flightEmissions[]

object (Scope3FlightEmissions)

Lista odcinków lotu ze szacunkową emisją.
modelVersion

object (ModelVersion)

Wersja modelu, na podstawie której obliczono szacunki emisji dla wszystkich lotów w tej odpowiedzi.

Scope3FlightSegment

Parametry lotu, na podstawie których pobierane są emisje z zakresu 3.

Zapis JSON 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Pola
departureDate

object (Date)

Wymagane. Data lotu w strefie czasowej lotniska wylotu. W przypadku typowych modeli emisji lotów i modeli emisji opartych na odległości wymagany jest tylko rok (wartości miesiąca i dnia są ignorowane, więc można je pominąć, ustawić na 0 lub ustawić na prawidłową datę). W związku z tym, jeśli dla emisji TIM nie podano konkretnej daty, będziemy stosować typową emisję lotu (lub emisję na podstawie odległości).
cabinClass

enum (CabinClass)

Wymagane. Klasa podróży.
origin

string

Opcjonalnie: Kod IATA lotniska wylotu, np. YVR. Służy do dopasowywania konkretnego lotu, jeśli jest podany wraz z miejscem docelowym, przewoźnikiem i numerem lotu. Jeśli nie znajdziemy takiego lotu, najpierw spróbujemy dopasować go do typowego lotu między podanymi lotniskami wylotu i docelowym. W przeciwnym razie, jeśli podana jest odległość lotu, użyjemy modelu emisji opartego na odległości.
destination

string

Opcjonalnie: Kod IATA lotniska docelowego, np. ICN. Służy do dopasowywania konkretnego lotu, jeśli jest podany wraz z miejscem wylotu, przewoźnikiem i numerem lotu. Jeśli nie znajdziemy takiego lotu, najpierw spróbujemy dopasować go do typowego lotu między podanymi lotniskami wylotu i docelowym. W przeciwnym razie, jeśli podana jest odległość lotu, użyjemy modelu emisji opartego na odległości.
carrierCode

string

Opcjonalnie: Kod przewoźnika IATA, np. KE. Jest to wymagane, jeśli chcesz dopasować konkretny lot. W przypadku typowych modeli emisji opartych na lotach i odległościach ten parametr nie jest używany. Może to być kod przewoźnika obsługującego lot lub przewoźnika firmującego lot (np. w przypadku lotów współdzielonych).
flightNumber

integer

Opcjonalnie: Numer lotu, np. 71. Jest on używany w pierwszej kolejności do dopasowania konkretnego lotu, jeśli oprócz miejsca wylotu, miejsca docelowego i przewoźnika podano numer lotu. Jeśli numer lotu nie zostanie podany, najpierw spróbujemy dopasować lot do typowego lotu między podanymi lotniskami wylotu i docelowym. Jeśli to się nie uda lub nie podano miejsca wylotu i miejsca docelowego, użyjemy modelu emisji opartego na odległości na podstawie podanej odległości lotu.
distanceKm

string (int64 format)

Opcjonalnie: Odległość w kilometrach, np. 2423. Służy do dopasowywania lotu do emisji na podstawie odległości, gdy nie podano miejsca wylotu i miejsca docelowego lub gdy nie ma pasujących typowych lotów. To pole obsługuje wartości z zakresu od 0 do 2,5e16 km.

CabinClass

Klasa podróży.

Wartości w polu enum
CABIN_CLASS_UNSPECIFIED Nieokreślona klasa podróży.
ECONOMY Klasa ekonomiczna.
PREMIUM_ECONOMY Klasa ekonomiczna premium.
BUSINESS Klasa biznesowa.
FIRST Pierwsza klasa.

Scope3FlightEmissions

Lot w zakresie 3 z szacunkową emisją.

Zapis JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3DataType)
}
Pola
flight

object (Scope3FlightSegment)

Wymagane. Pasuje do identyfikatorów lotów w żądaniu.
wtwEmissionsGramsPerPax

string (int64 format)

Opcjonalnie: Całkowita emisja z lotu (suma emisji od wydobycia do zbiornika i od zbiornika do śladu) na pasażera na podstawie podanych informacji. Jest to całkowita emisja i jeśli nie masz konkretnych powodów, aby używać emisji TTW lub WTT, powinnaś(-eś) użyć tej liczby.
ttwEmissionsGramsPerPax

string (int64 format)

Opcjonalnie: Emisje z lotu „od zbiornika do śladu” na pasażera na podstawie podanych informacji.
wttEmissionsGramsPerPax

string (int64 format)

Opcjonalnie: Emisje z lotu od źródła do zbiornika na pasażera na podstawie podanych informacji.
source

enum (Scope3DataType)

Opcjonalnie: Źródło danych o emisjach.

Scope3DataType

Rodzaj dopasowania używany do obliczania emisji z zakresu 3. Jest to używane w odpowiedzi dotyczącej zakresu 3, aby oznaczyć, która z metod została użyta do obliczenia emisji.

Wartości w polu enum
SCOPE3_DATA_TYPE_UNSPECIFIED Nieokreślony typ danych.
TIM_EMISSIONS Emisje na podstawie TIM-u z uwzględnieniem miejsca wylotu, miejsca docelowego, przewoźnika, numeru lotu, daty wylotu i roku.
TYPICAL_FLIGHT_EMISSIONS Typowa emisja lotów na podstawie miejsca wylotu, miejsca docelowego i roku.
DISTANCE_BASED_EMISSIONS Emisje na podstawie odległości, obliczane na podstawie przebytej odległości i roku.