Contrails API 概览

了解如何使用 Contrails API 构建应用，并了解其端点的行为。

概览

Contrails API 将大规模天气数据、航班数据和卫星图像与先进的计算机视觉模型相结合，生成由 AI 驱动的凝结尾迹预测。这些预测会预测未来 48 小时内可能形成凝结尾迹的区域以及凝结尾迹的潜在影响。

将这些预测结果整合到飞行规划工作流程中，有助于飞行员避免飞越这些区域，从而防止形成暖化凝结尾迹。

为了解这些关于凝结尾迹将在何处形成以及变暖程度的洞见，Contrails API 以网格和区域的形式提供预测。

Contrails API 以以下形式提供预测：

网格：高保真 4D 数据，以纬度、经度、海拔和时间为轴，表示凝结尾迹强迫指数值，采用 NetCDF 格式。这些网格以四分之一度网格表示整个地球，其中纬度和经度步长为 0.25 度。每个网格的预测时间均为一整小时（世界协调时间）。

凝结尾迹强迫指数值的范围为 0（表示没有明显变暖的位置）到 4（表示凝结尾迹变暖严重的位置）。

建议使用网格进行程序化飞行规划，尤其是在重新规划飞行路线时。
区域：简化的多边形化预测，以 GeoJSON 多边形格式表示飞机凝结尾迹规避区域。

凝结尾迹规避区域的严重程度评级相同，但省略了 0，仅从 1（轻微影响）开始。

建议人类飞行规划员使用区域，他们可以根据严重程度级别制定政策，并手动重新规划飞行路线，通常是通过垂直偏差（即通过调整飞行高度）来实现。

如需使用 Contrails API，您需要一个 API 密钥，并且必须启用 Contrails API。

如需了解详情，请参阅设置环境指南。

使用 Contrails API 时，您可能会遇到以下错误：

代码	原因	错误处理
400（无效请求）	包含错误数据的请求	不自动重试。此错误是由代码中的问题引起的；请检查您使用的参数格式是否正确。
404	请求尚未计算的预测时间	使用指数退避策略重试。
429	请求次数过多（请参阅用量限额）	使用指数退避算法重试。
5XX	服务器错误	使用指数退避算法重试。

主要版本发布（例如 v2 的发布）可能会引入与之前版本不兼容的行为，并可能需要更改代码。

主要版本发布之间的常规更新应向后兼容。

您可以参阅 Contrails API 版本说明，了解主要更新。