Атрибуции

Присвоенные сегменты инверсионных следов для конкретного списка полетов.

Формат данных

Запросы на получение информации об отслеживаемых инверсионных следах содержат данные следующей структуры:

JSON-представление 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
Поля
attributions[]

object ( Attribution )

Список атрибутов, по одному для каждого имени ресурса, указанного в BatchGetAttributionsRequest.names . Порядок атрибутов в этом списке будет соответствовать порядку имен в BatchGetAttributionsRequest . Если рейс не найден, соответствующее сообщение об атрибутах в ответе будет содержать только поле name , а flightDetails и contrail будут пустыми.

Атрибуция

Представляет собой сводную информацию о следе от инверсионного следа для конкретного полета, суммирующую все соответствующие сегменты следа (например, общее расстояние в километрах и энергию).

JSON-представление 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
Поля
name

string

Идентификатор. Название ресурса рейса.

Формат:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

Компоненты:

  • {carrier} : 2-символьный код перевозчика IATA (например, "AA" , "UA" ).
  • {flightNumber} : 1-4-значный номер рейса (например, "123" ).
  • {departure_date} : Дата вылета рейса по местному времени аэропорта отправления в формате YYYY-MM-DD .
  • {departure_airport} : 3-буквенный код аэропорта IATA (например, "JFK" , "LHR" ).
flightDetails

object ( FlightDetails )

Подробная информация об этом рейсе.

contrail

object ( ContrailAttributes )

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

Интерпретация данных государством (в рамках обнаруженного рейса):

  • Если присутствует: Был выполнен анализ инверсионных следов. Поля внутри ContrailAttributes указывают на результаты (например, lengthMeters > 0 означает, что инверсионные следы были атрибутированы). Если присутствует пустое сообщение ContrailAttributes , это означает, что анализ был выполнен, но значения lengthMeters и энергии воздействия были равны нулю.
  • Если отсутствует: Анализ инверсионных следов для данного полета НЕ мог быть проведен.
    • Как правило, это происходит из-за недостатка входных данных (например, отсутствие данных о погоде или неопределенность траектории полета).
    • Это НЕ означает, что инверсионные следы не образовались, а лишь то, что сделать однозначный вывод невозможно.

segments[]

object ( SegmentAttribution )

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

Информация о рейсе

Определяет полный набор информации о рейсе, возвращаемой в ответе.

JSON-представление 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
Поля
carrier

string

Код авиакомпании IATA для данного рейса (например, "AA").

flightNumber

integer

Номер рейса (например, "123").

departureTime

string

Дата вылета в часовом поясе аэропорта отправления в формате ГГГГММДД.

icao24

string

24-битный адрес самолета ИКАО

originAirport

string

Код аэропорта отправления IATA.

destinationAirport

string

Код аэропорта назначения IATA.

callSign

string

Позывной воздушного судна. В этом поле предпочтительно указывается позывной, используемый в общении с диспетчерами управления воздушным движением (УВД). Если конкретный позывной УВД недоступен или совпадает со стандартным обозначением рейса, в этом поле указывается стандартное обозначение рейса (обычно комбинация кода авиакомпании и номера рейса для коммерческих рейсов).

analyzedFlightDistanceMeters

integer

Проанализированная дистанция полета, в метрах.

ContrailAttributes

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

JSON-представление 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
Поля
lengthMeters

integer

Длина в метрах подмножества (или подмножеств) траектории полета, к которым были отнесены инверсионные следы. Она рассчитывается как расстояние по большому кругу между путевыми точками полета.

effectiveEnergyForcingJoules

string ( int64 format)

Суммарное эффективное энергетическое воздействие инверсионного следа в джоулях. Оно определяется путем извлечения эффективного радиационного воздействия из результатов прогнозирования CoCiP в 4D-сетке и линейной интерполяции. Данная методология может быть изменена.

СегментАтрифм

Отражает информацию об отражении инверсионного следа в определенном временном отрезке полета.

JSON-представление 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
Поля
startTime

string ( Timestamp format)

Время начала участка полета, к которому относятся инверсионные следы. Эта временная метка указана в секундах UTC.

endTime

string ( Timestamp format)

Время окончания участка полета, к которому относятся инверсионные следы. Эта временная метка указана в секундах UTC.

contrail

object ( ContrailAttributes )

Характеристики инверсионных следов для этого конкретного участка.

detectionEvidences[]

object ( ContrailDetectionEvidence )

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

attributionMethod

enum ( AttributionMethod )

Только выходные данные. Метод, использованный для отнесения инверсионных следов к данному сегменту (например, модель CoCiP или прямое наблюдение).

longGapInterpolation

boolean

Только для вывода. Значение true, если траектория полета сегмента была сгенерирована путем интерполяции по длительному промежутку данных ADS-B (>5 минут).

waypointAttributions[]

object ( WaypointAttribution )

Только для вывода. Атрибуты инверсионного следа для каждой точки маршрута отображаются на этом участке.

Доказательства обнаружения следов

Подробности одного спутникового наблюдения инверсионного следа.

JSON-представление 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
Поля
observationTime

string ( Timestamp format)

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

observedLengthMeters

integer

Наблюдаемая длина линейного инверсионного следа в метрах, определенная на спутниковом снимке, указанном параметром observationTime . Эта длина может отличаться от lengthMeters в SegmentAttribution.contrail , поскольку:

  • Инверсионный след мог эволюционировать (например, расширяться, удлиняться и т. д.) в атмосфере в период между его образованием и наблюдением.
  • Алгоритм атрибуции смог с уверенностью отнести к данному рейсу лишь часть этого инверсионного следа.
dataSource

enum ( DataSource )

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

Источник данных

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

Среди доступных спутниковых данных, атрибуция на основе GOES East и Himawari имеет качество, соответствующее производственному уровню, в то время как атрибуция на основе MTG все еще находится на стадии бета-тестирования и активно проходит улучшение качества.

Перечисления
DATA_SOURCE_UNSPECIFIED Источник данных не указан.
GOES_EAST_FULL_DISK Данные получены в результате полного сканирования диска спутника GOES-East.
GOES_WEST_FULL_DISK Данные получены в результате полного сканирования диска спутника GOES-West.
MTG_000_FULL_DISK Данные получены в результате полного сканирования диска с помощью MTG-000.
HIMAWARI_FULL_DISK Данные получены в результате полного сканирования диска с помощью Himawari.

Спутниковые снимки Contrails API основаны на:

WaypointAttribution

Отображает характеристики инверсионного следа для конкретной точки маршрута на участке полета.

JSON-представление 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
Поля
time

string ( Timestamp format)

Время в точке маршрута в секундах по UTC-времени.

contrailAttributes

object ( ContrailAttributes )

Характеристики инверсионного следа, отображенные в этой конкретной точке маршрута.

Метод атрибуции

Определяет конкретную процедуру или методологию, используемую для установления авторства.

Перечисления
ATTRIBUTION_METHOD_OBSERVATION Атрибуция определяется исключительно путем сопоставления с данными о следах от спутников.
ATTRIBUTION_METHOD_COCIP Приписывание заслуг основано исключительно на физически обоснованном моделировании CoCiP.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

Гибридный метод атрибуции, сочетающий прогнозы модели CoCiP, скорректированные с учетом спутниковых данных.

  • При наличии данных обнаружения: если detectionEvidences подтверждают наличие инверсионного следа, значит, он был предсказан и подтвержден наблюдениями, и ему присвоен повышенный вес, связанный с эффектом потепления.
  • Без обнаружения: Если detectionEvidences отсутствует, значит, инверсионный след был предсказан, но не наблюдался, поэтому рассчитанное потепление не учитывается.
ATTRIBUTION_METHOD_UNSPECIFIED Метод не указан.

Примечания

Для обработки данных, полученных на основе наблюдений, каждый DataSource использует разные границы:

Ограничивающие рамки спутникового покрытия (плоское изображение Меркатора)

Лицензия

Данные, предоставляемые API ContrailWatch Attributions, распространяются по лицензии CC BY-NC 4.0 .