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)
  },
  "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)

相应细分的 Contrail 属性。
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

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

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