Атрибуции

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

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

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

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 означает, что инверсионные следы были атрибутированы).
  • Если отсутствует: Анализ инверсионных следов для данного полета НЕ мог быть проведен.
    • Как правило, это происходит из-за недостатка входных данных (например, отсутствие данных о погоде или неопределенность траектории полета).
    • Это НЕ означает, что инверсионные следы не образовались, а лишь то, что сделать однозначный вывод невозможно.

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

Дата вылета в часовом поясе аэропорта отправления; int: unix epoch OR str: ISO 8601.

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)

Суммарное эффективное энергетическое воздействие инверсионного следа, в джоулях. В настоящее время рассчитывается на основе климатологических средних значений и может изменяться.

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

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

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

string ( Timestamp format)

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

endTime

string ( Timestamp format)

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

contrail

object ( ContrailAttributes )

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

detectionEvidences[]

object ( ContrailDetectionEvidence )

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

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

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

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

string ( Timestamp format)

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

observedLengthMeters

integer

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

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

enum ( DataSource )

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

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

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

В настоящее время доступны спутниковые данные GOES East и MTG. Атрибуция на основе GOES East имеет качество, сопоставимое с производственным уровнем, в то время как атрибуция на основе 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.