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

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

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

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

クエリ パラメータ

パラメータ
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
view

enum (AttributionView)

必須。コントレイルをフライト セグメントに帰属させるために使用されるビュー。

形式: ATTRIBUTION_VIEW_OBSERVATION、ATTRIBUTION_VIEW_COCIP、ATTRIBUTION_VIEW_OBSERVATION_ENHANCED_COCIP のいずれかである必要があります。