Method: flights.computeScope3FlightEmissions

スコープ 3 レポート用の一連のフライト区間の GHG 排出量の推定値を取得します。

レスポンスには、入力された Scope3FlightSegment フライト セグメントと一致するすべてのエントリが、指定された順序で含まれます。推定値は、次のカスケード ロジックを使用して計算されます（最初に使用可能なものを使用）。

  1. origin、destination、carrier、flightNumber、departureDate、cabinClass を指定した TIM ベースの排出量。
  2. origin、destination、departureDate の年、cabinClass を指定した場合の一般的なフライトの排出量。
  3. 距離ベースの排出量は、distanceKm、departureDate の年、cabinClass を使用して計算されます。

この暦年でリクエストされた将来のフライトがある場合、Tier 1 の排出量はサポートされず、Tier 2 または Tier 3 の排出量にフォールバックされます。リクエストされた将来のフライトが今年でない場合は、空のレスポンスが返されます。今後のフライトでは、代わりに computeFlightEmissions API を使用することをおすすめします。

3 つの方法のいずれでも特定のフライトの推定値を取得できない場合、レスポンスは排出量フィールドが空の Scope3FlightEmissions オブジェクトを返します。リクエストは成功とみなされます。一般に、排出量の推定値が欠落するのは、フライトがサーバーに認識されていない場合です（たとえば、特定のフライトが存在しない場合や、リクエストされたペアの一般的なフライト排出量が利用できない場合など）。

次の場合、リクエストは INVALID_ARGUMENT エラーで失敗します。

  • リクエストに 1,000 件を超えるフライト区間が含まれています。
  • 入力されたフライト区間に 1 つ以上の識別子がありません。たとえば、TIM_EMISSIONS タイプまたは TYPICAL_FLIGHT_EMISSIONS タイプのマッチングで有効な距離がない出発地/目的地がない、または DISTANCE_BASED_EMISSIONS タイプのマッチングで距離がない（距離ベースの排出量にフォールバックする場合や、距離ベースの排出量推定が必要な場合は、距離を指定する必要があります）。
  • フライトの日付が 2019 年より前である（スコープ 3 のデータは 2019 年以降のみ利用可能）。
  • フライト距離が 0 以下です。
  • 座席クラスが指定されていません。

リクエストはフォールバック ロジックで処理されるため、構成が誤っているリクエストでも、フォールバック メソッドを使用して有効な排出量推定値が返される可能性があります。たとえば、リクエストに間違った便名が含まれていても、出発地と目的地が指定されていれば、リクエストは成功しますが、返される排出量は一般的なフライトの排出量のみに基づきます。同様に、一般的なフライト排出量リクエストで出発地が指定されていないものの、有効な距離が指定されている場合、距離ベースの排出量のみに基づいてリクエストが成功する可能性があります。そのため、返された排出量のソース（source）を確認して、結果が想定どおりであることを確認する必要があります。

HTTP リクエスト

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

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

リクエストの本文

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

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

object (Scope3FlightSegment)

必須。排出量の推定値を返すフライト。
modelVersion

object (ModelVersion)

省略可。このリクエストのすべてのフライトの推定排出量の計算に使用されたモデルのバージョン。

レスポンスの本文

スコープ 3 の排出量推定値を含むフライトのリスト。

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

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

object (Scope3FlightEmissions)

推定排出量を含むフライト セグメントのリスト。
modelVersion

object (ModelVersion)

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

Scope3FlightSegment

スコープ 3 排出量の取得に使用されるフライト パラメータ。

JSON 表現 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
フィールド
departureDate

object (Date)

必須。出発空港のタイムゾーンでのフライトの日付。一般的なフライトおよび距離ベースの排出量モデルでは、年のみが必要です（月と日の値は無視されるため、省略するか、0 に設定するか、有効な日付に設定できます）。同様に、TIM 排出量に特定の日付が指定されていない場合は、一般的なフライト（または距離ベース）の排出量にフォールバックします。
cabinClass

enum (Scope3FlightSegment.CabinClass)

必須。フライトの座席クラス。
origin

string

省略可。フライトの出発地の 3 文字の IATA 空港コード（例: YVR）。これは、目的地、航空会社、フライト番号とともに指定された場合に、特定のフライトを照合するために使用されます。一致するフライトがない場合は、まず、指定された出発空港と到着空港の間の一般的なフライトとの照合が試行されます。それ以外の場合は、フライト距離が指定されていれば、距離ベースの排出量モデルが使用されます。
destination

string

省略可。フライトの目的地の 3 文字の IATA 空港コード（例: ICN）。これは、出発地、航空会社、便名とともに指定された場合に、特定のフライトを照合するために使用されます。一致するフライトがない場合は、まず、指定された出発空港と到着空港の間の一般的なフライトとの照合が試行されます。それ以外の場合は、フライト距離が指定されていれば、距離ベースの排出量モデルが使用されます。
carrierCode

string

省略可。2 文字の IATA 航空会社コード（例: KE）。特定のフライトとのマッチングが必要な場合は、このフィールドが必須です。それ以外の場合、このフィールドは一般的なフライトと距離ベースの排出量モデルでは使用されません。これは、運航航空会社とマーケティング航空会社の両方のコード（コードシェアを含む）にすることができます。
flightNumber

integer

省略可。最大 4 桁のフライト番号（例: 71、[1, 9999]）。これは、出発地、目的地、航空会社とともに便名が指定されている場合に、特定のフライトを照合するために最初に使用されます。フライト番号が指定されていない場合、まず、指定された出発空港と到着空港の間の一般的なフライトとの照合が試行されます。この方法が失敗した場合、または出発地と目的地が指定されていない場合は、指定された飛行距離に基づく距離ベースの排出量モデルを使用します。
distanceKm

string (int64 format)

省略可。[1, 1e12) km の距離（km 単位、例: 2423）。これは、出発地と目的地が指定されていない場合や、一致する一般的なフライトがない場合に、フライトを距離ベースの排出量に一致させるために使用されます。

Scope3FlightSegment.CabinClass

フライトの座席クラス。

列挙型
CABIN_CLASS_UNSPECIFIED 座席クラスが指定されていません。
ECONOMY エコノミークラス。
PREMIUM_ECONOMY プレミアム エコノミー クラス。
BUSINESS ビジネスクラス。
FIRST ファースト クラス。

Scope3FlightEmissions

推定排出量を含むスコープ 3 のフライト。

JSON 表現 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType),
  "modelVersion": string
}
フィールド
flight

object (Scope3FlightSegment)

ID。リクエスト内のフライト ID と一致します。
wtwEmissionsGramsPerPax

string (int64 format)

省略可。リクエストされた情報に基づく、乗客 1 人あたりの総フライト排出量（Well-to-Tank と Tank-to-Wake の合計）。これは総排出量であり、TTW 排出量または WTT 排出量を使用する特別な理由がない限り、この数値を使用する必要があります。
ttwEmissionsGramsPerPax

string (int64 format)

省略可。リクエストされた情報に基づく、乗客 1 人あたりのタンク・トゥ・ウェイク フライト排出量。
wttEmissionsGramsPerPax

string (int64 format)

省略可。リクエストされた情報に基づく、乗客 1 人あたりの Well-to-Tank フライト排出量。
source

enum (Scope3FlightEmissions.Scope3DataType)

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

string

省略可。排出量の計算に使用されたモデルのバージョン。

Scope3FlightEmissions.Scope3DataType

スコープ 3 排出量の計算に使用されるマッチングのタイプ。これはスコープ 3 の回答に使用され、排出量の計算に使用された方法を示します。

列挙型
SCOPE3_DATA_TYPE_UNSPECIFIED 未指定のデータタイプ。
TIM_EMISSIONS 出発地、目的地、航空会社、便名、出発日、出発年に基づく TIM ベースの排出量。
TYPICAL_FLIGHT_EMISSIONS 出発地、目的地、年を基準としたフライト標準排出量。
DISTANCE_BASED_EMISSIONS 移動距離と年に基づく距離ベースの排出量。