Method: flights.computeScope3FlightEmissions

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

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

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

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

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

Запрос завершится ошибкой INVALID_ARGUMENT , если:

  • Запрос содержит более 1000 этапов полета.
  • На входном участке полёта отсутствует один или несколько идентификаторов. Например, отсутствует пункт отправления/назначения без допустимого расстояния для сопоставления типа TIM_EMISSIONS или TYPICAL_FLIGHT_EMISSIONS , либо отсутствует расстояние для сопоставления типа DISTANCE_BASED_EMISSIONS (если вы хотите вернуться к выбросам на основе расстояния или получить оценку выбросов на основе расстояния, необходимо указать расстояние).
  • Дата полета — до 2019 года (данные Scope 3 доступны только за 2019 год и позже).
  • Дальность полета 0 или ниже.
  • Отсутствует класс каюты.

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

HTTP-запрос

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

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

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

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

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

Параметры полета, с помощью которых определяются выбросы Scope 3.

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

object ( Date )

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

cabinClass

enum ( CabinClass )

Обязательно. Класс обслуживания рейса.

origin

string

Необязательно. Код аэропорта ИАТА для пункта отправления, например, YVR . Он используется для сопоставления конкретного рейса, если указан вместе с пунктом назначения, перевозчиком и номером рейса. Если совпадений нет, мы сначала попытаемся сопоставить рейс с типичным рейсом между указанными аэропортами отправления и назначения. В противном случае мы будем использовать модель выбросов на основе расстояния, если указано расстояние полёта.

destination

string

Необязательно. Код аэропорта ИАТА для пункта назначения, например, ICN . Он используется для сопоставления конкретного рейса, если указан вместе с данными о пункте отправления, перевозчике и номере рейса. Если совпадений нет, мы сначала попытаемся сопоставить рейс с типичным рейсом между указанными аэропортами отправления и назначения. В противном случае мы будем использовать модель выбросов на основе расстояния, если указано расстояние полета.

carrierCode

string

Необязательно. Код перевозчика ИАТА, например, KE . Требуется, если требуется сопоставление конкретного рейса. В противном случае он не используется для типичных моделей выбросов, основанных на полётах и ​​расстоянии. Это может быть как операционный, так и маркетинговый код перевозчика (т.е. код-шеринг).

flightNumber

integer

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

distanceKm

string ( int64 format)

Необязательно. Расстояние в километрах, например, 2423 Используется для сопоставления рейса с данными о выбросах, основанными на расстоянии, если не указаны пункты отправления и назначения или нет соответствующих типичных рейсов. Это поле поддерживает значения от 0 до 2,5e16 км.

CabinClass

Класс обслуживания рейса.

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

Scope3FlightEmissions

Полет категории 3 с оценкой выбросов.

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

object ( Scope3FlightSegment )

Обязательно. Соответствует идентификаторам рейсов в запросе.

wtwEmissionsGramsPerPax

string ( int64 format)

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

ttwEmissionsGramsPerPax

string ( int64 format)

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

wttEmissionsGramsPerPax

string ( int64 format)

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

source

enum ( Scope3DataType )

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

Scope3DataType

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

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