Method: flights.computeDetailedFlightEmissions

자세한 예상 탄소 배출량을 가져옵니다.

자세한 항공편 탄소 배출량은 계산 방법, 탄소 배출량 분류, 비행운 영향, 데이터 출처를 자세히 설명하는 포괄적인 메타데이터로 보완된 승객별 온실가스 배출량 추정치입니다.

배출량 추정치 계산 방법에 관한 자세한 내용은 GitHub를 참고하세요.

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

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

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

HTTP 요청

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

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

요청 본문

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

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)

출력 전용입니다. 요청의 항공편 식별자와 일치합니다. 참고: 모든 IATA 코드는 대문자로 표시됩니다.
flightEmissionsDetails

object (FlightEmissionsDetails)

출력 전용입니다. 모든 항공편 배출량 데이터입니다.
emissionsMetadata

object (EmissionsMetadata)

출력 전용입니다. 항공편 배출량 계산에 관한 추가 메타데이터입니다.

FlightEmissionsDetails

특정 항공편의 배출량에 관한 세부정보입니다.

JSON 표현 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
필드
emissionsGramsPerPax

object (EmissionsGramsPerPax)

출력 전용입니다. 승객별 예상 탄소 배출량입니다. 배출량을 계산할 수 없는 경우 표시되지 않습니다. 탄소 배출량을 계산할 수 없는 이유 목록은 flights.computeDetailedFlightEmissions를 참고하세요.
emissionsBreakdown

object (EmissionsBreakdown)

출력 전용입니다. 총 배출량(GramsPerPax 값)의 다양한 배출량 부분에 관한 세부정보입니다. 합산된 분류 값은 항상 emissionsGramsPerPax와 같아야 합니다.
contrailsImpactBucket

enum (ContrailsImpactBucket)

출력 전용입니다. 전체 CO2e 배출량 영향과 비교한 비행운 온난화 영향의 중요도입니다.
source

enum (Source)

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

EmissionsBreakdown

총 배출량(GramsPerPax 값)의 다양한 배출량 부분에 관한 세부정보입니다. 합산된 분류 값은 항상 emissionsGramsPerPax와 같아야 합니다.

JSON 표현 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
필드
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

승객당 well-to-tank 배출량 추정치입니다. 배출량을 계산할 수 없는 경우 표시되지 않습니다. 배출량을 계산할 수 없는 이유 목록은 flights.computeFlightEmissions를 참고하세요.
ttwEmissionsGramsPerPax

object (EmissionsGramsPerPax)

승객당 탱크에서 파도까지의 예상 탄소 배출량 수치입니다. 배출량을 계산할 수 없는 경우 표시되지 않습니다. 배출량을 계산할 수 없는 이유 목록은 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 비행 단계에서 비행한 예상 거리(km)입니다. 설정되지 않은 경우 예상 비행 거리 값을 사용할 수 없습니다.

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 공식 항공 가이드 (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에 정의된 기본값 데이터입니다.