Package google.travel.sustainability.travelimpactmodel.v1

색인

• TravelImpactModelService(인터페이스)
• ComputeFlightEmissionsRequest(메시지)
• ComputeFlightEmissionsResponse(메시지)
• ComputeScope3FlightEmissionsRequest(메시지)
• ComputeScope3FlightEmissionsResponse(메시지)
• ComputeTypicalFlightEmissionsRequest(메시지)
• ComputeTypicalFlightEmissionsResponse(메시지)
• ContrailsImpactBucket(열거형)
• EasaLabelMetadata(메시지)
• EmissionsGramsPerPax(메시지)
• Flight(메시지)
• FlightWithEmissions(메시지)
• Market(메시지)
• ModelVersion(메시지)
• Scope3FlightEmissions(메시지)
• Scope3FlightEmissions.Scope3DataType(열거형)
• Scope3FlightSegment(메시지)
• Scope3FlightSegment.CabinClass(열거형)
• Source(열거형)
• TypicalFlightEmissions(메시지)

TravelImpactModelService

탄소 배출량 추정치를 제공하는 API

ComputeFlightEmissions

rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse) 탄소 배출량 추정치를 가져오는 상태 비저장 메서드입니다. 배출량 추정치 계산 방법에 관한 자세한 내용은 GitHub를 참고하세요. 응답에는 입력 항공편 구간과 일치하는 모든 항목이 동일한 순서로 포함됩니다. 특정 항공편 구간에 사용할 수 있는 추정치가 없으면 응답에서 배출량 필드가 비어 있는 항공편 구간 객체를 반환합니다. 요청은 여전히 성공한 것으로 간주됩니다. 예상 탄소 배출량이 누락되는 이유는 다음과 같습니다. 서버에서 플라이트를 알 수 없습니다. 입력 항공편 구간에 식별자가 하나 이상 누락되어 있습니다. 항공편 날짜가 과거입니다. 항공기 유형이 모델에서 지원되지 않습니다. 사용 가능 라이선스 수 구성이 누락되었습니다. 요청에는 최대 1,000개의 항공편 구간이 포함될 수 있습니다. 요청에 직항 항공편이 1, 000개를 초과하면 INVALID_ARGUMENT 오류가 발생합니다.

ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse) 범위 3 보고를 위해 일련의 항공편 구간의 GHG 배출량 추정치를 가져오는 스테이트리스 메서드입니다. 응답에는 입력 Scope3FlightSegment 항공편 세그먼트와 일치하는 모든 항목이 제공된 순서대로 포함됩니다. 추정치는 다음 캐스케이딩 로직을 사용하여 계산됩니다 (사용 가능한 첫 번째 항목 사용). origin, destination, carrier, flightNumber, departureDate, cabinClass이 주어졌을 때 TIM 기반 배출량입니다. origin, destination, departureDate년, cabinClass이 주어졌을 때 일반적인 항공편 탄소 배출량 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)의 소스를 확인하여 결과가 예상대로인지 확인해야 합니다.

ComputeTypicalFlightEmissions
rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse) 두 공항(시장이라고도 함) 간의 일반적인 항공편 탄소 배출량 추정치를 가져옵니다. 특정 시장에 사용할 수 있는 추정치가 없으면 응답에서 배출량 필드가 비어 있는 시장 객체를 반환합니다. 요청은 여전히 성공한 것으로 간주됩니다. 일반적인 배출량 추정치가 계산되는 방식에 관한 자세한 내용은 GitHub를 참고하세요. 요청에는 최대 1,000개의 시장이 포함될 수 있습니다. 요청에 1, 000개가 넘는 시장이 있으면 INVALID_ARGUMENT 오류와 함께 실패합니다.

ComputeFlightEmissionsRequest

ComputeFlightEmissions 요청의 입력 정의입니다.

필드
flights[]	Flight 필수 항목입니다. 탄소 배출량 추정치를 반환할 직항편입니다.

ComputeFlightEmissionsResponse

ComputeFlightEmissions 응답의 출력 정의입니다.

필드
flight_emissions[]	FlightWithEmissions 탄소 배출량 추정치가 포함된 항공편 구간 목록입니다.
model_version	ModelVersion 이 응답의 모든 항공편에 대한 탄소 배출량 추정치가 계산된 모델 버전입니다.

ComputeScope3FlightEmissionsRequest

범위 3 배출량을 요청할 항공편 세그먼트 목록입니다.

필드
flights[]	Scope3FlightSegment 필수 항목입니다. 탄소 배출량 추정치를 반환할 항공편입니다.
model_version	ModelVersion 선택사항입니다. 이 요청에 있는 모든 항공편의 탄소 배출량 추정치가 계산된 모델 버전입니다.

ComputeScope3FlightEmissionsResponse

범위 3 배출량 추정치가 있는 항공편 목록입니다.

필드
flight_emissions[]	Scope3FlightEmissions 예상 탄소 배출량이 포함된 항공편 구간 목록입니다.
model_version	ModelVersion 이 응답의 모든 항공편에 대한 탄소 배출량 추정치가 계산된 모델 버전입니다.

ComputeTypicalFlightEmissionsRequest

일반적인 배출량을 요청할 공항 (시장) 쌍 목록입니다.

필드
markets[]	Market 필수 항목입니다. 이 시장 쌍의 일반적인 항공편 탄소 배출량 추정치를 요청합니다. 최대 1,000개의 시장을 요청할 수 있습니다.

ComputeTypicalFlightEmissionsResponse

대답에는 배출량뿐만 아니라 모델 버전도 포함됩니다.

필드
typical_flight_emissions[]	TypicalFlightEmissions 요청된 시장의 일반적인 항공편 탄소 배출량입니다.
model_version	ModelVersion 이 응답의 모든 항공편에 대한 일반적인 항공편 탄소 배출량 추정치가 계산된 모델 버전입니다.

ContrailsImpactBucket

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

열거형
CONTRAILS_IMPACT_UNSPECIFIED	비행운 영향이 지정되지 않았습니다.
CONTRAILS_IMPACT_NEGLIGIBLE	비행운의 영향은 총 CO2e 배출량에 비해 미미합니다.
CONTRAILS_IMPACT_MODERATE	비행운의 영향은 총 CO2e 배출량과 비슷합니다.
CONTRAILS_IMPACT_SEVERE	비행운 영향이 총 CO2e 배출량 영향보다 높습니다.

EasaLabelMetadata

EASA 항공편 탄소 배출량 라벨에 관한 메타데이터입니다.

필드
label_issue_date	Date 라벨이 발급된 날짜입니다.
label_expiry_date	Date 라벨이 만료되는 날짜입니다. 라벨은 이 날짜가 끝날 때까지 표시될 수 있습니다.
label_version	string 라벨의 버전입니다.
saf_discount_percentage	double 라벨에 적용된 지속 가능한 항공 연료 (SAF) 배출량 할인 비율입니다. 십진수 백분율입니다. 값은 [0,1] 간격에 있습니다. 예를 들어 0.0021은 0.21%를 의미합니다. 이 할인 및 배출량 감소는 EASA 라벨에 보고되지만 이 API에서 배포하는 CO2e 추정치에는 포함되지 않습니다.

EmissionsGramsPerPax

좌석 등급별로 그룹화된 배출량 결과입니다.

필드
first	int32 퍼스트 클래스 승객 1인의 탄소 배출량(단위: 그램)입니다. 이 필드는 항공기에 일등석 좌석이 있는지 여부와 관계없이 항상 계산되어 채워집니다.
business	int32 비즈니스 클래스 승객 1인의 탄소 배출량(단위: 그램)입니다. 이 필드는 항공기에 비즈니스 클래스 좌석이 있는지 여부와 관계없이 항상 계산되어 채워집니다.
premium_economy	int32 프리미엄 이코노미 클래스 승객 1인의 탄소 배출량(단위: 그램)입니다. 이 필드는 항공기에 프리미엄 이코노미 클래스 좌석이 있는지 여부와 관계없이 항상 계산되고 채워집니다.
economy	int32 이코노미 클래스 승객 1인의 탄소 배출량(단위: 그램)입니다. 이 필드는 항공기에 일반석 좌석이 있는지 여부에 관계없이 항상 계산되어 채워집니다.

항공편

직항 항공편 탄소 배출량 추정치의 단일 요청 항목과 관련된 모든 세부정보입니다.

필드
origin	string 필수 항목입니다. 항공편 출발지의 IATA 공항 코드입니다(예: 'LHR').
destination	string 필수 항목입니다. 항공편 목적지의 IATA 공항 코드입니다(예: 'JFK').
operating_carrier_code	string 필수 항목입니다. IATA 항공사 코드입니다(예: 'AA').
flight_number	int32 필수 항목입니다. 항공편 번호(예: 324)
departure_date	Date 필수 항목입니다. 출발 공항의 시간대로 표시된 항공편 날짜입니다. 현재 또는 미래의 날짜여야 합니다.

FlightWithEmissions

예상 탄소 배출량이 포함된 직항편

필드
flight	Flight 필수 항목입니다. 요청의 항공편 식별자와 일치합니다. 참고: 모든 IATA 코드는 대문자로 표시됩니다.
source	Source 선택사항입니다. 배출량 데이터의 소스입니다.
emissions_grams_per_pax	EmissionsGramsPerPax 선택사항입니다. 승객당 예상 탄소 배출량입니다. 배출량을 계산할 수 없는 경우 표시되지 않습니다. 배출량을 계산할 수 없는 이유 목록은 ComputeFlightEmissions를 참고하세요.
easa_label_metadata	EasaLabelMetadata 선택사항입니다. EASA 항공편 탄소 배출량 라벨에 관한 메타데이터입니다. 배출량 데이터 소스가 EASA인 경우에만 설정합니다.
contrails_impact_bucket	ContrailsImpactBucket 선택사항입니다. 전체 CO2e 배출량 영향과 비교한 비행운 온난화 영향의 중요도입니다.

시장

공항 한 쌍입니다.

필드
origin	string 필수 항목입니다. 항공편 출발지의 IATA 공항 코드입니다(예: 'LHR').
destination	string 필수 항목입니다. 항공편 목적지의 IATA 공항 코드입니다(예: 'JFK').

ModelVersion

여행 영향 모델 버전입니다. 모델 버전 관리에 대한 자세한 내용은 GitHub를 참고하세요.

필드
major	int32 주 버전: 방법론의 주요 변경사항 (예: 주요 출력 변경으로 이어지는 모델에 새 데이터 소스 추가) 이러한 변경사항은 자주 발생하지 않으며 사전에 공지됩니다. Google Cloud API 가이드라인을 준수하는 API 버전 변경이 포함될 수 있습니다.
minor	int32 부 버전: 스키마 버전 간에 일관되지만 모델 매개변수나 구현을 변경하는 모델 변경사항입니다.
patch	int32 패치 버전: 모델 구현의 버그나 부정확성을 해결하기 위한 구현 변경사항입니다.
dated	string 날짜가 지정된 버전: 모델 데이터 세트는 업데이트된 입력 데이터로 다시 생성되지만 알고리즘은 정기적으로 변경되지 않습니다.

Scope3FlightEmissions

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

필드
flight	Scope3FlightSegment 필수 항목입니다. 요청의 항공편 식별자와 일치합니다.
wtw_emissions_grams_per_pax	int64 선택사항입니다. 요청된 정보를 기반으로 한 승객당 총 항공 배출량 (유정에서 탱크까지와 탱크에서 기상까지의 합계)입니다. 이는 총 배출량이며 TTW 또는 WTT 배출량을 사용해야 하는 특별한 이유가 없는 한 이 수치를 사용해야 합니다.
ttw_emissions_grams_per_pax	int64 선택사항입니다. 요청된 정보를 기반으로 한 승객당 탱크에서 이륙까지의 항공편 배출량입니다.
wtt_emissions_grams_per_pax	int64 선택사항입니다. 요청된 정보를 기반으로 한 승객당 well-to-tank 항공 배출량입니다.
source	Scope3DataType 선택사항입니다. 배출량 데이터의 소스입니다.

Scope3DataType

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

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

Scope3FlightSegment

범위 3 배출량을 가져오는 데 사용되는 항공편 매개변수입니다.

필드
departure_date	Date 필수 항목입니다. 출발 공항의 시간대로 표시된 항공편 날짜입니다. 일반적인 항공편 및 거리 기반 배출 모델의 경우 연도만 필요합니다 (월 및 일 값은 무시되므로 이러한 경우 생략하거나 0으로 설정하거나 유효한 날짜로 설정할 수 있음). 마찬가지로 TIM 배출량에 특정 날짜가 제공되지 않으면 일반적인 항공편 (또는 거리 기반) 배출량으로 대체됩니다.
cabin_class	CabinClass 필수 항목입니다. 항공편의 좌석 등급입니다.
origin	string 선택사항입니다. 항공편 출발지의 IATA 공항 코드입니다(예: YVR). 목적지, 항공사, 항공편 번호와 함께 제공되는 경우 특정 항공편을 일치시키는 데 사용됩니다. 일치하는 항목이 없으면 먼저 제공된 출발지 및 도착지 공항 간의 일반적인 항공편과 항공편을 일치시키려고 시도합니다. 그렇지 않으면 항공편 거리가 제공된 경우 거리 기반 배출 모델이 사용됩니다.
destination	string 선택사항입니다. 항공편 목적지의 IATA 공항 코드입니다(예: ICN). 출발지, 항공사, 항공편 번호와 함께 제공되는 경우 특정 항공편을 일치시키는 데 사용됩니다. 일치하는 항목이 없으면 먼저 제공된 출발지 및 도착지 공항 간의 일반적인 항공편과 항공편을 일치시키려고 시도합니다. 그렇지 않으면 항공편 거리가 제공된 경우 거리 기반 배출 모델이 사용됩니다.
carrier_code	string 선택사항입니다. IATA 항공사 코드입니다(예: KE). 특정 항공편 일치를 원하는 경우 필요합니다. 그렇지 않으면 일반적인 항공편 및 거리 기반 배출 모델에서는 사용되지 않습니다. 운항 항공사 코드와 판매 항공사 코드 모두일 수 있습니다 (즉, 공동운항이 포함됨).
flight_number	int32 선택사항입니다. 항공편 번호(예: 71) 이는 출발지, 목적지, 항공사와 함께 항공편 번호가 지정된 경우 특정 항공편을 일치시키는 데 먼저 사용됩니다. 항공편 번호가 지정되지 않은 경우 먼저 제공된 출발지 및 도착지 공항 간의 일반적인 항공편과 일치하는지 확인합니다. 이 방법이 실패하거나 출발지 및 도착지가 제공되지 않으면 제공된 항공편 거리를 기반으로 거리 기반 배출 모델이 사용됩니다.
distance_km	int64 선택사항입니다. 거리(킬로미터), 예: 2423 출발지와 도착지가 제공되지 않거나 일치하는 일반적인 항공편이 없는 경우 항공편을 거리 기반 탄소 배출량과 일치시키는 데 사용됩니다. 이 필드는 0~2.5e16km 사이의 값을 지원합니다.

CabinClass

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

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

소스

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

열거형
SOURCE_UNSPECIFIED	배출 데이터의 출처가 지정되지 않았습니다.
TIM	탄소 배출량 데이터는 여행 영향력 모델에서 가져온 것입니다.
EASA	배출량 데이터는 EASA 환경 라벨에서 가져온 것입니다.

TypicalFlightEmissions

특정 시장의 일반적인 항공편 탄소 배출량 추정치

필드
market	Market 필수 항목입니다. 요청의 항공편 식별자와 일치합니다. 참고: 모든 IATA 코드는 대문자로 표시됩니다.
emissions_grams_per_pax	EmissionsGramsPerPax 선택사항입니다. 요청된 시장의 승객당 일반적인 항공편 탄소 배출량입니다. 일반적인 배출량을 계산할 수 없는 경우 표시되지 않습니다. 일반적인 항공편 탄소 배출량을 계산할 수 없는 이유 목록은 GitHub를 참고하세요.