Method: flights.computeFlightEmissions

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

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

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

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

HTTP-запрос

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

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

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

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

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 )

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

Дата

Представляет собой полную или частичную календарную дату, например день рождения. Время суток и часовой пояс либо указаны в другом месте, либо не имеют значения. Дата относится к григорианскому календарю. Может представлять одно из следующего:

  • Полная дата с ненулевыми значениями года, месяца и дня.
  • Месяц и день с нулевым годом (например, годовщина).
  • Год сам по себе, с нулевым месяцем и нулевым днем.
  • Год и месяц с нулевым днем ​​(например, дата окончания срока действия кредитной карты).

Похожие типы:

JSON-представление 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Поля
year

integer

Год даты. Должен быть от 1 до 9999 или 0, чтобы указать дату без года.

month

integer

Месяц года. Должен быть от 1 до 12 или 0, чтобы указать год без месяца и дня.

day

integer

День месяца. Должен быть от 1 до 31 и действителен для года и месяца, или 0, чтобы указать год отдельно или год и месяц, где день не имеет значения.

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 Flight Emissions. Устанавливается только в том случае, если источником данных об выбросах является EASA.

contrailsImpactBucket

enum ( ContrailsImpactBucket )

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

Источник

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

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

EasaLabelMetadata

Метаданные о маркировке выбросов EASA.

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

object ( Date )

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

labelExpiryDate

object ( Date )

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

labelVersion

string

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

safDiscountPercentage

number

Процент скидки на выбросы Sustainable Aviation Fuel (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.