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)

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

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

飛行機雲による温暖化の影響の、総 CO2e 排出量の影響に対する重要性。

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