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

FlightDetails

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

JSON 表現 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": string
}
フィールド
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

経由地に関連付けられている航空機のコールサイン。
analyzedFlightDistanceMeters

string (int64 format)

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

ContrailAttributes

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

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

string (int64 format)

推定される航跡の長さ（メートル単位）。
effectiveEnergyForcingJoules

string (int64 format)

このフライトに起因する有効エネルギー強制力の合計（ジュール単位）。