Указание авторства

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

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

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

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

object (Attribution)

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

Атрибуция

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

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

string

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

Формат:

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

Компоненты:

  • {carrier} – двухсимвольный код авиакомпании по классификации ИАТА (например, "AA", "UA").
  • {flightNumber} – номер рейса, состоящий из 1–4 цифр (например, "123").
  • {departure_date} – дата вылета по местному времени аэропорта отправления в формате YYYY-MM-DD (доступно с 2024 года).
  • {departure_airport} – трехбуквенный код аэропорта по системе IATA (например, "JFK", "LHR").
flightDetails

object (FlightDetails)

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

object (ContrailAttributes)

Агрегированные атрибуты конденсационных следов для всего рейса. Это суммирует атрибуты инверсионного следа из всех сегментов с атрибутами.

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

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

object (SegmentAttribution)

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

string

Только для вывода. Ссылка на интерактивную визуализацию атрибуции следа этого рейса на странице ContrailWatch в ContrailExplorer. На ней показан маршрут рейса, сопоставленный с инверсионными следами, обнаруженными спутниками.

Заполняется только для найденных рейсов при использовании представления ATTRIBUTION_VIEW_OBSERVATION.

FlightDetails

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

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

string

Код авиакомпании, присвоенный ИАТА (например, AA).
flightNumber

integer

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

string

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

string

24-битный адрес воздушного судна ИКАО
originAirport

string

Код IATA аэропорта вылета.
destinationAirport

string

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

string

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

integer

Расстояние полета в метрах.

ContrailAttributes

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

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

integer

Длина в метрах подмножеств траектории полета, которым были приписаны инверсионные следы. Оно рассчитывается как расстояние по ортодромии между путевыми точками рейса.
effectiveEnergyForcingJoules

string (int64 format)

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

SegmentAttribution

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

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)

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

ContrailDetectionEvidence

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

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

string (Timestamp format)

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

integer

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

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

enum (DataSource)

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

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)

Атрибуты инверсионного следа, сопоставленные с этой путевой точкой.

AttributionMethod

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

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

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

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

Примечания

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

Граничные рамки спутникового покрытия (плоская проекция Меркатора)

Лицензия

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