Attributions

特定のフライトのリストに帰属する飛行機雲セグメント。

データ形式

帰属するコントレイルのリクエストには、次の構造のデータが含まれます。

JSON 表現 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
フィールド
attributions[]

object (Attribution)

BatchGetAttributionsRequest.names で指定されたリソース名ごとに 1 つの帰属リスト。このリストの帰属の順序は、BatchGetAttributionsRequest の名前の順序と一致します。フライトが見つからなかった場合、レスポンス内の対応するアトリビューション メッセージには name フィールドのみが入力され、flightDetails と contrail は空になります。

アトリビューション

特定のフライトの凝縮飛行機雲イベントを表し、すべての帰属凝縮飛行機雲セグメント（総キロメートル数やエネルギーなど）を要約します。

JSON 表現 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
フィールド
name

string

ID。フライトのリソース名。

形式:

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

コンポーネント:

  • {carrier}: 2 文字の IATA 航空会社コード（例: "AA"、"UA"）。
  • {flightNumber}: 1 ～ 4 桁のフライト番号（例: "123"）。
  • {departure_date}: 出発地の空港の現地時間に基づくフライトの出発日（YYYY-MM-DD 形式）。
  • {departure_airport}: 3 文字の IATA 空港コード（例: "JFK"、"LHR"）。
flightDetails

object (FlightDetails)

このフライトの詳細情報。
contrail

object (ContrailAttributes)

フライト全体の凝縮雲属性を集計します。これは、すべての帰属セグメントの飛行機雲属性を合計します。

状態の解釈（見つかったフライト内）:

  • 存在する場合: Contrail 分析が実行されました。ContrailAttributes 内のフィールドは結果を示します（例: lengthMeters > 0 は飛行機雲が原因とされたことを意味します）。空の ContrailAttributes メッセージが存在する場合、分析は実行されたものの、lengthMeters とエネルギー強制の両方がゼロと評価されたことを意味します。
  • 存在しない場合: このフライトの飛行機雲分析は実行できませんでした。
    • 通常、これは入力データが不十分なことが原因です（天気データがない、飛行経路の不確実性など）。
    • これは、飛行機雲が形成されなかったという意味ではなく、判断できなかったという意味です。
segments[]

object (SegmentAttribution)

セグメントごとのコントレイル アトリビューション。各エントリは、飛行機雲が割り当てられたフライトの個別の時間間隔を表します。

FlightDetails

レスポンスで返されるフライト情報の完全なセットを定義します。

JSON 表現 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
フィールド
carrier

string

フライトの IATA 航空会社コード（例: 「AA」）。
flightNumber

integer

フライトのフライト番号（例: 「123」）。
departureTime

string

出発空港のタイムゾーンでの出発日（YYYYMMDD 形式）。
icao24

string

ICAO 24 ビット航空機アドレス
originAirport

string

IATA の出発空港コード。
destinationAirport

string

目的地の空港の IATA コード。
callSign

string

航空機のコールサイン。このフィールドには、航空交通管制（ATC）通信で使用されるコールサインが優先的に含まれます。特定の ATC コールサインが利用できない場合や、標準のフライト指定子と同じ場合は、このフィールドに標準のフライト指定子（通常は、商用フライトの航空会社コードとフライト番号の組み合わせ）が格納されます。
analyzedFlightDistanceMeters

integer

分析されたフライトの距離（メートル単位）。

ContrailAttributes

フライトまたはフライト区間の飛行機雲の属性を表します。

JSON 表現 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
フィールド
lengthMeters

integer

飛行機雲が割り当てられた飛行経路のサブセットの長さ（メートル単位）。これは、フライトの経由地間の大円距離として計算されます。
effectiveEnergyForcingJoules

string (int64 format)

有効な飛行機雲のエネルギー強制力の合計（ジュール単位）。これは、4D グリッド CoCiP 予測出力から実効放射強制力を抽出し、線形補間することで導出されます。この方法は変更されることがあります。

SegmentAttribution

フライトの特定の時間セグメントの飛行機雲の属性を表します。

JSON 表現 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
フィールド
startTime

string (Timestamp format)

飛行機雲が関連付けられているフライト セグメントの開始時刻。このタイムスタンプは UTC エポック秒単位です。
endTime

string (Timestamp format)

飛行機雲が帰属するフライト セグメントの終了時間。このタイムスタンプは UTC エポック秒単位です。
contrail

object (ContrailAttributes)

この特定のセグメントの Contrail 属性。
detectionEvidences[]

object (ContrailDetectionEvidence)

このフライト セグメントへの帰属の証拠となる個々の衛星の飛行機雲の検出。
attributionMethod

enum (AttributionMethod)

出力専用。このセグメントに飛行機雲を帰属させるために使用された方法（CoCiP モデルや直接観測など）。
longGapInterpolation

boolean

出力専用。セグメントの飛行経路が、長い ADS-B データギャップ（5 分超）を補間して生成された場合は true。
waypointAttributions[]

object (WaypointAttribution)

出力専用。このセグメントにマッピングされた経由地ごとの飛行機雲の属性。

ContrailDetectionEvidence

飛行機雲の単一の衛星観測の詳細。

JSON 表現 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
フィールド
observationTime

string (Timestamp format)

飛行機雲が検出された衛星画像が撮影された時刻。通常、これはスキャンの開始時刻です。このタイムスタンプは UTC エポック秒単位です。
observedLengthMeters

integer

observationTime で指定された衛星画像で検出された、線形飛行機雲の端から端までの長さ（メートル単位）。この長さは、次の理由により SegmentAttribution.contrail の lengthMeters と異なる場合があります。

  • 飛行機雲は、形成から観測までの間に大気中で変化（拡大、延長など）している可能性があります。
  • この帰属アルゴリズムでは、この飛行機雲の一部のみをこのフライトに確実に帰属させることができました。
dataSource

enum (DataSource)

出力専用。この検出に使用された衛星データのソース。

DataSource

飛行機雲の検出に使用される衛星データのソース。今後、値が追加される可能性があります。

利用可能な衛星データ出力のうち、GOES East と Himawari に基づく帰属は本番環境レベルの品質ですが、MTG に基づく帰属はまだベータ版であり、品質の改善が積極的に行われています。

列挙型
DATA_SOURCE_UNSPECIFIED 未指定のデータソース。
GOES_EAST_FULL_DISK GOES-East のフルディスク スキャンからのデータ。
GOES_WEST_FULL_DISK GOES-West の全ディスク スキャンからのデータ。
MTG_000_FULL_DISK MTG-000 のディスク全体のスキャンからのデータ。
HIMAWARI_FULL_DISK ひまわりの全ディスク スキャンからのデータ。

Contrails API の衛星画像は、以下に基づいています。

WaypointAttribution

フライト区間の特定の経由地の飛行機雲の属性を表します。

JSON 表現 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
フィールド
time

string (Timestamp format)

ウェイポイントの時刻（UTC エポックからの経過秒数）。
contrailAttributes

object (ContrailAttributes)

この特定の経由地でマッピングされた飛行機雲の属性。

AttributionMethod

アトリビューションの実施に使用される特定の手順または方法を定義します。

列挙型
ATTRIBUTION_METHOD_OBSERVATION 衛星の飛行機雲の検出との照合によって厳密に導き出されたアトリビューション。
ATTRIBUTION_METHOD_COCIP 物理ベースの CoCiP モデリングのみに依存するアトリビューション。
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

衛星検出によって調整された CoCiP モデルの予測を組み合わせたハイブリッド アトリビューション。

  • 検出あり: detectionEvidences が存在する場合、飛行機雲が予測され、観測によって確認されたため、温暖化の重みが強化されています。
  • 検出なし: detectionEvidences がない場合、飛行機雲は予測されたものの観測されなかったため、計算された温暖化は割引されます。
ATTRIBUTION_METHOD_UNSPECIFIED メソッドが指定されていません。

メモ

各 DataSource は、観測ベースのビューを処理するために異なる境界を使用します。

衛星カバレッジの境界ボックス（平面メルカトル図法）

ライセンス

ContrailWatch Attributions API によって公開されるデータは、CC BY-NC 4.0 に基づいてライセンス付与されます。