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 또는 3 배출량으로 대체됩니다. 요청된 향후 항공편이 올해에 없는 경우 빈 응답이 반환됩니다. 향후 버전에서는 computeFlightEmissions API를 대신 사용하는 것이 좋습니다.

세 가지 방법 중 어느 방법으로도 특정 항공편에 대한 추정치를 사용할 수 없는 경우 응답은 배출량 필드가 비어 있는 Scope3FlightEmissions 객체를 반환합니다. 요청은 여전히 성공한 것으로 간주됩니다. 일반적으로 탄소 배출량 추정치가 누락되는 경우는 서버에서 항공편을 알 수 없는 경우입니다 (예: 특정 항공편이 없거나 요청된 쌍에 대한 일반적인 항공편 탄소 배출량을 알 수 없음).

다음과 같은 경우 INVALID_ARGUMENT 오류로 인해 요청이 실패합니다.

  • 요청에 1,000개가 넘는 항공편 구간이 포함되어 있습니다.
  • 입력 항공편 구간에 식별자가 하나 이상 누락되어 있습니다. 예를 들어 TIM_EMISSIONS 또는 TYPICAL_FLIGHT_EMISSIONS 유형 일치에 유효한 거리가 없는 출발지/도착지가 누락되었거나 DISTANCE_BASED_EMISSIONS 유형 일치에 거리가 누락되었습니다 (거리 기반 배출량으로 대체하거나 거리 기반 배출량 추정치를 원하는 경우 거리를 지정해야 함).
  • 항공편 날짜가 2019년 이전입니다 (범위 3 데이터는 2019년 이후에만 제공됨).
  • 비행 거리가 0 이하입니다.
  • 좌석 등급이 누락되었습니다.

요청이 대체 로직으로 처리되므로 잘못 구성된 요청이 대체 방법을 사용하여 유효한 배출량 추정치를 반환할 수 있습니다. 예를 들어 요청에 잘못된 항공편 번호가 있지만 출발지와 도착지가 지정된 경우 요청은 계속 성공하지만 반환된 배출량은 일반적인 항공편 배출량만을 기반으로 합니다. 마찬가지로 일반적인 항공편 배출량 요청에 출처가 누락되었지만 유효한 거리가 지정된 경우 거리 기반 배출량에 따라 요청이 성공할 수 있습니다. 따라서 반환된 배출 (source)의 소스를 확인하여 결과가 예상대로인지 확인해야 합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

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 (CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
필드
departureDate

object (Date)

필수 항목입니다. 출발 공항의 시간대로 표시된 항공편 날짜입니다. 일반적인 항공편 및 거리 기반 배출 모델의 경우 연도만 필요합니다 (월 및 일 값은 무시되므로 이러한 경우 생략하거나 0으로 설정하거나 유효한 날짜로 설정할 수 있음). 마찬가지로 TIM 배출량에 특정 날짜가 제공되지 않으면 일반적인 항공편 (또는 거리 기반) 배출량으로 대체됩니다.
cabinClass

enum (CabinClass)

필수 항목입니다. 항공편의 좌석 등급입니다.
origin

string

선택사항입니다. 항공편 출발지의 IATA 공항 코드입니다(예: YVR). 목적지, 항공사, 항공편 번호와 함께 제공되는 경우 특정 항공편을 일치시키는 데 사용됩니다. 일치하는 항목이 없으면 먼저 제공된 출발지 및 도착지 공항 간의 일반적인 항공편과 항공편을 일치시키려고 시도합니다. 그렇지 않으면 항공편 거리가 제공된 경우 거리 기반 배출 모델이 사용됩니다.
destination

string

선택사항입니다. 항공편 목적지의 IATA 공항 코드입니다(예: ICN). 출발지, 항공사, 항공편 번호와 함께 제공되는 경우 특정 항공편을 일치시키는 데 사용됩니다. 일치하는 항목이 없으면 먼저 제공된 출발지 및 도착지 공항 간의 일반적인 항공편과 항공편을 일치시키려고 시도합니다. 그렇지 않으면 항공편 거리가 제공된 경우 거리 기반 배출 모델이 사용됩니다.
carrierCode

string

선택사항입니다. IATA 항공사 코드입니다(예: KE). 특정 항공편 일치를 원하는 경우 필요합니다. 그렇지 않으면 일반적인 항공편 및 거리 기반 배출 모델에서는 사용되지 않습니다. 운항 항공사 코드와 판매 항공사 코드 모두일 수 있습니다 (즉, 공동운항이 포함됨).
flightNumber

integer

선택사항입니다. 항공편 번호(예: 71) 이는 출발지, 목적지, 항공사와 함께 항공편 번호가 지정된 경우 특정 항공편을 일치시키는 데 먼저 사용됩니다. 항공편 번호가 지정되지 않은 경우 먼저 제공된 출발지 및 도착지 공항 간의 일반적인 항공편과 일치하는지 확인합니다. 이 방법이 실패하거나 출발지 및 도착지가 제공되지 않으면 제공된 항공편 거리를 기반으로 거리 기반 배출 모델이 사용됩니다.
distanceKm

string (int64 format)

선택사항입니다. 거리(킬로미터), 예: 2423 출발지와 도착지가 제공되지 않거나 일치하는 일반적인 항공편이 없는 경우 항공편을 거리 기반 탄소 배출량과 일치시키는 데 사용됩니다. 이 필드는 0~2.5e16km 사이의 값을 지원합니다.

CabinClass

항공편의 좌석 등급입니다.

열거형
CABIN_CLASS_UNSPECIFIED 지정되지 않은 좌석 등급입니다.
ECONOMY 이코노미 클래스
PREMIUM_ECONOMY 프리미엄 이코노미 클래스
BUSINESS 비즈니스 클래스
FIRST 퍼스트 클래스입니다.

Scope3FlightEmissions

탄소 배출량 추정치가 있는 범위 3 항공편

JSON 표현 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3DataType)
}
필드
flight

object (Scope3FlightSegment)

필수 항목입니다. 요청의 항공편 식별자와 일치합니다.
wtwEmissionsGramsPerPax

string (int64 format)

선택사항입니다. 요청된 정보를 기반으로 한 승객당 총 항공 배출량 (유정에서 탱크까지와 탱크에서 기상까지의 합계)입니다. 이는 총 배출량이며 TTW 또는 WTT 배출량을 사용해야 하는 특별한 이유가 없는 한 이 수치를 사용해야 합니다.
ttwEmissionsGramsPerPax

string (int64 format)

선택사항입니다. 요청된 정보를 기반으로 한 승객당 탱크에서 이륙까지의 항공편 배출량입니다.
wttEmissionsGramsPerPax

string (int64 format)

선택사항입니다. 요청된 정보를 기반으로 한 승객당 well-to-tank 항공 배출량입니다.
source

enum (Scope3DataType)

선택사항입니다. 배출량 데이터의 소스입니다.

Scope3DataType

범위 3 배출량을 계산하는 데 사용되는 일치 유형입니다. 배출량을 계산하는 데 사용된 방법을 표시하는 데 사용되며 범위 3 응답에 사용됩니다.

열거형
SCOPE3_DATA_TYPE_UNSPECIFIED 지정되지 않은 데이터 유형입니다.
TIM_EMISSIONS 출발지, 목적지, 항공사, 항공편 번호, 출발 날짜, 연도를 기준으로 한 TIM 기반 배출량입니다.
TYPICAL_FLIGHT_EMISSIONS 출발지, 목적지, 연도를 고려한 일반적인 항공편 탄소 배출량입니다.
DISTANCE_BASED_EMISSIONS 이동 거리와 연도를 기반으로 한 거리 기반 배출량입니다.