Method: batchGetAttributions

フライト情報に基づいて複数の飛行機雲の帰属を取得します。

成功すると、レスポンスはコントレイル アトリビューションのリストになります。

HTTP リクエスト

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。取得されるすべてのアトリビューションで共有される親リソース。形式: attributions

クエリ パラメータ

パラメータ
names[]

string

必須。取得するフライトのリソース名。1 回のリクエストで最大 100 個の名前を指定できます。

形式:

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" など）。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

attributions.batchGet の帰属コントレイルを含むレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

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}: IATA の 3 レター空港コード（例: "JFK"、"LHR"）に含めることが可能です。
flightDetails

object (FlightDetails)

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

object (ContrailAttributes)

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

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

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

この特定のセグメントの Contrail 属性。
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

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

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