Method: flights.computeFlightEmissions

탄소 배출량 추정치를 가져오는 상태 비저장 메서드입니다. 배출량 추정치 계산 방법에 관한 자세한 내용은 GitHub를 참고하세요.

응답에는 입력 항공편 구간과 일치하는 모든 항목이 동일한 순서로 포함됩니다. 특정 항공편 구간에 사용할 수 있는 추정치가 없으면 응답에서 배출량 필드가 비어 있는 항공편 구간 객체를 반환합니다. 요청은 여전히 성공한 것으로 간주됩니다. 예상 탄소 배출량이 누락되는 이유는 다음과 같습니다.

  • 서버에서 플라이트를 알 수 없습니다.
  • 입력 항공편 구간에 하나 이상의 식별자가 누락되어 있습니다.
  • 항공편 날짜가 과거입니다.
  • 항공기 유형이 모델에서 지원되지 않습니다.
  • 사용 가능 라이선스 수 구성이 누락되었습니다.

요청에는 최대 1,000개의 항공편 구간이 포함될 수 있습니다. 요청에 직항 항공편이 1, 000개를 초과하면 INVALID_ARGUMENT 오류가 발생합니다.

HTTP 요청

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

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

요청 본문

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

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)

필수 항목입니다. 출발 공항의 시간대로 표시된 항공편 날짜입니다. 현재 또는 미래의 날짜여야 합니다.

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 월과 일, 연도는 0(예: 기념일)
  • 연도만, 월과 일은 0
  • 연도와 월, 일은 0(예: 신용카드 만료일)

관련 유형:

JSON 표현 
{
  "year": integer,
  "month": integer,
  "day": integer
}
필드
year

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.
month

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.
day

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

FlightWithEmissions

예상 탄소 배출량이 표시된 직항편

JSON 표현 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
필드
flight

object (Flight)

필수 항목입니다. 요청의 항공편 식별자와 일치합니다. 참고: 모든 IATA 코드는 대문자로 표시됩니다.
source

enum (Source)

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

object (EmissionsGramsPerPax)

선택사항입니다. 승객당 예상 탄소 배출량입니다. 배출량을 계산할 수 없는 경우 표시되지 않습니다. 배출량을 계산할 수 없는 이유 목록은 flights.computeFlightEmissions를 참고하세요.
easaLabelMetadata

object (EasaLabelMetadata)

선택사항입니다. EASA 항공편 탄소 배출량 라벨에 관한 메타데이터입니다. 배출량 데이터 소스가 EASA인 경우에만 설정합니다.
contrailsImpactBucket

enum (ContrailsImpactBucket)

선택사항입니다. 전체 CO2e 배출량 영향과 비교한 비행운 온난화 영향의 중요도입니다.

소스

배출량 데이터의 소스입니다.

열거형
SOURCE_UNSPECIFIED 배출 데이터의 출처가 지정되지 않았습니다.
TIM 탄소 배출량 데이터는 여행 영향력 모델에서 가져온 것입니다.
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) 배출량 할인 비율입니다. 십진수 형태의 비율입니다. 값은 [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 배출량 영향보다 높습니다.