Method: flights.computeFlightEmissions

스테이트리스(Stateless) 메서드로 탄소 배출량 추정치를 가져옵니다. 예상 탄소 배출량 계산 방법에 관한 세부정보: https://github.com/google/travel-impact-model

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

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

요청에는 최대 1,000개의 비행 구간을 포함할 수 있습니다. 요청에 직항이 1, 000개를 초과하는 경우 INVALID_CONVERSION 오류와 함께 실패합니다.

HTTP 요청

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

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

요청 본문

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

JSON 표현 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
필드
flights[]

object (Flight)

필수 항목입니다. 예상 탄소 배출량을 반환할 직항 항공편입니다.

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

[flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.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년입니다 (예: 기념일).
  • 1년은 자체적으로, 월은 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)
  },
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
필드
flight

object (Flight)

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

object (EmissionsGramsPerPax)

선택사항입니다. 승객당 탄소 배출량 추정치입니다. 탄소 배출량을 계산할 수 없는 경우에는 표시되지 않습니다. 배출량을 계산할 수 없는 이유 목록은 [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions]를 참고하세요.

EmissionsGramsPerPax

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

JSON 표현 
{
  "first": integer,
  "business": integer,
  "premiumEconomy": integer,
  "economy": integer
}
필드
first

integer

퍼스트 클래스 승객 1인의 탄소 배출량(그램 단위)입니다. 이 필드는 항공기의 1급 좌석에 있는지 여부와 관계없이 항상 계산되고 채워집니다.
business

integer

비즈니스 클래스 승객 1인의 탄소 배출량(그램 단위)입니다. 이 필드는 항공기에 비즈니스 클래스 좌석이 있는지 여부와 관계없이 항상 계산되고 채워집니다.
premiumEconomy

integer

프리미엄 이코노미 클래스 승객 1인의 탄소 배출량(그램 단위) 이 필드는 항공기에 프리미엄 이코노미 클래스 좌석이 있는지 여부와 관계없이 항상 계산되고 채워집니다.
economy

integer

이코노미 클래스 승객 1명의 탄소 배출량(그램)입니다. 이 필드는 항공기의 이코노미 클래스 좌석 유무와 상관없이 항상 계산되고 채워집니다.

ModelVersion

여행 영향력 모델 버전입니다. 모델 버전 관리에 관한 자세한 내용은 https://github.com/google/travel-impact-model/#versioning을 참고하세요.

JSON 표현 
{
  "major": integer,
  "minor": integer,
  "patch": integer,
  "dated": string
}
필드
major

integer

메이저 버전: 방법론의 주요 변경사항 (예: 모델에 새로운 데이터 소스를 추가하여 주요 출력 변화로 이어짐) 이러한 변경사항은 드물게 사전에 공지됩니다. https://cloud.google.com/endpoints/docs/openapi/versioning-an-api#backwards-incompatible의 가이드라인을 준수하는 API 버전 변경이 수반될 수 있습니다.
minor

integer

부 버전: 여러 스키마 버전에서 일관되면서 모델 매개변수 또는 구현을 변경하는 모델의 변경사항입니다.
patch

integer

패치 버전: 모델 구현의 버그나 부정확성을 해결하기 위한 구현 변경사항입니다.
dated

string

날짜가 지정된 버전: 모델 데이터 세트가 새로고침된 입력 데이터로 다시 생성되지만 알고리즘이 정기적으로 변경되지는 않습니다.