Attributions

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

データ形式

属性付き飛行機雲のリクエストには、次の構造のデータが含まれます。

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

object (Attribution)

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

アトリビューション

特定のフライトの集計された飛行機雲イベントを表します。これには、関連付けられたすべての飛行機雲セグメント（合計キロメートル数やエネルギーなど）がまとめられています。

JSON 表現 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ],
  "visualizationUrl": string
}
フィールド
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 形式（2024 年以降に利用可能）。
  • {departure_airport}: 3 文字の IATA 空港コード（例: "JFK"、"LHR"）。
flightDetails

object (FlightDetails)

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

object (ContrailAttributes)

フライト全体の飛行機雲の属性を集計したもの。これにより、すべての属性付きセグメントの飛行機雲属性が合計されます。

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

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

object (SegmentAttribution)

セグメントごとの飛行機雲アトリビューション。各エントリは、飛行機雲が観測されたフライトの個別の時間間隔を表します。
visualizationUrl

string

出力専用。ContrailExplorer の ContrailWatch ページにある、このフライトの飛行機雲の帰属に関するインタラクティブな可視化へのリンク。衛星で検出された飛行機雲と一致する飛行経路が表示されます。

ATTRIBUTION_VIEW_OBSERVATION ビューを使用している場合に、見つかったフライトにのみ入力されます。

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)

この特定のセグメントの飛行機雲の属性。
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 とひまわりベースのアトリビューションは本番環境レベルの品質ですが、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 に基づいてライセンスが付与されています。