检索凝结尾气流归因指标

GET https://contrails.googleapis.com/v2/attributions:GetAttributionMetrics：按边界、时间戳和归因方法获取汇总的轨迹归因指标。

如果成功，响应将返回一个 AttributionMetrics 对象，其中包含：

  • 一个 flight_attributed_length_metres 字段，表示指定界限内归因于凝结尾迹的飞行路径子集的长度（以米为单位）。
  • 一个 effective_energy_forcing_joules 字段，表示指定边界内所有凝结尾的有效能量强迫，单位为焦耳。有效能量强迫是通过从网格化 CoCiP 预测输出中提取有效辐射强迫并对其进行线性插值来得出的。
  • 一个 rf_erf_conversion_factor 字段，表示用于从辐射强迫 (RF) 获取有效辐射强迫 (ERF) 的转化常数。

查询参数

参数
bounds[]

string

必需。字符串对列表，每对字符串都必须采用“纬度,经度”格式，用于指定表示地理区域的边界多边形的顶点。

必须至少指定三个边界。边界必须构成有效的 S2Polygon 多边形（例如，没有重复的顶点，没有自相交）；如需详细了解 S2Polygon，请参阅 S2Geometry 文档。

示例：["37.7,-122.41", "37.78,-122.42", "37.79,-122.43"]
startTime

string

必需。所请求的归因轨迹检测的开始时间。

格式：ISO 8601 日期时间字符串

示例：2026-01-20T21:00:00Z
endTime

string

必需。所请求的归因轨迹检测的结束时间（含此时间）。

请注意，endTime 不能比 startTime 晚超过 14 天。

格式：ISO 8601 日期时间字符串

示例：2026-01-12T21:00:00Z
attributionMethod

enum (AttributionMethod)

必需。用于将飞机尾迹归因于飞行路段的方法。

格式：必须是 ATTRIBUTION_METHOD_OBSERVATION、ATTRIBUTION_METHOD_COCIP 或 ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP。