归因

针对特定航班列表的归因凝结尾迹细分。

数据格式

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

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)
    }
  ]
}
字段
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 表示凝结尾迹已归因）。如果存在空的 ContrailAttributes 消息，则表示已执行分析，但 lengthMeters 和能量强制值都评估为零。
  • 如果不存在： 表示无法对此航班执行凝结尾迹分析。
    • 这通常是由于输入数据不足（例如缺少天气数据或航班路径不确定）造成的。
    • 这并不表示没有形成凝结尾迹，只是无法做出判断。
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

起飞日期，采用 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 来自 Himawari 全盘扫描的数据。

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 许可。