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 brak szacunków emisji występuje, 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 przypada przed 2019 rokiem (dane dotyczące zakresu 3 są dostępne tylko od 2019 roku).
  • Odległość lotu wynosi 0 km lub mniej.
  • Brak klasy podróży.

Żądanie jest przetwarzane z użyciem logiki awaryjnej, więc w przypadku nieprawidłowo skonfigurowanych żądań mogą być zwracane prawidłowe szacunki emisji z użyciem 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 upewnić się, ż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: 3-znakowy kod IATA lotniska wylotu, np. YVR. Jest używany 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: 3-znakowy 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: Dwuznakowy 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: Maksymalnie 4-cyfrowy numer lotu, np. 71, z zakresu [1, 9999]. 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, z zakresu [1, 2,5e16) km. Jest ona używana 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.

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, które zależą od przebytej odległości i roku.