Method: flights.computeScope3FlightEmissions

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

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

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

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

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

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

  • Запрос содержит более 1000 маршрутов полетов.
  • В исходных данных об участке полета отсутствует один или несколько идентификаторов. Например, отсутствуют пункты отправления/назначения без допустимого расстояния для соответствия типам TIM_EMISSIONS или TYPICAL_FLIGHT_EMISSIONS , или отсутствует расстояние для соответствия типу DISTANCE_BASED_EMISSIONS (если вы хотите использовать выбросы, основанные на расстоянии, или получить оценку выбросов, основанную на расстоянии, необходимо указать расстояние).
  • Дата полета указана до 2019 года (данные по категории 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

Параметры полета, на основе которых рассчитываются выбросы категории 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

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

destination

string

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

carrierCode

string

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

flightNumber

integer

Необязательно. До 4-значного номера рейса , например, 71 , из [1, 9999]. Он используется для сопоставления с конкретным рейсом, если номер рейса указан вместе с пунктом отправления, пунктом назначения и авиаперевозчиком. Если номер рейса не указан, мы сначала попытаемся сопоставить рейс с типичным рейсом между указанными аэропортами отправления и назначения. Если это не удастся и/или пункты отправления и назначения не указаны, мы будем использовать модель выбросов, основанную на расстоянии, исходя из указанного расстояния полета.

distanceKm

string ( int64 format)

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

Класс салона

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

Перечисления
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)

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

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 Выбросы, рассчитываемые на основе пройденного расстояния и года.