Attributions

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

データ形式

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

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

object (Attribution)

BatchGetAttributionsRequest.names で指定されたリソース名ごとに 1 つのアトリビューションのリスト。このリストのアトリビューションの順序は、BatchGetAttributionsRequest の名前の順序と一致します。フライトが見つからなかった場合、レスポンス内の対応する Attribution メッセージには 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)

フライト全体の集計された飛行機雲属性。これは、帰属するすべてのセグメントの飛行機雲属性を合計したものです。

状態の解釈（検出されたフライト内）:

  • 存在する場合: 飛行機雲分析が実行されました。ContrailAttributes 内のフィールドは結果を示します（lengthMeters > 0 は飛行機雲が帰属したことを意味します）。
  • 存在しない場合: このフライトの飛行機雲分析を実行できませんでした。
    • 通常、これは入力データが不十分なことが原因です（気象データがない、フライトパスが不明確など）。
    • これは飛行機雲が形成されなかったという意味ではなく、判断できなかったという意味です。
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

出発地の空港のタイムゾーンでの出発日。int: Unix エポックまたは str: ISO 8601。
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)

飛行機雲の総エネルギー強制力（ジュール単位）。現在、これは気候学的平均に基づいて計算されており、変更される可能性があります。

SegmentAttribution

フライトの特定の時間セグメントの飛行機雲アトリビューションを表します。

JSON 表現 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
フィールド
startTime

string (Timestamp format)

飛行機雲が帰属するフライト セグメントの開始時刻。このタイムスタンプは UTC エポック秒です。
endTime

string (Timestamp format)

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

object (ContrailAttributes)

この特定のセグメントの飛行機雲属性。
detectionEvidences[]

object (ContrailDetectionEvidence)

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

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 は利用可能な衛星データ出力です。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 Himawari フルディスク スキャンからのデータ。