Contrails API の概要

Contrails API で構築できるものを確認し、エンドポイントの動作を理解します。

概要

Contrails API は、大規模な気象データ、フライトデータ、衛星画像を最先端のコンピュータビジョンモデルと組み合わせて、AI を活用した飛行機雲の予測を生成します。これらの予測では、今後 48 時間の飛行機雲の発生しやすいゾーンと、飛行機雲が与える可能性のある影響を予測します。

これらの予測を飛行計画のワークフローに統合することで、パイロットはこれらの地域を飛行することを回避し、温暖化コントレイルの発生を防ぐことができます。

飛行機雲がどこで発生し、どの程度温暖化に影響するかを把握するため、Contrails API は予測をグリッドとリージョンで提供します。

Contrails API は、次のように予測を提供します。

グリッド: 緯度、経度、高度、時間の軸で飛行機雲の強制力指数値を表す高忠実度の 4D データ。NetCDF 形式。これらのグリッドは、緯度と経度のステップが 0.25 度の 4 分の 1 度のグリッドとして地球全体を表します。各グリッドは 1 時間（UTC）の予測です。

Contrail 強制インデックス値の範囲は、温暖化が著しくない場所を表す 0 から、Contrail 温暖化が深刻な場所を表す 4 までです。

グリッドは、特にフライトの再ルーティングなど、プログラマティックなフライト計画におすすめです。
リージョン: 予測を簡略化してポリゴン化したバージョン。GeoJSON マルチポリゴン形式で飛行機雲回避リージョンを表します。

飛行機雲回避リージョンは同じ重大度レベルで評価されますが、0 は省略され、1（軽微な影響）から始まります。

地域は、重大度レベルに基づいてポリシーを確立し、通常は垂直方向の偏差（飛行高度の調整など）によって手動でフライトを再ルーティングできる人間のフライトプランナーにおすすめします。

Contrails API を使用するには、API キーが必要であり、Contrails API を有効にする必要があります。

詳しくは、環境の設定ガイドをご覧ください。

Contrails API を使用しているときに、次のエラーが発生することがあります。

コード	原因	エラー処理
400（無効なリクエスト）	間違ったデータを含むリクエスト	自動的に再試行しないでください。このエラーはコードの問題が原因で発生します。正しいパラメータ形式を使用していることを確認してください。
404	まだ計算されていない予測時間をリクエストする	指数バックオフ戦略で再試行します。
429	リクエストが多すぎます（使用量の上限を参照）	指数バックオフを使用して再試行する。
5XX	サーバーエラー	指数バックオフを使用して再試行する。

v2 のリリースなどのメジャーバージョンリリースでは、以前のリリースと互換性のない動作が導入される可能性があり、コードの変更が必要になる場合があります。

メジャーバージョンリリースの間の定期的なアップデートは、下位互換性があることが想定されています。

主な更新については、Contrails API のリリースノートをご覧ください。