Method: flights.computeScope3FlightEmissions

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

Ответ будет содержать все записи, соответствующие входным сегментам рейсов Scope3FlightSegment, в том же порядке. Расчетные значения будут вычисляться по следующей каскадной логике (с использованием первого доступного варианта):

  1. Выбросы на основе TIM с учетом следующих факторов: origin, destination, carrier, flightNumber, departureDate и cabinClass.
  2. Типичные выбросы от рейса с учетом следующих факторов: origin, destination, год в departureDate и cabinClass.
  3. Выбросы на основе расстояния, рассчитанные с помощью distanceKm, год в departureDate и cabinClass.

Если в текущем календарном году запрашивается будущий рейс, мы не поддерживаем выбросы уровня 1 и возвращаемся к выбросам уровня 2 или 3. Если запрашиваемый рейс запланирован не на этот календарный год, мы вернем пустой ответ. В дальнейшем мы рекомендуем использовать computeFlightEmissions API.

Если для определенного рейса нет расчетных данных ни по одному из трех методов, в ответе будет возвращен объект Scope3FlightEmissions с пустыми полями выбросов. Запрос все равно будет считаться успешным. Обычно это происходит, если рейс неизвестен серверу (например, такого рейса не существует или для выбранной пары городов нет данных об обычном количестве выбросов).

Запрос не будет выполнен и появится ошибка INVALID_ARGUMENT, если:

  • Запрос содержит более 1000 сегментов рейса.
  • В сегменте рейса отсутствует один или несколько идентификаторов. Например, не указаны пункты отправления и назначения, а также расстояние для сопоставления типа TIM_EMISSIONS или TYPICAL_FLIGHT_EMISSIONS, или не указано расстояние для сопоставления типа DISTANCE_BASED_EMISSIONS (если вы хотите использовать резервный вариант расчета выбросов на основе расстояния или получить оценку выбросов на основе расстояния, необходимо указать расстояние).
  • Дата рейса – до 2019 года (данные сферы охвата 3 доступны только за 2019 год и более поздние).
  • Расстояние полета меньше или равно нулю.
  • Не указан класс перелета.

Поскольку запрос обрабатывается с использованием резервной логики, возможно, что неправильно настроенные запросы возвращают действительные оценки выбросов с использованием резервных методов. Например, если в запросе указан неверный номер рейса, но есть пункты отправления и назначения, запрос будет выполнен, но возвращенные данные о выбросах будут основаны только на типичных выбросах для рейса. Аналогично, если в запросе на расчет выбросов для типичного рейса не указан пункт отправления, но указано допустимое расстояние, запрос может быть выполнен только на основе выбросов, рассчитанных по расстоянию. Поэтому следует проверять источник возвращаемых выбросов (source), чтобы убедиться, что результаты соответствуют ожидаемым.

HTTP-запрос

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

URL имеет синтаксис gRPC Transcoding.

Тело запроса

Ниже приведена структура данных в теле запроса.

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

object (Scope3FlightSegment)

Обязательно. Рейсы, для которых нужно получить расчетные объемы выбросов.
modelVersion

object (ModelVersion)

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

Тело ответа

Список рейсов с расчетными выбросами категории 3.

Ниже приведена структура данных в ответе, полученном на запрос.

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

object (Scope3FlightEmissions)

Список сегментов рейса с расчетными выбросами.
modelVersion

object (ModelVersion)

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

Scope3FlightSegment

Параметры рейса, для которого получены данные о выбросах категории 3.

JSON-представление 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Поля
departureDate

object (Date)

Обязательно. Дата рейса в часовом поясе аэропорта отправления. Для моделей выбросов, основанных на типичных рейсах и расстоянии, требуется только год (значения месяца и дня игнорируются и поэтому могут быть опущены, установлены на 0 или на действительную дату для этих случаев). Если для выбросов TIM не указана конкретная дата, мы будем использовать данные о выбросах для обычного рейса (или на основе расстояния).
cabinClass

enum (Scope3FlightSegment.CabinClass)

Обязательно. Класс перелета.
origin

string

Необязательное поле. Трехсимвольный код аэропорта по классификации IATA для места вылета, например YVR. Используется для сопоставления с конкретным рейсом, если указан вместе с пунктом назначения, перевозчиком и номером рейса. Если совпадений нет, мы сначала попытаемся сопоставить рейс с типичным рейсом между указанными аэропортами отправления и назначения. В противном случае мы будем использовать модель выбросов на основе расстояния, если указано расстояние полета.
destination

string

Необязательное поле. Трехсимвольный код аэропорта по классификации IATA для пункта назначения, например ICN. Используется для сопоставления с определенным рейсом, если указан вместе с пунктом отправления, перевозчиком и номером рейса. Если совпадений нет, мы сначала попытаемся сопоставить рейс с типичным рейсом между указанными аэропортами отправления и назначения. В противном случае мы будем использовать модель выбросов на основе расстояния, если указано расстояние полета.
carrierCode

string

Необязательное поле. Двухсимвольный код авиакомпании по классификации IATA, например KE. Это необходимо, если вы хотите сопоставить определенные периоды трансляции рекламы. В противном случае этот параметр не используется для стандартных моделей расчета выбросов на основе рейса и расстояния. Это может быть код как фактического, так и маркетингового перевозчика (т.е. код-шеринг поддерживается).
flightNumber

integer

Необязательное поле. Номер рейса, состоящий максимум из четырех цифр, например 71, от 1 до 9999. Если указан номер рейса, а также пункт отправления, пункт назначения и перевозчик, то сначала выполняется сопоставление с конкретным рейсом. Если номер рейса не указан, мы сначала попытаемся сопоставить рейс с типичным рейсом между указанными аэропортами отправления и назначения. Если это не удастся и/или не указаны пункты отправления и назначения, мы будем использовать модель выбросов на основе расстояния, основанную на указанном расстоянии полета.
distanceKm

string (int64 format)

Необязательное поле. Расстояние в километрах, например 2423, из диапазона [1, 1e12) км. Используется для сопоставления рейса с выбросами на основе расстояния, когда пункты отправления и назначения не указаны или нет подходящих типичных рейсов.

Scope3FlightSegment.CabinClass

Класс перелета.

Перечисления
CABIN_CLASS_UNSPECIFIED Класс перелета не указан.
ECONOMY Экономкласс.
PREMIUM_ECONOMY Премиум-экономкласс.
BUSINESS Бизнес-класс.
FIRST Первый класс.

Scope3FlightEmissions

Рейс сферы охвата 3 с расчетным количеством выбросов.

JSON-представление 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType),
  "modelVersion": string
}
Поля
flight

object (Scope3FlightSegment)

Идентификатор. Соответствует идентификаторам рейсов в запросе.
wtwEmissionsGramsPerPax

string (int64 format)

Необязательное поле. Общий объем выбросов на пассажира (сумма выбросов на этапах от скважины до бака и от бака до следа) на основе запрошенной информации. Это общий объем выбросов, и если у вас нет особых причин использовать выбросы TTW или WTT, вам следует использовать это число.
ttwEmissionsGramsPerPax

string (int64 format)

Необязательное поле. Выбросы от рейса на пассажира, рассчитанные по методу "от бака до следа" на основе запрошенной информации.
wttEmissionsGramsPerPax

string (int64 format)

Необязательное поле. Выбросы от рейса на пассажира, рассчитанные по методу Well-to-Tank на основе запрошенной информации.
source

enum (Scope3FlightEmissions.Scope3DataType)

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

string

Необязательное поле. Версия модели, по которой рассчитывались выбросы.

Scope3FlightEmissions.Scope3DataType

Тип сопоставления, используемый для расчета выбросов сферы охвата 3. Используется для ответа по сфере охвата 3, чтобы указать, какой из методов использовался для расчета выбросов.

Перечисления
SCOPE3_DATA_TYPE_UNSPECIFIED Тип данных не указан.
TIM_EMISSIONS Выбросы на основе TIM с учетом пункта отправления, пункта назначения, перевозчика, номера рейса, даты вылета и года.
TYPICAL_FLIGHT_EMISSIONS Обычный объем выбросов для рейса с учетом пункта отправления, пункта назначения и года.
DISTANCE_BASED_EMISSIONS Выбросы на основе расстояния рассчитываются с учетом пройденного расстояния и года.