Method: flights.computeScope3FlightEmissions

Pobiera szacunkowe emisje gazów cieplarnianych dla zestawu segmentów lotu na potrzeby raportowania zakresu 3.

Odpowiedź będzie zawierać wszystkie wpisy, które pasują do podanych segmentów lotu (Scope3FlightSegment), w tej samej kolejności. Szacunki będą obliczane przy użyciu tej logiki kaskadowej (z wykorzystaniem pierwszej dostępnej opcji):

  1. Emisja według modelu TIM dla: origin, destination, carrier, flightNumber, departureDate i cabinClass.
  2. Typowa emisyjność lotu na trasie origin – destination, rok departureDate, cabinClass.
  3. Emisja obliczona na podstawie odległości przy użyciu: distanceKm, rok: departureDate, cabinClass.

Jeśli w danym roku kalendarzowym zostanie przesłana prośba o przyszły lot, nie obsługujemy emisji poziomu 1 i przechodzimy na emisje poziomu 2 lub 3. Jeśli żądany lot w przyszłości nie przypada na ten rok kalendarzowy, zwrócimy pustą odpowiedź. Zalecamy, aby w przypadku przyszłych lotów używać interfejsu API computeFlightEmissions.

Jeśli dla danego lotu nie są dostępne szacunki w przypadku żadnej z 3 metod, odpowiedź zwróci obiekt Scope3FlightEmissions z pustymi polami emisji. Żądanie i tak zostanie uznane za zakończone powodzeniem. Zazwyczaj brak szacunkowych danych o emisji występuje, gdy lot jest nieznany serwerowi (np. nie istnieje konkretny lot lub typowa emisja lotów nie jest dostępna dla danej pary).

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

  • Żądanie zawiera ponad 1000 etapów lotu.
  • W podanym odcinku lotu brakuje co najmniej 1 identyfikatora. Na przykład brak miejsca wylotu/przylotu bez prawidłowej odległości w przypadku dopasowania typu TIM_EMISSIONS lub TYPICAL_FLIGHT_EMISSIONS albo brak odległości w przypadku dopasowania typu DISTANCE_BASED_EMISSIONS (jeśli chcesz wrócić do emisji na podstawie odległości lub chcesz uzyskać szacunkową emisję 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 lub mniej.
  • Brak klasy podróży.

Ponieważ żądanie jest przetwarzane z użyciem logiki zastępczej, możliwe jest, że nieprawidłowo skonfigurowane żądania zwrócą prawidłowe szacunki emisji przy użyciu metod zastępczych. Jeśli na przykład żądanie zawiera nieprawidłowy numer lotu, ale określa miejsce wylotu i przylotu, żądanie zostanie zrealizowane, ale zwrócone dane o emisji będą oparte wyłącznie na typowej emisji podczas lotu. Podobnie, jeśli w żądaniu brakuje miejsca wylotu, ale podano prawidłową odległość, żądanie może zostać zrealizowane wyłącznie na podstawie emisji obliczonej na podstawie odległości. W związku z tym 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ą zostać zwrócone szacunkowe emisje.
modelVersion

object (ModelVersion)

Opcjonalnie: Wersja modelu, w której obliczono szacunkową emisję dla wszystkich lotów w tym żądaniu.

Treść odpowiedzi

Lista lotów z szacowaną emisją 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 segmentów lotu z szacowaną emisją.
modelVersion

object (ModelVersion)

Wersja modelu, w której obliczono szacunkową emisję dla wszystkich lotów w tej odpowiedzi.

Scope3FlightSegment

Parametry lotu, dla których pobierane są dane o emisji zakresu 3.

Zapis JSON 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.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 modeli typowej emisji lotów i emisji na podstawie 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ę). Jeśli nie podano konkretnej daty emisji TIM, użyjemy typowej emisji lotu (lub emisji obliczonej na podstawie odległości).
cabinClass

enum (Scope3FlightSegment.CabinClass)

Wymagane. Klasa podróży.
origin

string

Opcjonalnie: Trzyliterowy kod lotniska IATA wylotu, np. YVR. Służy do dopasowywania konkretnego lotu, jeśli podano miejsce docelowe, przewoźnika i numer lotu. Jeśli nie znajdziemy dopasowania, najpierw spróbujemy dopasować lot do typowego lotu między podanymi lotniskami początkowym i docelowym. W przeciwnym razie użyjemy modelu emisji opartego na odległości, jeśli podano odległość lotu.
destination

string

Opcjonalnie: 3-literowy kod IATA lotniska docelowego, np. ICN. Służy do dopasowywania konkretnego lotu, jeśli podano go wraz z miejscem wylotu, przewoźnikiem i numerem lotu. Jeśli nie znajdziemy dopasowania, najpierw spróbujemy dopasować lot do typowego lotu między podanymi lotniskami początkowym i docelowym. W przeciwnym razie użyjemy modelu emisji opartego na odległości, jeśli podano odległość lotu.
carrierCode

string

Opcjonalnie: Dwuznakowy kod przewoźnika IATA, np. KE. Jest to wymagane, jeśli chcesz dopasować konkretny lot. W przeciwnym razie nie jest on używany w typowych modelach emisji opartych na locie i odległości. Może to być kod zarówno przewoźnika operacyjnego, jak i marketingowego (czyli uwzględniony jest kod współdzielony).
flightNumber

integer

Opcjonalnie: Maksymalnie 4-cyfrowy numer lotu, np. 71, z zakresu [1, 9999]. Jest on używany najpierw do dopasowania konkretnego lotu, jeśli numer lotu jest podany wraz z miejscem wylotu, miejscem docelowym i przewoźnikiem. Jeśli numer lotu nie jest podany, najpierw spróbujemy dopasować lot do typowego lotu między podanymi lotniskami początkowym i docelowym. Jeśli to się nie uda lub nie podano miejsca wylotu i przylotu, 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, od [1, 1e12) km. Służy do dopasowywania lotu do emisji na podstawie odległości, gdy nie podano miejsca wylotu i przylotu lub nie ma pasujących typowych lotów.

Scope3FlightSegment.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 z zakresu 3 z szacowaną emisją.

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

object (Scope3FlightSegment)

Identyfikator. Odpowiada identyfikatorom lotów w żądaniu.
wtwEmissionsGramsPerPax

string (int64 format)

Opcjonalnie: Łączna emisja podczas lotu (suma emisji od wydobycia do zbiornika i od zbiornika do śladu) na pasażera na podstawie żądanych informacji. Jest to łączna emisja i jeśli nie masz konkretnych powodów, aby używać emisji TTW lub WTT, użyj tej liczby.
ttwEmissionsGramsPerPax

string (int64 format)

Opcjonalnie: Emisja podczas lotu na pasażera na podstawie żądanych informacji.
wttEmissionsGramsPerPax

string (int64 format)

Opcjonalnie: Emisja gazów cieplarnianych podczas lotu na pasażera (od wydobycia do zbiornika) na podstawie żądanych informacji.
source

enum (Scope3FlightEmissions.Scope3DataType)

Opcjonalnie: Źródło danych o emisji.
modelVersion

string

Opcjonalnie: Wersja modelu, na podstawie której obliczono emisję.

Scope3FlightEmissions.Scope3DataType

Typ dopasowania używany do obliczania emisji zakresu 3. Służy do określenia, która metoda została użyta do obliczenia emisji w zakresie 3.

Wartości w polu enum
SCOPE3_DATA_TYPE_UNSPECIFIED Nieokreślony typ danych.
TIM_EMISSIONS Emisja obliczona na podstawie modelu TIM dla danego 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 Emisja na podstawie odległości, obliczana na podstawie przebytej odległości i roku.