Method: flights.computeFlightEmissions

Metoda bezstanowa do pobierania szacunków emisji. Szczegółowe informacje o sposobie obliczania szacowanych emisji znajdziesz w GitHub.

Odpowiedź będzie zawierać wszystkie wpisy pasujące do podanych odcinków lotu w tej samej kolejności. Jeśli dla danego odcinka lotu nie ma dostępnych szacunków, odpowiedź zwróci obiekt odcinka lotu z pustymi polami emisji. Żądanie nadal będzie uznawane za wykonane. Przyczyny braku szacunków emisji:

  • Serwer nie zna tego lotu.
  • W danych wejściowych dotyczących odcinka lotu brakuje co najmniej 1 identyfikatora.
  • Data lotu przypada w przeszłości.
  • Ten typ samolotu nie jest obsługiwany przez model.
  • Brak konfiguracji miejsc.

Żądanie może zawierać maksymalnie 1000 odcinków lotu. Jeśli żądanie zawiera więcej niż 1000 lotów bezpośrednich, zakończy się niepowodzeniem i zostanie zwrócony błąd INVALID_ARGUMENT.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Treść żądania

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

Zapis JSON 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
Pola
flights[]

object (Flight)

Wymagane. Loty bezpośrednie, dla których mają być podane szacunki emisji.

Treść odpowiedzi

Definicja danych wyjściowych dla odpowiedzi flights.computeFlightEmissions.

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

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

object (FlightWithEmissions)

Lista etapów lotu z szacunkową emisją.
modelVersion

object (ModelVersion)

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

Lot

Wszystkie szczegóły związane z pojedynczym elementem żądania szacunkowej emisji lotu bezpośredniego.

Zapis JSON 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
Pola
origin

string

Wymagane. Kod IATA lotniska wylotu, np. „LHR”.
destination

string

Wymagane. Kod IATA lotniska docelowego, np. „JFK”.
operatingCarrierCode

string

Wymagane. Kod przewoźnika IATA, np. „AA”.
flightNumber

integer

Wymagane. Numer lotu, np. 324.
departureDate

object (Date)

Wymagane. Data lotu w strefie czasowej lotniska wylotu. Musi to być data w przyszłości lub teraźniejszości.

Data

Reprezentuje całą lub częściową datę kalendarzową, np. datę urodzin. Pora dnia i strefa czasowa są określone w innym miejscu lub nie mają znaczenia. Data jest podana w kalendarzu gregoriańskim. Może to być jedna z tych wartości:

  • Pełna data z wartościami roku, miesiąca i dnia różnymi od zera.
  • Miesiąc i dzień z rokiem zerowym (np. rocznica).
  • Sam rok, z miesiącem i dniem o wartości zero.
  • Rok i miesiąc z zerowym dniem (np. data ważności karty kredytowej).

Powiązane typy:

Zapis JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Musi mieścić się w zakresie od 1 do 9999 lub wynosić 0, aby określić datę bez roku.
month

integer

Miesiąc roku. Wartość musi mieścić się w przedziale od 1 do 12 lub wynosić 0, jeśli chcesz określić rok bez miesiąca i dnia.
day

integer

Dzień miesiąca. Musi być liczbą od 1 do 31 i być prawidłowa w przypadku danego roku i miesiąca lub liczbą od 0 do 31, jeśli chcesz podać tylko rok lub rok i miesiąc, w których dzień nie ma znaczenia.

FlightWithEmissions

Lot bezpośredni z szacowaną emisją.

Zapis JSON 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
Pola
flight

object (Flight)

Wymagane. Pasuje do identyfikatorów lotów w żądaniu. Uwaga: wszystkie kody IATA są pisane wielkimi literami.
source

enum (Source)

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

object (EmissionsGramsPerPax)

Opcjonalnie. Szacunkowe wartości emisji na pasażera. Nie będzie widoczny, jeśli nie można obliczyć emisji. Listę przyczyn, dla których nie można było obliczyć emisji, znajdziesz w artykule flights.computeFlightEmissions.
easaLabelMetadata

object (EasaLabelMetadata)

Opcjonalnie. Metadane dotyczące etykiety emisji lotniczych przyznawanej przez agencję EASA. Ustawiane tylko wtedy, gdy źródłem danych o emisjach jest EASA.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Opcjonalnie. Znaczenie wpływu smug kondensacyjnych na ocieplenie klimatu w porównaniu z całkowitym wpływem emisji CO₂e.

Źródło

Źródło danych o emisjach.

Wartości w polu enum
SOURCE_UNSPECIFIED Źródło danych o emisjach nie jest określone.
TIM Dane o emisjach pochodzą z modelu wpływu podróży.
EASA Dane o emisjach pochodzą z etykiet środowiskowych EASA.

EasaLabelMetadata

Metadane dotyczące etykiety emisji lotniczych przyznawanej przez agencję EASA.

Zapis JSON 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
Pola
labelIssueDate

object (Date)

Data wydania etykiety.
labelExpiryDate

object (Date)

Data wygaśnięcia etykiety. Etykieta może być wyświetlana do końca tego dnia.
labelVersion

string

Wersja etykiety.
safDiscountPercentage

number

Procent rabatu na emisję zrównoważonego paliwa lotniczego (SAF) zastosowany do etykiety. Jest to wartość procentowa w formie ułamka dziesiętnego. Wartości należą do przedziału [0,1]. Na przykład 0,0021 oznacza 0,21%.

Ten rabat i redukcja emisji są podawane na etykiecie EASA, ale nie są uwzględniane w szacunkach CO₂e rozpowszechnianych przez ten interfejs API.

ContrailsImpactBucket

Znaczenie wpływu smug kondensacyjnych na ocieplenie klimatu w porównaniu z całkowitym wpływem emisji CO₂e.

Wartości w polu enum
CONTRAILS_IMPACT_UNSPECIFIED Wpływ smug kondensacyjnych jest nieokreślony.
CONTRAILS_IMPACT_NEGLIGIBLE Wpływ smug kondensacyjnych jest znikomy w porównaniu z całkowitą emisją CO₂e.
CONTRAILS_IMPACT_MODERATE Wpływ smug kondensacyjnych jest porównywalny z całkowitą emisją CO₂e.
CONTRAILS_IMPACT_SEVERE Wpływ smug kondensacyjnych jest większy niż wpływ całkowitej emisji CO₂e.