Method: flights.computeDetailedFlightEmissions

Получает подробные оценки выбросов.

Подробные данные о выбросах от полетов представляют собой прозрачные оценки выбросов парниковых газов в расчете на одного пассажира, дополненные исчерпывающими метаданными, содержащими подробную информацию о методологии расчета, структуре выбросов, влиянии инверсионных следов и происхождении данных.

Подробная информация о том, как рассчитываются оценки выбросов, находится на GitHub .

В ответе будут содержаться все записи, соответствующие входным участкам полета, в том же порядке. Если для определенного участка полета нет доступных оценок, в ответе будет возвращен объект участка полета с пустыми полями выбросов. Запрос все равно будет считаться успешным. Причины отсутствия оценок выбросов включают:

  • Серверу неизвестна информация о рейсе.
  • В исходном фрагменте маршрута полета отсутствует один или несколько идентификаторов.
  • Дата рейса уже прошла.
  • Данный тип самолета не поддерживается данной моделью.
  • Отсутствует конфигурация сидений.

Запрос может содержать до 100 сегментов полета. Если запрос содержит более 100 сегментов полета, он завершится ошибкой INVALID_ARGUMENT.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
Поля
flights[]

object ( Flight )

Обязательно. Прямые рейсы для возврата оценок выбросов.

Ответный текст

Определение выходных данных для ответа flights.computeDetailedFlightEmissions .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "flightsWithDetailedEmissions": [
    {
      object (FlightWithDetailedEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Поля
flightsWithDetailedEmissions[]

object ( FlightWithDetailedEmissions )

Список участков полета с оценками выбросов.

modelVersion

object ( ModelVersion )

Версия модели, на основе которой были рассчитаны оценки выбросов для всех рейсов в рамках данного исследования.

FlightWithDetailedEmissions

Подробная информация о прямом рейсе с указанием предполагаемых выбросов.

JSON-представление 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
Поля
flight

object ( Flight )

Только вывод. Соответствует идентификаторам рейса в запросе. Примечание: все коды IATA пишутся заглавными буквами.

flightEmissionsDetails

object ( FlightEmissionsDetails )

Только выходные данные. Все данные о выбросах во время полетов.

emissionsMetadata

object ( EmissionsMetadata )

Только выходные данные. Дополнительные метаданные о расчете выбросов при полете.

FlightEmissionsDetails

Подробная информация о выбросах конкретного рейса.

JSON-представление 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
Поля
emissionsGramsPerPax

object ( EmissionsGramsPerPax )

Только выходные данные. Оценочные показатели выбросов на одного пассажира. Не будет отображаться, если расчет выбросов не удался. Список причин, по которым расчет выбросов не удался, см. flights.computeDetailedFlightEmissions

emissionsBreakdown

object ( EmissionsBreakdown )

Только для вывода. Подробная информация о различных составляющих выбросов в общем значении emissionsGramsPerPax. Суммарное значение всех составляющих всегда должно равняться emissionsGramsPerPax.

contrailsImpactBucket

enum ( ContrailsImpactBucket )

Только выходные данные. Значимость влияния инверсионных следов на глобальное потепление по сравнению с общим воздействием выбросов CO2-эквивалента.

source

enum ( Source )

Только выходные данные. Источник данных о выбросах.

Анализ выбросов

Подробная информация о различных составляющих выбросов в общем значении emissionsGramsPerPax. Суммарное значение всех составляющих всегда должно равняться emissionsGramsPerPax.

JSON-представление 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Поля
wttEmissionsGramsPerPax

object ( EmissionsGramsPerPax )

Оценочные данные по выбросам от источника до резервуара в расчете на одного пассажира. Эти данные отсутствуют, если расчет выбросов невозможен. Список причин, по которым расчет выбросов невозможен, см. на flights.computeFlightEmissions .

ttwEmissionsGramsPerPax

object ( EmissionsGramsPerPax )

Оценочные данные по выбросам от топливного бака до следа в расчете на одного пассажира. Отсутствуют, если расчет выбросов невозможен. Список причин, по которым расчет выбросов невозможен, см. на flights.computeFlightEmissions .

Метаданные выбросов

Все дополнительные метаданные.

JSON-представление 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
Поля
emissionsProvenance

object ( EmissionsProvenance )

Только выходные данные. Подробная информация об источнике данных, использованных для расчета выбросов, включая факторы, влияющие на результаты, и их источники.

easaLabelMetadata

object ( EasaLabelMetadata )

Только для вывода. Метаданные о маркировке выбросов EASA. Устанавливается только в том случае, если источником данных о выбросах является EASA.

timWebsiteEmissionsCalculatorUrl

string

Только вывод. Ссылка на сайт калькулятора выбросов travelimpactmodel.org . Пример: https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225 .

Происхождение выбросов

Информация об источнике данных, использованных для расчета оценок выбросов, включая факторы, влияющие на эти данные, и источники этих данных.

JSON-представление 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
Поля
provenanceEntries[]

object ( EmissionsProvenance.EmissionsProvenanceEntry )

Только выходные данные. Все факторы, влияющие на расчет выбросов, учтены.

Происхождение выбросов. Запись о происхождении выбросов.

Подробная информация об одном факторе, влияющем на расчеты выбросов.

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.
}
Поля
provenanceEntryType

enum ( EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType )

Только вывод. Тип записи о происхождении.

source

enum ( EmissionsProvenance.EmissionsProvenanceEntry.DataSource )

Только выходные данные. Источник данных.

sourceVersion

string

Только вывод. Версия исходных данных. Например, "2025/04".

dataCategory

enum ( EmissionsProvenance.EmissionsProvenanceEntry.DataCategory )

Только вывод. Категория данных источника данных.

Поле объединения data_strategy . Стратегия, используемая для расчета выбросов для данного источника данных. Набор полей будет соответствовать типу data_source. data_strategy может принимать только одно из следующих значений:
fuelBurnEeaStrategy

enum ( EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy )

Только результаты. Стратегия сжигания топлива в ЕЭЗ.

loadFactorsT100Strategy

enum ( EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy )

Только вывод. Стратегия для коэффициента загрузки T100.

loadFactorsChAviationStrategy

enum ( EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy )

Только для вывода. Стратегия повышения коэффициента загрузки CH Aviation.

cargoMassFractionT100Strategy

enum ( EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy )

Только выходные данные. Стратегия для определения массовой доли груза Т100.

seatAreaRatioIataStrategy

enum ( EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy )

Только выходные данные. Стратегия для коэффициентов площади сидений IATA.

distanceAdjustmentStrategy

enum ( EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy )

Только вывод. Стратегия корректировки расстояния.

Поле объединения data_value . Значение данных для указанного источника данных. Набор полей будет соответствовать provenance_entry_type. data_value может принимать только одно из следующих значений:
loadFactorsData

number

Только для вывода. Значение коэффициентов нагрузки. Если не задано, значение коэффициентов нагрузки недоступно.

cargoMassFractionData

number

Только для вывода. Значение массовой доли груза. Если не задано, значение массовой доли груза недоступно.

seatAreaRatioData

object ( EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData )

Только для вывода. Значение коэффициента площади сиденья для каждого класса сидений. Если не задано, значение коэффициента площади сиденья недоступно.

estimatedFlightDistanceKm

integer

Только для вывода. Расчетное расстояние полета в километрах на этапе CCD-съемки, рассчитанное с использованием поправочного коэффициента расстояния (DAF). Если не задано, расчетное значение расстояния полета недоступно.

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

Тип записи о происхождении. В будущем могут быть добавлены новые значения. Клиенты должны быть готовы корректно обрабатывать неизвестные значения перечисления.

Перечисления
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED Тип записи о происхождении не указан.
FUEL_BURN Тип входа, обеспечивающий сгорание топлива.
LOAD_FACTORS Тип ввода коэффициентов нагрузки.
CARGO_MASS_FRACTION Тип ввода доли массы груза.
SEATING_CONFIG Тип ввода конфигурации сидений.
SEAT_AREA_RATIOS Тип входа с учетом соотношения площади сиденья.
DISTANCE_ADJUSTMENT Тип ввода для корректировки расстояния.

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

Источник данных для факторов происхождения выбросов. В будущем могут быть добавлены новые значения. Клиенты должны быть готовы корректно обрабатывать неизвестные значения перечисления.

Перечисления
DATA_SOURCE_UNSPECIFIED Источник данных не указан.
EEA Данные предоставлены Европейским агентством по окружающей среде (ЕЭЗ).
T100 Данные взяты из набора данных T-100, предоставленного Бюро транспортной статистики США.
CH_AVIATION Данные предоставлены компанией ch-aviation.
OAG Данные предоставлены Официальным авиационным справочником (OAG).
OPERATING_CARRIER Данные предоставлены оператором связи.
AIRCRAFT_MODEL_TYPICAL Типичные данные, основанные на модели самолета.
GLOBAL_DEFAULT Глобальное значение по умолчанию, используемое, когда другие источники данных недоступны.
IATA Данные предоставлены Международной ассоциацией воздушного транспорта (IATA).
ICL Данные предоставлены Имперским колледжем Лондона.

Происхождение выбросов. Происхождение выбросов. Запись о сгорании топлива. Стратегия.

Стратегия учета расхода топлива в ЕЭЗ. В будущем могут быть добавлены новые значения. Клиенты должны быть готовы корректно обрабатывать неизвестные значения перечислений.

Перечисления
STRATEGY_UNSPECIFIED Стратегия не указана.
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR Был применен статический поправочный коэффициент.
AIRCRAFT_MAPPING_EXACT Использовалось точное картографирование воздушных судов.
AIRCRAFT_MAPPING_FALLBACK Использовалось резервное картографирование воздушных судов.

Происхождение выбросов. Происхождение выбросов. Вход. Коэффициенты нагрузки T100. Стратегия.

Стратегия для коэффициентов загрузки T100. В будущем могут быть добавлены новые значения. Клиенты должны быть готовы корректно обрабатывать неизвестные значения перечислений.

Перечисления
STRATEGY_UNSPECIFIED Стратегия не указана.
CARRIER_ROUTE_MONTH Данные по перевозчику, маршруту и ​​месяцу поездки.
CARRIER_MONTH Данные по перевозчикам и месяцам поездок.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH Исторические данные, сопоставляющие перевозчика, маршрут, год и месяц.

Происхождение выбросов. Происхождение выбросов. Ввод. Коэффициенты нагрузки. Авиация. Стратегия.

Стратегия для коэффициентов загрузки CH-Aviation. В будущем могут быть добавлены новые значения. Клиенты должны быть готовы корректно обрабатывать неизвестные значения перечислений.

Перечисления
STRATEGY_UNSPECIFIED Стратегия не указана.
CARRIER_MONTH Данные по перевозчикам и месяцам поездок.
ACTUAL_CARRIER_YEAR_MONTH Исторические данные, сопоставляющие оператора связи, год и месяц.

Происхождение выбросов. Происхождение выбросов. Ввоз. Доля массы груза T100. Стратегия.

Стратегия для доли массы груза T100. В будущем могут быть добавлены новые значения. Клиенты должны быть готовы корректно обрабатывать неизвестные значения перечисления.

Перечисления
STRATEGY_UNSPECIFIED Стратегия не указана.
CARRIER_ROUTE_AIRCRAFT_CLASS Данные по перевозчику, маршруту и ​​классу воздушного судна.
ROUTE_AIRCRAFT_CLASS Данные по маршрутам и классам воздушных судов.
DISTANCE_AIRCRAFT_CLASS Данные по диапазону расстояний и классу самолета.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS Исторические данные, сопоставляющие авиаперевозчика, маршрут, год, месяц и класс воздушного судна.

Происхождение выбросов. Происхождение выбросов. Вход. Соотношение площади сиденья. IATA. Стратегия.

Стратегия в отношении коэффициентов площади сидений IATA. В будущем могут быть добавлены новые значения. Клиенты должны быть готовы корректно обрабатывать неизвестные значения перечислений.

Перечисления
STRATEGY_UNSPECIFIED Стратегия не указана.
NARROW_AIRCRAFT_BODY Были использованы коэффициенты площади сидений для узкофюзеляжных самолетов.
WIDE_AIRCRAFT_BODY Были использованы коэффициенты площади сидений для широкофюзеляжных самолетов.

Происхождение выбросов. Происхождение выбросов. Въезд. Корректировка расстояния. Стратегия.

Стратегия корректировки расстояния. В будущем могут быть добавлены новые значения. Клиенты должны быть готовы корректно обрабатывать неизвестные значения перечисления.

Перечисления
STRATEGY_UNSPECIFIED Стратегия не указана.
ORIGIN_DESTINATION Поправочный коэффициент расстояния определяется для пары аэропортов отправления и назначения.
COUNTRY_PAIR Поправочный коэффициент расстояния определяется для пары стран отправления и назначения.
DEFAULT Поправочный коэффициент расстояния основан на значении по умолчанию, поскольку мы не обнаружили поправочного коэффициента, специфичного для конкретного аэропорта или страны.

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

Категория данных источника данных. В будущем могут быть добавлены новые значения. Клиенты должны быть готовы корректно обрабатывать неизвестные значения перечисления.

Перечисления
DATA_CATEGORY_UNSPECIFIED Категория данных не указана.
PRIMARY Первичные данные, как определено в стандарте ISO 14083.
MODELED Моделируемые данные, как определено в ISO 14083.
DEFAULT Данные о значениях по умолчанию, как определено в стандарте ISO 14083.