Method: flights.computeFlightEmissions

排出量の推定値を取得するステートレス メソッド。排出量の推定値の計算方法については、GitHub をご覧ください。

レスポンスには、入力されたフライト レグと一致するすべてのエントリが同じ順序で含まれます。特定のフライト区間で推定値がない場合、レスポンスは排出量フィールドが空のフライト区間オブジェクトを返します。リクエストは成功とみなされます。排出量の推定値が表示されない理由としては、次のようなものが考えられます。

  • フライトがサーバーに認識されていません。
  • 入力されたフライトレグに 1 つ以上の識別子がありません。
  • フライトの日付が過去の日付です。
  • この航空機タイプはモデルでサポートされていません。
  • シート構成がありません。

リクエストには最大 1,000 個のフライト レッグを含めることができます。リクエストに 1, 000 を超える直行便が含まれている場合、INVALID_ARGUMENT エラーで失敗します。

HTTP リクエスト

POST https://travelimpactmodel.googleapis.com/v1/flights:computeFlightEmissions

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

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

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

object (Flight)

必須。二酸化炭素の推定排出量を返す直行便。

レスポンスの本文

flights.computeFlightEmissions レスポンスの出力定義。

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

JSON 表現 
{
  "flightEmissions": [
    {
      object (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
フィールド
flightEmissions[]

object (FlightWithEmissions)

推定排出量を含むフライト区間のリスト。
modelVersion

object (ModelVersion)

このレスポンス内のすべてのフライトの排出量推定値が計算されたモデル バージョン。

フライト

直行便の排出量推定値の単一のリクエスト アイテムに関連するすべての詳細。

JSON 表現 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
フィールド
origin

string

必須。フライトの出発地の IATA 空港コード（例: 「LHR」）。
destination

string

必須。フライトの目的地の IATA 空港コード（例: 「JFK」）。
operatingCarrierCode

string

必須。IATA 航空会社コード（例: AA）。
flightNumber

integer

必須。フライト番号（例: 324）。
departureDate

object (Date)

必須。出発空港のタイムゾーンでのフライトの日付。現在または将来の日付を指定する必要があります。

日付

誕生日などのように、カレンダーの日付全体またはその一部を表します。時間帯とタイムゾーンは、他の場所で指定されているか、重要ではありません。日付はグレゴリオ暦を基準にしています。これは次のいずれかを表します。

  • ゼロ以外の年、月、日の値を含む完全な日付。
  • 年の値がゼロである月と日（記念日など）。
  • 月と日の値がゼロである単独の年。
  • 日がゼロである年と月（クレジット カードの有効期限など）

関連するタイプ:

JSON 表現 
{
  "year": integer,
  "month": integer,
  "day": integer
}
フィールド
year

integer

その日付の年。1～9999、または年のない日付を指定する場合は 0 にする必要があります。
month

integer

1 年の中の月。1～12、または月と日のない年を指定する場合は 0 にする必要があります。
day

integer

1 月の中の日付。1～31 で、その年と月に対して有効である必要があります。または、日が重要でない場合に、年のみか年と月を指定するには 0 にする必要があります。

FlightWithEmissions

推定排出量が表示された直行便。

JSON 表現 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
フィールド
flight

object (Flight)

必須。リクエスト内のフライト ID と照合します。注: すべての IATA コードは大文字で表記します。
source

enum (Source)

省略可。排出量データのソース。
emissionsGramsPerPax

object (EmissionsGramsPerPax)

省略可。乗客 1 人あたりの推定排出量。排出量を計算できなかった場合は存在しません。排出量を計算できなかった理由の一覧については、flights.computeFlightEmissions をご覧ください。
easaLabelMetadata

object (EasaLabelMetadata)

省略可。EASA のフライト排出量ラベルに関するメタデータ。排出量データソースが EASA の場合にのみ設定されます。
contrailsImpactBucket

enum (ContrailsImpactBucket)

省略可。飛行機雲による温暖化の影響の、総 CO2e 排出量に対する割合。

ソース

排出量データのソース。

列挙型
SOURCE_UNSPECIFIED 排出量データのソースは指定されていません。
TIM 排出量データは Travel Impact Model のものです。
EASA 排出量データは EASA の環境ラベルのものです。

EasaLabelMetadata

EASA のフライト排出量ラベルに関するメタデータ。

JSON 表現 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
フィールド
labelIssueDate

object (Date)

ラベルが発行された日付。
labelExpiryDate

object (Date)

ラベルの有効期限。ラベルは、この日付の終了まで表示できます。
labelVersion

string

ラベルのバージョン。
safDiscountPercentage

number

ラベルに適用される持続可能な航空燃料（SAF）の排出量割引率。これは、10 進数で表した割合です。値は区間 [0,1] 内にあります。たとえば、0.0021 は 0.21% を意味します。

この割引と排出量の削減は EASA ラベルで報告されますが、この API で配信される CO2e の推定値には含まれていません。

ContrailsImpactBucket

飛行機雲による温暖化の影響の、二酸化炭素換算排出量全体に対する割合。

列挙型
CONTRAILS_IMPACT_UNSPECIFIED 飛行機雲の影響は指定されていません。
CONTRAILS_IMPACT_NEGLIGIBLE 飛行機雲の影響は、CO2e の総排出量と比較するとごくわずかです。
CONTRAILS_IMPACT_MODERATE 飛行機雲の影響は、二酸化炭素換算排出量の合計に匹敵します。
CONTRAILS_IMPACT_SEVERE 飛行機雲の影響は、CO2e 総排出量の影響よりも大きくなります。