飛行機雲のアトリビューション指標を取得する

GET https://contrails.googleapis.com/v2/attributions:GetAttributionMetrics: 境界、タイムスタンプ、アトリビューション方法で集計された Contrail アトリビューション指標を取得します。

成功した場合、レスポンスは次の情報を含む AttributionMetrics オブジェクトを返します。

  • 指定された境界内の飛行経路のサブセットの長さ（メートル単位）を表す flight_attributed_length_metres フィールド。このサブセットに飛行機雲が関連付けられています。
  • 指定された境界内のすべての飛行機雲の有効エネルギー強制力（ジュール単位）を表す effective_energy_forcing_joules フィールド。有効エネルギー強制力は、グリッド化された CoCiP 予測出力から有効放射強制力を抽出し、線形補間することで導出されます。
  • 放射強制力（RF）から有効放射強制力（ERF）を取得するために使用される変換定数を表す rf_erf_conversion_factor フィールド。

クエリ パラメータ

パラメータ
bounds[]

string

必須。文字列ペアのリスト。各ペアは「緯度,経度」形式で、地理的領域を表す境界ポリゴンの頂点を指定する必要があります。

少なくとも 3 つの境界を指定する必要があります。境界は有効な S2Polygon ポリゴンを形成する必要があります（重複する頂点や自己交差がないなど）。S2Polygon の詳細については、S2Geometry のドキュメントをご覧ください。

例: ["37.7,-122.41", "37.78,-122.42", "37.79,-122.43"]
startTime

string

必須。リクエストされた属性付きコントレイル検出の開始時間。

形式: ISO 8601 日時文字列

例: 2026-01-20T21:00:00Z
endTime

string

必須。リクエストされたアトリビューションのコントレイル検出の終了時間（指定した時間を含む）。

なお、endTime は startTime を 14 日以上超えることはできません。

形式: ISO 8601 日時文字列

例: 2026-01-12T21:00:00Z
attributionMethod

enum (AttributionMethod)

必須。飛行機雲をフライト セグメントに帰属させるために使用される方法。

形式: ATTRIBUTION_METHOD_OBSERVATION、ATTRIBUTION_METHOD_COCIP、ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP のいずれかである必要があります。