归因

特定航班列表的归因凝结尾迹段。

数据格式

针对归因于凝结尾迹的航班的请求包含具有以下结构的数据：

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)

各片段的凝结尾迹归因。每个条目都表示归因于凝结尾迹的航班的不同时间间隔。

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 时间戳或 str：ISO 8601。
icao24

string

ICAO 24 位飞机地址
originAirport

string

IATA 出发地机场代码。
destinationAirport

string

IATA 目的地机场代码。
callSign

string

飞行器的呼号。此字段优先包含在空中交通管制 (ATC) 通信中使用的呼号。如果特定 ATC 呼号不可用或与标准航班标识符相同，则此字段包含标准航班标识符（通常是航空公司代码和航班号的组合，适用于商业航班）。
analyzedFlightDistanceMeters

integer

所分析航班的距离（以米为单位）。

ContrailAttributes

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

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

integer

归因于凝结尾迹的飞行路径子集的长度（以米为单位）。此距离的计算方式为飞行途经点之间的大圆距离。
effectiveEnergyForcingJoules

string (int64 format)

总有效凝结尾气能量辐射强迫，以焦耳为单位。此值目前是根据气候平均值计算得出的，可能会发生变化。

SegmentAttribution

表示航班特定时间段的凝结尾迹归因。

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)

可为归因于相应飞行航段提供证据的单个卫星凝结尾检测结果。

ContrailDetectionEvidence

单次卫星观测到的凝结尾迹的详细信息。

JSON 表示法 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
字段
observationTime

string (Timestamp format)

检测到凝结尾迹的卫星图像的拍摄时间。这通常是扫描的开始时间。此时间戳以 UTC 时间戳（以秒为单位）表示。
observedLengthMeters

integer

在 observationTime 指定的卫星图像中检测到的线性凝结尾迹特征的观测到的端到端长度（以米为单位）。此长度可能与 SegmentAttribution.contrail 中的 lengthMeters 不同，原因如下：

  • 在凝结尾迹形成到被观测到的这段时间里，它可能在大气中发生了变化（例如扩散、变长等）。
  • 归因算法只能将部分航迹云可靠地归因于此航班。
dataSource

enum (DataSource)

仅限输出。用于检测的卫星数据的来源。

DataSource

用于凝结尾迹检测的卫星数据源。将来可能会添加其他值。

目前，GOES East 和 MTG 是可用的卫星数据输出。基于 GOES East 的归因具有生产级质量，而基于 MTG 的归因仍处于 Beta 版阶段，并且正在积极进行质量改进。

枚举
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 全盘扫描的数据。