Package google.travel.sustainability.travelimpactmodel.v1

Индекс

TravelImpactModelService

API предоставит оценку выбросов углерода.

ComputeFlightEmissions

rpc ComputeFlightEmissions( ComputeFlightEmissionsRequest ) returns ( ComputeFlightEmissionsResponse )

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

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

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

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

ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions( ComputeScope3FlightEmissionsRequest ) returns ( ComputeScope3FlightEmissionsResponse )

Метод без сохранения состояния для получения оценок выбросов парниковых газов для набора сегментов полета для отчетности области 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 ), чтобы убедиться, что результаты соответствуют ожидаемым.

Вычислить типичные выбросы полета

rpc ComputeTypicalFlightEmissions( ComputeTypicalFlightEmissionsRequest ) returns ( ComputeTypicalFlightEmissionsResponse )

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

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

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

ComputeFlightEmissionsRequest

Определение входных данных для запроса ComputeFlightEmissions .

Поля
flights[]

Flight

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

ComputeFlightEmissionsResponse

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

Поля
flight_emissions[]

FlightWithEmissions

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

model_version

ModelVersion

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

ComputeScope3FlightEmissionsRequest

Список сегментов полета, для которых необходимо запросить выбросы категории 3.

Поля
flights[]

Scope3FlightSegment

Требуется. Оценки выбросов для рейсов обратно.

model_version

ModelVersion

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

ComputeScope3FlightEmissionsResponse

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

Поля
flight_emissions[]

Scope3FlightEmissions

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

model_version

ModelVersion

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

Запрос на вычисление типичных выбросов в полете

Список пар аэропортов (рынков), для которых следует запросить типичные выбросы.

Поля
markets[]

Market

Обязательно. Запросите оценку типичных выбросов от авиаперевозок для этой пары рынков. Можно запросить максимум 1000 рынков.

ВычислитьТипичныйОтветВыбросовПолета

Ответ включает в себя данные о выбросах, а также версию модели.

Поля
typical_flight_emissions[]

TypicalFlightEmissions

Запрошенные рынком типичные выбросы при полетах.

model_version

ModelVersion

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

ContrailsImpactBucket

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

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

EasaLabelMetadata

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

Поля
label_issue_date

Date

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

label_expiry_date

Date

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

label_version

string

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

saf_discount_percentage

double

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

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

Выбросы в граммах на человека

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

Поля
first

int32

Выбросы на одного пассажира первого класса в граммах. Это поле всегда рассчитывается и заполняется, независимо от того, есть ли в самолёте места первого класса или нет.

business

int32

Выбросы на одного пассажира бизнес-класса в граммах. Это поле всегда рассчитывается и заполняется, независимо от того, есть ли в самолёте места бизнес-класса.

premium_economy

int32

Выбросы на одного пассажира премиум-эконом-класса в граммах. Это поле всегда рассчитывается и заполняется, независимо от того, есть ли в самолёте места премиум-эконом-класса или нет.

economy

int32

Выбросы на одного пассажира в эконом-классе в граммах. Это поле всегда рассчитывается и заполняется, независимо от того, есть ли в самолёте места эконом-класса.

Полет

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

Поля
origin

string

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

destination

string

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

operating_carrier_code

string

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

flight_number

int32

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

departure_date

Date

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

FlightWithEmissions

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

Поля
flight

Flight

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

source

Source

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

emissions_grams_per_pax

EmissionsGramsPerPax

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

easa_label_metadata

EasaLabelMetadata

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

contrails_impact_bucket

ContrailsImpactBucket

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

Рынок

Пара аэропортов.

Поля
origin

string

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

destination

string

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

МодельВерсия

Версия модели Travel Impact. Подробнее о версиях модели см. на GitHub .

Поля
major

int32

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

minor

int32

Второстепенные версии: изменения в модели, которые, оставаясь единообразными во всех версиях схемы, изменяют параметры модели или ее реализацию.

patch

int32

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

dated

string

Устаревшие версии: наборы данных моделей воссоздаются с обновленными входными данными, но в алгоритмы регулярно не вносятся изменения.

Scope3FlightEmissions

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

Поля
flight

Scope3FlightSegment

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

wtw_emissions_grams_per_pax

int64

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

ttw_emissions_grams_per_pax

int64

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

wtt_emissions_grams_per_pax

int64

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

source

Scope3DataType

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

Scope3DataType

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

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

Scope3FlightSegment

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

Поля
departure_date

Date

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

cabin_class

CabinClass

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

origin

string

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

destination

string

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

carrier_code

string

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

flight_number

int32

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

distance_km

int64

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

CabinClass

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

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

Источник

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

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

Типичные выбросы в полете

Типичные оценки выбросов при полетах для определенного рынка

Поля
market

Market

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

emissions_grams_per_pax

EmissionsGramsPerPax

Необязательно. Типичные выбросы на одного пассажира для запрашиваемого рынка. Данные не будут представлены, если не удалось рассчитать типичные выбросы. Список причин, по которым не удалось рассчитать типичные выбросы на одного пассажира, см. на GitHub .