Method: flights.computeDetailedFlightEmissions

Pobiera szczegółowe szacunki emisji.

Szczegółowe dane o emisji z lotów to przejrzyste szacunki emisji gazów cieplarnianych na pasażera uzupełnione o obszerne metadane zawierające szczegółowe informacje o metodologii obliczeń, rozkładzie emisji, wpływie smug kondensacyjnych i pochodzeniu danych.

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, w odpowiedzi zostanie zwrócony 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 100 odcinków lotu. Jeśli żądanie zawiera więcej niż 100 odcinków lotu, zakończy się niepowodzeniem i zostanie zwrócony błąd INVALID_ARGUMENT.

Żądanie HTTP

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

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 chcesz uzyskać szacowaną emisję.

Treść odpowiedzi

Definicja danych wyjściowych dla odpowiedzi flights.computeDetailedFlightEmissions.

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

Zapis JSON 
{
  "flightsWithDetailedEmissions": [
    {
      object (FlightWithDetailedEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Pola
flightsWithDetailedEmissions[]

object (FlightWithDetailedEmissions)

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.

FlightWithDetailedEmissions

Lot bezpośredni ze szczegółami szacowanej emisji.

Zapis JSON 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
Pola
flight

object (Flight)

Tylko dane wyjściowe. Pasuje do identyfikatorów lotów w żądaniu. Uwaga: wszystkie kody IATA są pisane wielkimi literami.
flightEmissionsDetails

object (FlightEmissionsDetails)

Tylko dane wyjściowe. wszystkie dane dotyczące emisji z lotów;
emissionsMetadata

object (EmissionsMetadata)

Tylko dane wyjściowe. Dodatkowe metadane dotyczące obliczania emisji związanej z lotem.

FlightEmissionsDetails

Szczegóły dotyczące emisji konkretnego lotu.

Zapis JSON 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
Pola
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Tylko dane wyjściowe. Szacunkowe wartości emisji na pasażera. Nie występuje, jeśli nie można było obliczyć emisji. Listę przyczyn, dla których nie można było obliczyć emisji, znajdziesz w artykule flights.computeDetailedFlightEmissions.
emissionsBreakdown

object (EmissionsBreakdown)

Tylko dane wyjściowe. Szczegóły dotyczące różnych części emisji w wartości łącznej emisji GramsPerPax. Suma wartości podziałów powinna zawsze być równa wartości emissionsGramsPerPax.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Tylko dane wyjściowe. Znaczenie wpływu smug kondensacyjnych na ocieplenie klimatu w porównaniu z całkowitym wpływem emisji CO₂e.
source

enum (Source)

Tylko dane wyjściowe. Źródło danych o emisjach.

EmissionsBreakdown

Szczegóły dotyczące różnych części emisji w wartości łącznej emisji GramsPerPax. Suma wartości podziałów powinna zawsze być równa wartości emissionsGramsPerPax.

Zapis JSON 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Pola
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Szacunkowe wartości emisji od źródła energii po zbiornik paliwa na pasażera. Nie występuje, jeśli nie można było obliczyć emisji. Listę przyczyn, dla których nie można było obliczyć emisji, znajdziesz w artykule flights.computeFlightEmissions.
ttwEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Szacunkowe wartości emisji od zbiornika do śladu za statkiem na pasażera. Nie występuje, jeśli nie można było obliczyć emisji. Listę przyczyn, dla których nie można było obliczyć emisji, znajdziesz w artykule flights.computeFlightEmissions.

EmissionsMetadata

Wszystkie dodatkowe metadane.

Zapis JSON 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
Pola
emissionsProvenance

object (EmissionsProvenance)

Tylko dane wyjściowe. Szczegółowe informacje o pochodzeniu danych użytych do obliczenia danych o emisji, w tym czynniki wpływające na emisję wraz z ich źródłami danych.
easaLabelMetadata

object (EasaLabelMetadata)

Tylko dane wyjściowe. Metadane dotyczące etykiety emisji lotniczych przyznawanej przez agencję EASA. Ustawiane tylko wtedy, gdy źródłem danych o emisjach jest EASA.
timWebsiteEmissionsCalculatorUrl

string

Tylko dane wyjściowe. Link do strony internetowej travelimpactmodel.org kalkulatora emisji. Przykład: https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225.

EmissionsProvenance

Informacje o pochodzeniu danych użytych do obliczenia szacowanych emisji, w tym czynniki wpływające na emisje i ich źródła danych.

Zapis JSON 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
Pola
provenanceEntries[]

object (EmissionsProvenance.EmissionsProvenanceEntry)

Tylko dane wyjściowe. Wszystkie czynniki wpływające na obliczanie emisji.

EmissionsProvenance.EmissionsProvenanceEntry

Szczegóły dotyczące pojedynczego czynnika przyczyniającego się do obliczeń emisji.

Zapis JSON 
{
  "provenanceEntryType": enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType),
  "source": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource),
  "sourceVersion": string,
  "dataCategory": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory),

  // Union field data_strategy can be only one of the following:
  "fuelBurnEeaStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy),
  "loadFactorsT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy),
  "loadFactorsChAviationStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy),
  "cargoMassFractionT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy),
  "seatAreaRatioIataStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy),
  "distanceAdjustmentStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)
  // End of list of possible types for union field data_strategy.

  // Union field data_value can be only one of the following:
  "loadFactorsData": number,
  "cargoMassFractionData": number,
  "seatAreaRatioData": {
    object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)
  },
  "estimatedFlightDistanceKm": integer
  // End of list of possible types for union field data_value.
}
Pola
provenanceEntryType

enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType)

Tylko dane wyjściowe. Typ wpisu dotyczącego pochodzenia.
source

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource)

Tylko dane wyjściowe. Źródło danych.
sourceVersion

string

Tylko dane wyjściowe. Wersja danych źródłowych. Na przykład „2025/04”.
dataCategory

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory)

Tylko dane wyjściowe. Kategoria danych źródła danych.
Pole zbiorcze data_strategy. Strategia używana do obliczania emisji w przypadku danego źródła danych. Zestaw pól będzie odpowiadać typowi data_source. data_strategy może mieć tylko jedną z tych wartości:
fuelBurnEeaStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy)

Tylko dane wyjściowe. Strategia dotycząca spalania paliwa w Europejskim Obszarze Gospodarczym.
loadFactorsT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy)

Tylko dane wyjściowe. Strategia dotycząca współczynników obciążenia T100.
loadFactorsChAviationStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy)

Tylko dane wyjściowe. Strategia dotycząca współczynników obciążenia CH Aviation.
cargoMassFractionT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy)

Tylko dane wyjściowe. Strategia dotycząca ułamka masowego ładunku T100.
seatAreaRatioIataStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy)

Tylko dane wyjściowe. Strategia dotycząca współczynników obszaru miejsc IATA.
distanceAdjustmentStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)

Tylko dane wyjściowe. Strategia dostosowywania odległości.
Pole zbiorcze data_value. Wartość danych dla danego źródła danych. Zestaw pól będzie odpowiadać wartości provenance_entry_type. data_value może mieć tylko jedną z tych wartości:
loadFactorsData

number

Tylko dane wyjściowe. Wartość danych współczynników obciążenia. Jeśli nie zostanie ustawiona, wartość współczynników obciążenia jest niedostępna.
cargoMassFractionData

number

Tylko dane wyjściowe. Wartość ułamka masowego ładunku. Jeśli nie zostanie ustawiona, wartość ułamka masy ładunku jest niedostępna.
seatAreaRatioData

object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)

Tylko dane wyjściowe. Wartość współczynnika powierzchni miejsca dla każdej klasy podróży. Jeśli nie jest ustawiona, wartość współczynnika powierzchni miejsca jest niedostępna.
estimatedFlightDistanceKm

integer

Tylko dane wyjściowe. Szacowana odległość przelotu w fazie lotu CCD w kilometrach obliczona na podstawie współczynnika korekty odległości (DAF). Jeśli nie jest ustawiona, szacowana odległość lotu jest niedostępna.

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

Typ wpisu dotyczącego pochodzenia. W przyszłości możemy dodać nowe wartości. Klienci powinni być przygotowani na prawidłową obsługę nieznanych wartości typu wyliczeniowego.

Wartości w polu enum
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED Nieokreślony typ wpisu dotyczącego pochodzenia.
FUEL_BURN Typ wpisu dotyczący zużycia paliwa.
LOAD_FACTORS Typ wpisu współczynników obciążenia.
CARGO_MASS_FRACTION Typ danych wejściowych ułamka masy ładunku.
SEATING_CONFIG Typ wpisu konfiguracji miejsc.
SEAT_AREA_RATIOS Typ danych wejściowych współczynników powierzchni miejsc.
DISTANCE_ADJUSTMENT Typ wpisu korekty odległości.

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

Źródło danych dla czynników pochodzenia emisji. W przyszłości możemy dodać nowe wartości. Klienci powinni być przygotowani na prawidłową obsługę nieznanych wartości typu wyliczeniowego.

Wartości w polu enum
DATA_SOURCE_UNSPECIFIED Nieokreślone źródło danych.
EEA Dane dostarczone przez Europejską Agencję Środowiska (EEA).
T100 Dane ze zbioru danych T-100 udostępniane przez amerykańskie Biuro Statystyk Transportu.
CH_AVIATION Dane dostarczone przez ch-aviation.
OAG Dane dostarczone przez Official Aviation Guide (OAG).
OPERATING_CARRIER Dane dostarczone przez przewoźnika obsługującego lot.
AIRCRAFT_MODEL_TYPICAL Typowe dane na podstawie modelu samolotu.
GLOBAL_DEFAULT Globalna wartość domyślna używana, gdy nie ma innego źródła danych.
IATA Dane dostarczone przez Międzynarodowe Zrzeszenie Przewoźników Powietrznych (IATA).
ICL Dane dostarczone przez Imperial College London.

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

Strategia dotycząca spalania paliwa w Europejskim Obszarze Gospodarczym. W przyszłości możemy dodać nowe wartości. Klienci powinni być przygotowani na prawidłową obsługę nieznanych wartości typu wyliczeniowego.

Wartości w polu enum
STRATEGY_UNSPECIFIED Nieokreślona strategia.
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR Zastosowano statyczny współczynnik korekty.
AIRCRAFT_MAPPING_EXACT Zastosowano dokładne mapowanie samolotów.
AIRCRAFT_MAPPING_FALLBACK Użyto mapowania samolotów zastępczych.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

Strategia dotycząca współczynników obciążenia T100. W przyszłości możemy dodać nowe wartości. Klienci powinni być przygotowani na prawidłową obsługę nieznanych wartości typu wyliczeniowego.

Wartości w polu enum
STRATEGY_UNSPECIFIED Nieokreślona strategia.
CARRIER_ROUTE_MONTH Dane według przewoźnika, trasy i miesiąca podróży.
CARRIER_MONTH Dane według przewoźnika i miesiąca podróży.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH Dane historyczne pasujące do przewoźnika, trasy, roku i miesiąca.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

Strategia dotycząca współczynników obciążenia CH-Aviation. W przyszłości możemy dodać nowe wartości. Klienci powinni być przygotowani na prawidłową obsługę nieznanych wartości typu wyliczeniowego.

Wartości w polu enum
STRATEGY_UNSPECIFIED Nieokreślona strategia.
CARRIER_MONTH Dane według przewoźnika i miesiąca podróży.
ACTUAL_CARRIER_YEAR_MONTH Dane historyczne pasujące do przewoźnika, roku i miesiąca.

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

Strategia dotycząca ułamka masowego ładunku T100. W przyszłości możemy dodać nowe wartości. Klienci powinni być przygotowani na prawidłową obsługę nieznanych wartości typu wyliczeniowego.

Wartości w polu enum
STRATEGY_UNSPECIFIED Nieokreślona strategia.
CARRIER_ROUTE_AIRCRAFT_CLASS Dane według przewoźnika, trasy i klasy samolotu.
ROUTE_AIRCRAFT_CLASS Dane według trasy i klasy samolotu.
DISTANCE_AIRCRAFT_CLASS Dane według przedziału odległości i klasy samolotu.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS Dane historyczne dotyczące przewoźnika, trasy, roku, miesiąca i klasy samolotu.

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

Strategia dotycząca współczynników obszaru miejsc IATA. W przyszłości możemy dodać nowe wartości. Klienci powinni być przygotowani na prawidłową obsługę nieznanych wartości typu wyliczeniowego.

Wartości w polu enum
STRATEGY_UNSPECIFIED Nieokreślona strategia.
NARROW_AIRCRAFT_BODY Użyto współczynników powierzchni miejsc w samolotach wąskokadłubowych.
WIDE_AIRCRAFT_BODY Użyto współczynników powierzchni miejsc w samolotach szerokokadłubowych.

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

Strategia dostosowywania odległości. W przyszłości możemy dodać nowe wartości. Klienci powinni być przygotowani na prawidłową obsługę nieznanych wartości typu wyliczeniowego.

Wartości w polu enum
STRATEGY_UNSPECIFIED Nieokreślona strategia.
ORIGIN_DESTINATION Współczynnik korekty odległości określony na podstawie pary lotnisk wylotu i przylotu.
COUNTRY_PAIR Współczynnik korekty odległości określony na podstawie pary krajów pochodzenia i docelowego.
DEFAULT Współczynnik dostosowania odległości jest oparty na wartości domyślnej, ponieważ nie znaleźliśmy współczynnika dostosowania dla danego lotniska lub kraju.

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

Kategoria danych źródła danych. W przyszłości możemy dodać nowe wartości. Klienci powinni być przygotowani na prawidłową obsługę nieznanych wartości typu wyliczeniowego.

Wartości w polu enum
DATA_CATEGORY_UNSPECIFIED Nie określono kategorii danych.
PRIMARY Dane podstawowe zgodnie z definicją w normie ISO 14083.
MODELED Dane modelowane zgodnie z normą ISO 14083.
DEFAULT Dane wartości domyślnej zgodnie z normą ISO 14083.