Contrails API 總覽

探索 Contrails API 的開發潛能，並瞭解其端點的行為。

總覽

Contrails API 結合大規模天氣資料、航班資料和衛星影像，以及最先進的電腦視覺模型，產生 AI 輔助的凝結尾跡預測結果。這些預測結果會顯示未來 48 小時內，可能出現凝結尾跡的區域，以及凝結尾跡可能造成的影響。

將這些預測結果整合到飛行計畫工作流程中，有助於飛行員避開這些區域，防止暖化凝結尾流產生。

如要瞭解這些資訊，包括凝結尾跡的形成位置和升溫程度，請使用 Contrails API 提供的格線和區域預報。

Contrails API 提供以下形式的預測：

格線：高傳真 4D 資料，代表緯度、經度、海拔和時間軸上的凝結尾流強迫指數值，格式為 NetCDF。這些格線代表整個地球，以四分之一度的格線呈現，緯度和經度的步階為 0.25 度。每個格線都是以世界標準時間預測一整小時的資料。

凝結尾雲強制指數值範圍為 0 到 4，0 代表沒有明顯升溫的地點，4 則代表凝結尾雲升溫嚴重。

建議使用格線規劃程式輔助航班，尤其是重新安排航班時。
區域：預報的簡化多邊形版本，以 GeoJSON 多重多邊形格式表示避開凝結尾跡的區域。

凝結尾跡迴避區域的評估嚴重程度與上述相同，但會省略 0，只從 1 (輕微影響) 開始。

建議由人工航班規劃人員使用區域，他們可以根據嚴重程度制定政策，並手動重新安排航班路線，通常是透過垂直偏差 (即調整飛行高度)。

如要使用 Contrails API，您需要 API 金鑰，且必須啟用 Contrails API。

詳情請參閱「設定環境」指南。

使用 Contrails API 時，可能會遇到下列錯誤：

程式碼	原因	處理錯誤
400 (無效要求)	要求提供錯誤資料	不要自動重試。這個錯誤是由程式碼問題所致，請檢查您是否使用正確的參數格式。
404	要求尚未計算的預測時間	以指數輪詢策略重試。
429	要求數量過多 (請參閱「用量限制」)	以指數輪詢方式重試。
5XX	伺服器錯誤	以指數輪詢方式重試。

主要版本 (例如 v2) 可能會推出與舊版不相容的行為，因此可能需要變更程式碼。

主要版本發布之間的定期更新應可回溯相容。

如要瞭解重大更新，請參閱 Contrails API 版本資訊。