Method: flights.computeFlightEmissions

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

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

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

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

HTTP-запрос

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

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

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

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

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

object ( Flight )

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

Тело ответа

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

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

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

object ( FlightWithEmissions )

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

modelVersion

object ( ModelVersion )

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

Полет

Все сведения, относящиеся к одному запросу на оценку выбросов при прямом перелете.

JSON-представление 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
Поля
origin

string

Обязательно. Код аэропорта ИАТА для пункта отправления рейса, например, «LHR».

destination

string

Обязательно. Код аэропорта ИАТА для пункта назначения рейса, например, «JFK».

operatingCarrierCode

string

Обязательно. Код перевозчика IATA, например, «AA».

flightNumber

integer

Обязательно. Номер рейса, например, 324.

departureDate

object ( Date )

Обязательно. Дата рейса в часовом поясе аэропорта отправления. Должна быть в настоящем или будущем.

FlightWithEmissions

Прямой рейс с оценкой выбросов.

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

object ( Flight )

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

source

enum ( Source )

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

emissionsGramsPerPax

object ( EmissionsGramsPerPax )

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

easaLabelMetadata

object ( EasaLabelMetadata )

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

contrailsImpactBucket

enum ( ContrailsImpactBucket )

Необязательно. Значимость влияния инверсионных следов на потепление по сравнению с общим влиянием выбросов CO2e.

Источник

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

Перечисления
SOURCE_UNSPECIFIED Источник данных о выбросах не указан.
TIM Данные о выбросах взяты из модели воздействия путешествий.
EASA Данные о выбросах взяты из экологических маркировок EASA.

EasaLabelMetadata

Метаданные о маркировке EASA Flight Emissions.

JSON-представление 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
Поля
labelIssueDate

object ( Date )

Дата выдачи этикетки.

labelExpiryDate

object ( Date )

Дата истечения срока действия этикетки. Этикетка может отображаться до истечения этого срока.

labelVersion

string

Версия этикетки.

safDiscountPercentage

number

Процент скидки на выбросы при использовании экологически чистого авиационного топлива (SAF) указывается на этикетке. Это процент в виде десятичной дроби. Значения находятся в интервале [0,1]. Например, 0,0021 означает 0,21%.

Об этой скидке и сокращении выбросов сообщает маркировка EASA, но они не включены в оценки CO2e, распространяемые этим API.

ContrailsImpactBucket

Значимость влияния потепления от инверсионных следов по сравнению с общим влиянием выбросов CO2e.

Перечисления
CONTRAILS_IMPACT_UNSPECIFIED Воздействие инверсионных следов не определено.
CONTRAILS_IMPACT_NEGLIGIBLE Влияние инверсионных следов ничтожно мало по сравнению с общим объемом выбросов CO2e.
CONTRAILS_IMPACT_MODERATE Воздействие инверсионных следов сопоставимо с общими выбросами CO2e.
CONTRAILS_IMPACT_SEVERE Воздействие инверсионных следов превышает общее воздействие выбросов CO2e.