Method: flights.computeDetailedFlightEmissions

詳細な排出量推定値を取得します。

フライトの二酸化炭素排出量の詳細では、乗客一人当たりの温室効果ガス排出量の推定値が透明性をもって示され、計算方法、排出量の内訳、飛行機雲の影響、データの出所に関する包括的なメタデータが補足されています。

排出量の推定値の計算方法について詳しくは、GitHub をご覧ください。

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

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

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

HTTP リクエスト

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

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

リクエストの本文

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

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

object (Flight)

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

レスポンスの本文

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

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

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

object (FlightWithDetailedEmissions)

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

object (ModelVersion)

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

FlightWithDetailedEmissions

直行便と推定排出量の詳細。

JSON 表現 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
フィールド
flight

object (Flight)

出力専用。リクエスト内のフライト ID と一致します。注: IATA コードはすべて大文字です。
flightEmissionsDetails

object (FlightEmissionsDetails)

出力専用。フライトの排出量データすべて。
emissionsMetadata

object (EmissionsMetadata)

出力専用。フライトの排出量計算に関する追加のメタデータ。

FlightEmissionsDetails

特定のフライトの排出量に関する詳細。

JSON 表現 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
フィールド
emissionsGramsPerPax

object (EmissionsGramsPerPax)

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

object (EmissionsBreakdown)

出力専用。総排出量（GramsPerPax）値のさまざまな排出量部分に関する詳細。合計された内訳の値は、常に emissionsGramsPerPax と等しくなるはずです。
contrailsImpactBucket

enum (ContrailsImpactBucket)

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

enum (Source)

出力専用。排出量データのソース。

EmissionsBreakdown

総排出量（GramsPerPax）値のさまざまな排出量部分に関する詳細。合計された内訳の値は、常に emissionsGramsPerPax と等しくなるはずです。

JSON 表現 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
フィールド
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

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

object (EmissionsGramsPerPax)

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

EmissionsMetadata

すべての追加メタデータ。

JSON 表現 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
フィールド
emissionsProvenance

object (EmissionsProvenance)

出力専用。排出量データの計算に使用されたデータの来歴の詳細。データソースを含む要因が表示されます。
easaLabelMetadata

object (EasaLabelMetadata)

出力専用。EASA のフライト排出量ラベルに関するメタデータ。排出量データソースが EASA の場合にのみ設定されます。
timWebsiteEmissionsCalculatorUrl

string

出力専用。travelimpactmodel.org 排出量計算ツールのウェブサイトへのリンク。例: https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225。

EmissionsProvenance

排出量推定値の計算に使用されたデータの来歴に関する情報。寄与要因とそのデータソースが含まれます。

JSON 表現 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
フィールド
provenanceEntries[]

object (EmissionsProvenance.EmissionsProvenanceEntry)

出力専用。排出量の計算に使用されるすべての要因。

EmissionsProvenance.EmissionsProvenanceEntry

排出量の計算における単一の要因に関する詳細。

JSON 表現 
{
  "provenanceEntryType": enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType),
  "source": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource),
  "sourceVersion": string,
  "dataCategory": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory),

  // Union field data_strategy can be only one of the following:
  "fuelBurnEeaStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy),
  "loadFactorsT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy),
  "loadFactorsChAviationStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy),
  "cargoMassFractionT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy),
  "seatAreaRatioIataStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy),
  "distanceAdjustmentStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)
  // End of list of possible types for union field data_strategy.

  // Union field data_value can be only one of the following:
  "loadFactorsData": number,
  "cargoMassFractionData": number,
  "seatAreaRatioData": {
    object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)
  },
  "estimatedFlightDistanceKm": integer
  // End of list of possible types for union field data_value.
}
フィールド
provenanceEntryType

enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType)

出力専用。プロビナンス エントリのタイプ。
source

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource)

出力専用。データのソース。
sourceVersion

string

出力専用。ソースデータのバージョン。例: 「2025/04」。
dataCategory

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory)

出力専用。データソースのデータカテゴリ。
共用体フィールド data_strategy。指定されたデータソースの排出量を計算するために使用される戦略。フィールド セットは data_source タイプに対応します。data_strategy は次のいずれかになります。
fuelBurnEeaStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy)

出力専用。EEA の燃料消費量に関する戦略。
loadFactorsT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy)

出力専用。T100 ロード ファクタの戦略。
loadFactorsChAviationStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy)

出力専用。CH Aviation のロード ファクターの戦略。
cargoMassFractionT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy)

出力専用。T100 貨物質量分率の戦略。
seatAreaRatioIataStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy)

出力専用。IATA 座席エリア比率の戦略。
distanceAdjustmentStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)

出力専用。距離調整の戦略。
共用体フィールド data_value。指定されたデータソースのデータ値。フィールド セットは provenance_entry_type に対応します。data_value は次のいずれかになります。
loadFactorsData

number

出力専用。負荷係数のデータ値。設定されていない場合、負荷係数の値は使用できません。
cargoMassFractionData

number

出力専用。貨物の質量分率の値。設定されていない場合、貨物質量分率の値は使用できません。
seatAreaRatioData

object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)

出力専用。各座席クラスの座席面積比率の値。設定しない場合、座席面積比の値は使用できません。
estimatedFlightDistanceKm

integer

出力専用。距離調整係数（DAF）を使用して計算された、CCD 飛行フェーズでの推定飛行距離（キロメートル単位）。設定されていない場合、推定飛行距離の値は使用できません。

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

プロビナンス エントリのタイプ。今後、新しい値が追加される可能性があります。クライアントは、不明な列挙値を適切に処理する準備をしておく必要があります。

列挙型
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED 未指定のプロビナンス エントリ タイプ。
FUEL_BURN 燃料消費量の入力タイプ。
LOAD_FACTORS 負荷係数のエントリタイプ。
CARGO_MASS_FRACTION 貨物の質量分率のエントリ タイプ。
SEATING_CONFIG 座席構成エントリのタイプ。
SEAT_AREA_RATIOS 座席エリア比率の入力タイプ。
DISTANCE_ADJUSTMENT 距離調整のエントリタイプ。

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

排出量の来歴要因のデータソース。今後、新しい値が追加される可能性があります。クライアントは、不明な列挙値を適切に処理する準備をする必要があります。

列挙型
DATA_SOURCE_UNSPECIFIED データソースが指定されていません。
EEA 欧州環境機関（EEA）が提供するデータ。
T100 米国運輸統計局が提供する T-100 データセットのデータ。
CH_AVIATION データ提供元: ch-aviation。
OAG データは Official Aviation Guide（OAG）から提供されています。
OPERATING_CARRIER 運航航空会社から提供されたデータ。
AIRCRAFT_MODEL_TYPICAL 航空機モデルに基づく一般的なデータ。
GLOBAL_DEFAULT 他のデータソースが利用できない場合に使用されるグローバル デフォルト値。
IATA 国際航空運送協会（IATA）が提供するデータ。
ICL データ提供: インペリアル カレッジ ロンドン。

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

EEA の燃料消費量に関する戦略。今後、新しい値が追加される可能性があります。クライアントは、不明な列挙値を適切に処理する準備をする必要があります。

列挙型
STRATEGY_UNSPECIFIED 戦略が指定されていません。
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR 静的な補正係数が適用されました。
AIRCRAFT_MAPPING_EXACT 正確な航空機マッピングが使用されました。
AIRCRAFT_MAPPING_FALLBACK フォールバック航空機マッピングが使用されました。

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

T100 ロード ファクタの戦略。今後、新しい値が追加される可能性があります。クライアントは、不明な列挙値を適切に処理する準備をする必要があります。

列挙型
STRATEGY_UNSPECIFIED 戦略が指定されていません。
CARRIER_ROUTE_MONTH 航空会社、路線、旅行月別のデータ。
CARRIER_MONTH 航空会社と旅行月別のデータ。
ACTUAL_CARRIER_ROUTE_YEAR_MONTH 航空会社、路線、年、月が一致する過去のデータ。

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

CH-Aviation のロード ファクタの戦略。今後、新しい値が追加される可能性があります。クライアントは、不明な列挙値を適切に処理する準備をする必要があります。

列挙型
STRATEGY_UNSPECIFIED 戦略が指定されていません。
CARRIER_MONTH 航空会社と旅行月別のデータ。
ACTUAL_CARRIER_YEAR_MONTH 運送業者、年、月が一致する過去のデータ。

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

T100 貨物質量分率の戦略。今後、新しい値が追加される可能性があります。クライアントは、不明な列挙値を適切に処理する準備をする必要があります。

列挙型
STRATEGY_UNSPECIFIED 戦略が指定されていません。
CARRIER_ROUTE_AIRCRAFT_CLASS 航空会社、路線、航空機クラス別のデータ。
ROUTE_AIRCRAFT_CLASS 路線と航空機クラス別のデータ。
DISTANCE_AIRCRAFT_CLASS 距離帯と航空機クラス別のデータ。
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS 航空会社、ルート、年、月、航空機クラスが一致する過去のデータ。

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

IATA 座席エリア比率の戦略。今後、新しい値が追加される可能性があります。クライアントは、不明な列挙値を適切に処理する準備をする必要があります。

列挙型
STRATEGY_UNSPECIFIED 戦略が指定されていません。
NARROW_AIRCRAFT_BODY ナローボディ機体の座席面積比率が使用されました。
WIDE_AIRCRAFT_BODY ワイドボディ機体の座席面積比率を使用しました。

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

距離調整の戦略。今後、新しい値が追加される可能性があります。クライアントは、不明な列挙値を適切に処理する準備をする必要があります。

列挙型
STRATEGY_UNSPECIFIED 戦略が指定されていません。
ORIGIN_DESTINATION 出発地と目的地の空港のペアによって決定される距離調整係数。
COUNTRY_PAIR 出発国と到着国のペアによって決定される距離調整係数。
DEFAULT 空港または国固有の調整係数が見つからなかったため、距離調整係数はデフォルト値に基づいています。

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

データソースのデータカテゴリ。今後、新しい値が追加される可能性があります。クライアントは、不明な列挙値を適切に処理する準備をする必要があります。

列挙型
DATA_CATEGORY_UNSPECIFIED データカテゴリが指定されていません。
PRIMARY ISO 14083 で定義されているプライマリ データ。
MODELED ISO 14083 で定義されているモデル化されたデータ。
DEFAULT ISO 14083 で定義されているデフォルト値データ。