Method: flights.computeScope3FlightEmissions

범위 3 보고를 위해 일련의 항공편 구간에 대한 온실가스 배출량 추정치를 가져옵니다.

응답에는 입력된 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를 사용하는 것이 좋습니다.

세 가지 방법 중 어느 것으로도 특정 항공편의 추정치를 확인할 수 없는 경우 응답은 탄소 배출량 필드가 비어 있는 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 (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에서 거리(킬로미터, 예: 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)

식별자. 요청의 운항 식별자와 일치합니다.
wtwEmissionsGramsPerPax

string (int64 format)

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

string (int64 format)

선택사항입니다. 요청된 정보를 기반으로 한 승객당 탱크 투 웨이크(tank-to-wake) 항공편 배출량입니다.
wttEmissionsGramsPerPax

string (int64 format)

선택사항입니다. 요청된 정보를 기반으로 한 승객당 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 이동 거리 및 연도를 기준으로 한 거리 기반 배출량입니다.