Method: batchGetAttributions

根据航班信息获取多个航迹云归因。

如果成功，响应将是凝结尾迹归因的列表。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。正在检索的所有提供方信息的共享父资源。格式：提供方信息

查询参数

参数
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}：3 个字母的 IATA 机场代码（例如，"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}：3 个字母的 IATA 机场代码（例如，"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 时间戳；str：ISO 8601。
icao24

string

ICAO 24 位飞机地址
originAirport

string

IATA 出发地机场代码。
destinationAirport

string

IATA 目的地机场代码。
callSign

string

与航点关联的飞行器的呼号。
analyzedFlightDistanceMeters

string (int64 format)

所分析的飞行距离（以米为单位）。

ContrailAttributes

表示航班的凝结尾迹属性。

JSON 表示法 
{
  "lengthMeters": string,
  "effectiveEnergyForcingJoules": string
}
字段
lengthMeters

string (int64 format)

凝结尾迹形成的大致长度，以米为单位。
effectiveEnergyForcingJoules

string (int64 format)

归因于相应航班的总有效能量强迫，单位为焦耳。