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

FlightDetails

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

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

string ( int64 format)

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

Атрибуты Contrail

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

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

string ( int64 format)

Расчетная длина инверсионного следа, в метрах.

effectiveEnergyForcingJoules

string ( int64 format)

Общая эффективная энергетическая вынуждающая сила, присущая данному полету, в джоулях.