归因

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

数据格式

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

JSON 表示法 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
字段
attributions[]

object (Attribution)

归因列表，BatchGetAttributionsRequest.names 中指定的每个资源名称对应一个归因。此列表中归因的顺序将与 BatchGetAttributionsRequest 中名称的顺序一致。如果未找到航班，则响应中对应的 Attribution 消息将仅填充 name 字段，而 flightDetails 和 contrail 将为空。

归因

表示特定航班的汇总尾迹事件，汇总了所有归因尾迹航段（例如，总公里数和能量）。

JSON 表示法 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ],
  "visualizationUrl": string
}
字段
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（自 2024 年起提供）。
  • {departure_airport}：由 3 个字母组成的 IATA 机场代码（例如 "JFK"、"LHR"）。
flightDetails

object (FlightDetails)

此航班的详细信息。
contrail

object (ContrailAttributes)

整个航班的汇总尾迹属性。这会汇总所有归因片段的航迹云属性。

状态解读（在找到的航班内）：

  • 如果存在：已执行航迹云分析。ContrailAttributes 中的字段表示结果（例如，lengthMeters > 0 表示已归因尾迹）。如果存在空的 ContrailAttributes 消息，则表示已执行分析，但 lengthMeters 和能量强迫的求值结果均为零。
  • 如果不存在：无法对此航班执行尾迹分析。
    • 这通常是由于输入数据不足（例如，缺少天气数据或飞行路径不确定）所致。
    • 这并不意味着没有形成尾迹云，只是无法做出判断。
segments[]

object (SegmentAttribution)

每个航段的尾迹归因。每个条目代表航迹云所属航班的不同时间间隔。
visualizationUrl

string

仅限输出。链接到 ContrailExplorer 的 ContrailWatch 页面上此航班尾迹归因的交互式可视化图表。它显示了与卫星检测到的尾迹相匹配的飞行路径。

仅在使用 ATTRIBUTION_VIEW_OBSERVATION 视图时为找到的航班填充。

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

出发日期，采用出发机场所在时区的时间，格式为 YYYYMMDD。
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)

有效凝结尾迹总能量强迫（以焦耳为单位）。这是通过从 4D 网格化 CoCiP 预测输出中提取有效辐射强迫并对其进行线性插值而得出的。此方法可能会发生变化。

SegmentAttribution

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

JSON 表示法 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
字段
startTime

string (Timestamp format)

产生航迹云的航段的开始时间。此时间戳采用世界协调时间 (UTC) 纪元秒数。
endTime

string (Timestamp format)

归因于航迹云的航段的结束时间。此时间戳采用世界协调时间 (UTC) 纪元秒数。
contrail

object (ContrailAttributes)

此特定航段的航迹云属性。
detectionEvidences[]

object (ContrailDetectionEvidence)

卫星检测到的单个尾迹云，可作为归因于此航段的证据。
attributionMethod

enum (AttributionMethod)

仅限输出。用于将航迹云归因于此航段的方法（例如 CoCiP 模型或直接观测）。
longGapInterpolation

boolean

仅限输出。如果航段航迹是通过对较长的 ADS-B 数据间隙（>5 分钟）进行插值生成的，则为 True。
waypointAttributions[]

object (WaypointAttribution)

仅限输出。映射到此航段的每个航点的航迹云属性。

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 和 Himawari 的归因具有生产级质量，而基于 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 来自向日葵卫星全盘扫描的数据。

Contrails API 卫星图像基于：

WaypointAttribution

表示航段中特定航点的尾迹属性。

JSON 表示法 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
字段
time

string (Timestamp format)

航点的时间（以世界协调时间 [UTC] 纪元秒为单位）。
contrailAttributes

object (ContrailAttributes)

在此特定航点处映射的航迹云属性。

AttributionMethod

定义用于进行归因的具体程序或方法。

枚举
ATTRIBUTION_METHOD_OBSERVATION 严格通过与卫星尾迹检测结果进行匹配来确定归因。
ATTRIBUTION_METHOD_COCIP 完全依赖于物理驱动的 CoCiP 建模的归因。
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

混合归因，结合了 CoCiP 模型预测调整结果和卫星检测结果。

  • 检测到：如果 detectionEvidences 存在，则表示预测到了尾迹，并通过观测得到了证实，因此获得了更高的变暖权重。
  • 未检测到：如果缺少 detectionEvidences，则表示预测到了尾迹云，但未观测到，因此计算出的变暖效应会打折扣。
ATTRIBUTION_METHOD_UNSPECIFIED 未指定方法。

备注

每个 DataSource 使用不同的边界来处理基于观测的视图：

卫星覆盖范围边界框（平面墨卡托视图）

许可

ContrailWatch Attributions API 公开的数据已获得 CC BY-NC 4.0 许可。