Package google.travel.sustainability.travelimpactmodel.v1

Indeks

TravelImpactModelService

Interfejs API do podawania szacunkowych danych o emisji dwutlenku węgla.

ComputeFlightEmissions

rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse)

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 wejściowym odcinku 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 w żądaniu jest więcej niż 1000 lotów bezpośrednich, żądanie zakończy się niepowodzeniem i zostanie zwrócony błąd INVALID_ARGUMENT.
ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse)

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 według tej logiki kaskadowej (z użyciem pierwszego dostępnego elementu):

  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 wejściowym odcinku lotu brakuje co najmniej 1 identyfikatora. Na przykład brak miejsca docelowego lub miejsca początkowego 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ą 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 emisje będą oparte wyłącznie na typowych emisjach 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.
ComputeTypicalFlightEmissions

rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse)

Pobiera szacunki typowej emisji lotów między 2 lotniskami, czyli na danym rynku. Jeśli dla danego rynku nie są dostępne żadne szacunki, odpowiedź zwróci obiekt rynku z pustymi polami emisji. Żądanie nadal będzie uznawane za wykonane.

Szczegółowe informacje o sposobie obliczania szacunkowych typowych emisji znajdziesz w GitHub.

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

ComputeFlightEmissionsRequest

Definicja danych wejściowych dla żądania ComputeFlightEmissions.

Pola
flights[]

Flight

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

ComputeFlightEmissionsResponse

Definicja danych wyjściowych dla odpowiedzi ComputeFlightEmissions.

Pola
flight_emissions[]

FlightWithEmissions

Lista etapów lotu ze szacunkową emisją.
model_version

ModelVersion

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

ComputeScope3FlightEmissionsRequest

Lista odcinków lotu, dla których chcesz poprosić o emisje z zakresu 3.

Pola
flights[]

Scope3FlightSegment

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

ModelVersion

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

ComputeScope3FlightEmissionsResponse

Lista lotów z szacunkowymi emisjami z zakresu 3.

Pola
flight_emissions[]

Scope3FlightEmissions

Lista odcinków lotu z szacunkową emisją.
model_version

ModelVersion

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

ComputeTypicalFlightEmissionsRequest

Lista par lotnisk (rynków), dla których chcesz poprosić o informacje o typowych emisjach.

Pola
markets[]

Market

Wymagane. Poproś o szacunkowe dane dotyczące typowej emisji lotów w przypadku tej pary rynków. Można poprosić o maksymalnie 1000 rynków.

ComputeTypicalFlightEmissionsResponse

Odpowiedź zawiera informacje o emisji, a także wersję modelu.

Pola
typical_flight_emissions[]

TypicalFlightEmissions

Wysłano prośbę o podanie typowej emisji lotów na danym rynku.
model_version

ModelVersion

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

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.

EasaLabelMetadata

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

Pola
label_issue_date

Date

Data wydania etykiety.
label_expiry_date

Date

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

string

Wersja etykiety.
saf_discount_percentage

double

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ędnione w szacunkach CO₂e rozpowszechnianych przez ten interfejs API.

EmissionsGramsPerPax

Wyniki pogrupowane według emisji w poszczególnych klasach podróży.

Pola
first

int32

Emisja w przypadku 1 pasażera w pierwszej klasie w gramach. To pole jest zawsze obliczane i wypełniane, niezależnie od tego, czy samolot ma miejsca w pierwszej klasie.
business

int32

Emisja w przypadku 1 pasażera w klasie biznesowej w gramach. To pole jest zawsze obliczane i wypełniane, niezależnie od tego, czy samolot ma miejsca w klasie biznesowej.
premium_economy

int32

Emisja w przypadku 1 pasażera w klasie ekonomicznej premium w gramach. To pole jest zawsze obliczane i wypełniane, niezależnie od tego, czy samolot ma miejsca w klasie ekonomicznej premium.
economy

int32

Emisja na jednego pasażera w klasie ekonomicznej w gramach. To pole jest zawsze obliczane i wypełniane, niezależnie od tego, czy samolot ma miejsca w klasie ekonomicznej.

Lot

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

Pola
origin

string

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

string

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

string

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

int32

Wymagane. Numer lotu, np. 324.
departure_date

Date

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

FlightWithEmissions

Lot bezpośredni z szacowaną emisją.

Pola
flight

Flight

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

Source

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

EmissionsGramsPerPax

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

EasaLabelMetadata

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

ContrailsImpactBucket

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

Rynek

Para lotnisk.

Pola
origin

string

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

string

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

ModelVersion

wersja modelu wpływu podróży, Więcej informacji o wersjach modelu znajdziesz w GitHub.

Pola
major

int32

Wersje główne: istotne zmiany w metodologii (np. dodanie do modelu nowych źródeł danych, które prowadzą do znaczących zmian w wynikach). Takie zmiany będą rzadkie i będziemy je ogłaszać z dużym wyprzedzeniem. Może to obejmować zmiany wersji interfejsu API, które będą zgodne z wytycznymi dotyczącymi interfejsu Google Cloud API.
minor

int32

Wersje podrzędne: zmiany w modelu, które są spójne we wszystkich wersjach schematu, ale zmieniają parametry lub implementację modelu.
patch

int32

Wersje poprawek: zmiany wdrożenia mające na celu wyeliminowanie błędów lub nieścisłości w implementacji modelu.
dated

string

Wersje z datą: zbiory danych modelu są regularnie odtwarzane z odświeżonymi danymi wejściowymi, ale bez zmian w algorytmach.

Scope3FlightEmissions

Lot w zakresie 3 z szacunkową emisją.

Pola
flight

Scope3FlightSegment

Identyfikator. Pasuje do identyfikatorów lotów w żądaniu.
wtw_emissions_grams_per_pax

int64

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.
ttw_emissions_grams_per_pax

int64

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

int64

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

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.

Scope3FlightSegment

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

Pola
departure_date

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 w tych przypadkach 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).
cabin_class

CabinClass

Wymagane. Klasa podróży.
origin

string

Opcjonalnie. 3-znakowy kod lotniska IATA miejsca wylotu, np. YVR. Jest on 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.
carrier_code

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 atrybut 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).
flight_number

int32

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.
distance_km

int64

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.

Ź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.

TypicalFlightEmissions

Szacunki typowej emisji lotów na danym rynku

Pola
market

Market

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

EmissionsGramsPerPax

Opcjonalnie. Typowa emisja lotu na pasażera na wybranym rynku. Nie będzie widoczny, jeśli nie można obliczyć typowych emisji. Listę powodów, dla których nie można było obliczyć typowej emisji z lotu, znajdziesz w witrynie GitHub.