Method: batchGetAttributions

Получает множественные атрибуции инверсионного следа по информации о полете.

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

HTTP-запрос

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

URL использует синтаксис перекодировки gRPC .

Параметры пути

Параметры
parent

string

Обязательно. Родительский ресурс, общий для всех извлекаемых атрибуций. Формат: attributions

Параметры запроса

Параметры
names[]

string

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

Формат:

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} : трехбуквенный код аэропорта ИАТА (например, "JFK" , "LHR" ).

Текст запроса

Тело запроса должно быть пустым.

Тело ответа

Ответ, содержащий атрибутированные инверсионные следы для attributions.batchGet.

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

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} : трехбуквенный код аэропорта ИАТА (например, "JFK" , "LHR" ).
flightDetails

object ( FlightDetails )

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

contrail

object ( ContrailAttributes )

Агрегированные атрибуты инверсионного следа за весь полёт. Это суммирование атрибутов инверсионного следа по всем атрибутированным сегментам.

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

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

segments[]

object ( SegmentAttribution )

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

FlightDetails

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

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; str: ISO 8601 .

icao24

string

24-битный адрес воздушного судна ICAO

originAirport

string

Код аэропорта происхождения ИАТА.

destinationAirport

string

Код аэропорта назначения ИАТА.

callSign

string

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

analyzedFlightDistanceMeters

integer

Дальность анализируемого полета в метрах.

Атрибуты Contrail

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

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 )

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

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

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

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