複数のコントレイル アトリビューションを取得する

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet: フライト情報で複数の飛行機雲アトリビューションを取得します。

成功すると、レスポンスはコントレイルの帰属リストになります。

デフォルトの OBSERVATION ビューとハイブリッド ビュー（OBSERVATION_ENHANCED_COCIP）の観測調整済みセグメントの場合、帰属は GOES-East（特に米国本土）、GOES-West、MTG（ヨーロッパ大陸）、Himawari（東アジア / アジア太平洋のサブリージョン）でカバーされているサブリージョンでのみ利用できます。GOES-East、GOES-West、Himawari ベースの帰属は本番環境レベルの品質ですが、MTG はベータ版です。これらの定義されたカバレッジ リージョンの外側、またはソースデータの長いギャップ（5 分超）の間は、フライトの影響の計算は物理ベースのモデリング（COCIP）にフォールバックします。

パスパラメータ

パラメータ
parent

string

必須。取得されるすべてのアトリビューションで共有される親リソース。形式: attributions

クエリ パラメータ

パラメータ
names[]

string

必須。取得するフライトのリソース名。1 回のリクエストで最大 100 個の名前を指定できます。

形式:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

コンポーネント:

  • {carrier}: 2 文字の IATA 航空会社コード（例: "AA"、"UA"）。
  • {flightNumber}: 1 ～ 4 桁のフライト番号（例: "123"）。
  • {departure_date}: YYYY-MM-DD 形式のフライト出発日（2024 年以降に利用可能。2024 年のデータはベスト エフォートで提供され、メンテナンスは行われません。2025 年以降のデータは積極的にメンテナンスされます）。
  • {departure_airport}: 3 文字の IATA 空港コード（例: "JFK"、"LHR"）。
view

enum (AttributionView)

省略可。フライトの影響を計算するために選択された方法論。デフォルトは ATTRIBUTION_VIEW_OBSERVATION です。

AttributionView

フライトの影響を計算するためにリクエストされた方法を定義します。

列挙型
ATTRIBUTION_VIEW_OBSERVATION 属性の影響は、一致した衛星の飛行機雲の検出のみに基づきます。一致するモニタリングがないセグメントは影響を受けません。高精度向けに最適化します。
ATTRIBUTION_VIEW_COCIP 属性の影響は、HRES 天気から 10 個のアンサンブルを使用した CoCiP モデル アンサンブル予測のみに基づきます。衛星観測は使用されません。再現率を最大化するように最適化します。
ATTRIBUTION_VIEW_OBSERVATION_ENHANCED_COCIP CoCiP と観察トラックを組み合わせたハイブリッド アプローチ。一致する衛星検出に基づいて、物理モデルの予測をスケーリングまたは割引します。
ATTRIBUTION_VIEW_UNSPECIFIED アトリビューション ビューが指定されていません。デフォルトは ATTRIBUTION_VIEW_OBSERVATION にフォールバックします。