版本说明

本页提供了 Contrails API 的版本说明。您可以 订阅公告，以便在即将发生变更时收到通知 。

2026-06-30

  • 使用新的可选 view 参数更新了 /v2/detections/masks，以返回卫星磁盘扫描时间偏移量。

2026-06-23

  • GetDetections 和 GetDetectionMasks 端点现在支持 GOES-WEST 卫星数据。

2026-06-08

  • 更新了 /v2/attributions:batchGet：
    • 使用 view 参数添加了对新归因选项的支持： OBSERVATION、COCIP 和混合 OBSERVATION_ENHANCED_COCIP。
    • 纳入了 Himawari 卫星区域，以便在生产级质量下进行基于卫星的匹配。
    • 在响应格式中添加了 waypointAttributions，以生成每个航点的凝结尾迹指标。
    • 将能量强迫计算从静态气候平均值更改为从网格化 CoCiP 预测输出得出的物理辐射强迫。

2026-05-12

  • 推出了 /v2/detections/masks。此方法可以从指定卫星检索每个请求最多一小时的检测掩码。

2026-04-23

  • 使 API 许可与预期用途保持一致。值得注意的是，预测 API 不再需要 ShareAlike。

2026-04-08

  • 推出了 /v2/detections。此方法可获取每个请求最多 24 小时的凝结尾迹检测结果，并且可以进行过滤，以仅返回来自特定卫星的凝结尾迹。

2026-03-30

  • 扩展了 /v2/grids 响应，以支持两个新的数据变量：

    • persistent_formation_probability：估计的持续凝结尾迹形成概率
    • nominal_cocip_effective_energy_forcing：CoCiP 模型在名义 IFS 天气预报（无集合）中提供的估计有效能量强迫

2025-10-24

  • 向可信测试人员推出了 /v2/attributions:batchGet。此方法可获取所有指定航班的凝结尾迹归因。

2025-08-28

  • /v2/grids 属性 forecast_reference_time 现在仅在底层天气预报发生变化时（每 6 小时）才会发生变化。这样可以更轻松地检测预报何时更新。有效预测频率没有变化。

2025-07-22

  • 扩展了 /v2/grids 响应，以包含数据变量属性 applied_erf_over_rf_ratio 以及应用的 ERF/RF 比率。例如，expected_effective_energy_forcing 使用的比率为 0.42。 底层数据没有变化。

2025-07-16

  • 扩展了 /v2/grids，以支持 ?data=expected_effective_energy_forcing，以便以 J/m 读取凝结尾迹预测。

2025-03-31

  • 推出了 /v2/grids。
  • 推出了 /v2/regions。
  • 已弃用 /v1/ API。