Method: flights.computeScope3FlightEmissions

Truy xuất thông tin ước tính về lượng khí nhà kính cho một nhóm chặng bay để báo cáo phạm vi 3.

Phản hồi sẽ chứa tất cả các mục khớp với Scope3FlightSegment chặng bay đầu vào, theo cùng thứ tự được cung cấp. Số liệu ước tính sẽ được tính bằng logic xếp tầng sau đây (sử dụng logic đầu tiên có sẵn):

  1. Lượng khí thải dựa trên TIM cho origin, destination, carrier, flightNumber, departureDate và cabinClass.
  2. Lượng khí thải thông thường của chuyến bay dựa trên origin, destination, năm departureDate và cabinClass.
  3. Lượng phát thải dựa trên quãng đường được tính bằng distanceKm, năm trong departureDate và cabinClass.

Nếu có chuyến bay trong tương lai được yêu cầu trong năm dương lịch này, chúng tôi sẽ không hỗ trợ dữ liệu phát thải Cấp 1 và sẽ quay lại dữ liệu phát thải Cấp 2 hoặc Cấp 3. Nếu chuyến bay trong tương lai được yêu cầu không nằm trong năm dương lịch này, chúng tôi sẽ trả về một phản hồi trống. Bạn nên sử dụng API computeFlightEmissions cho các chuyến bay trong tương lai.

Nếu không có thông tin ước tính cho một chuyến bay nhất định theo bất kỳ phương thức nào trong số 3 phương thức, thì phản hồi sẽ trả về một đối tượng Scope3FlightEmissions có các trường phát thải trống. Yêu cầu vẫn được coi là thành công. Thông thường, việc thiếu thông tin ước tính lượng khí thải xảy ra khi máy chủ không biết chuyến bay (ví dụ: không có chuyến bay cụ thể hoặc không có thông tin về lượng khí thải thông thường của chuyến bay cho cặp chuyến bay được yêu cầu).

Yêu cầu sẽ không thành công và có lỗi INVALID_ARGUMENT nếu:

  • Yêu cầu chứa hơn 1.000 chặng bay.
  • Chặng bay đầu vào thiếu một hoặc nhiều giá trị nhận dạng. Ví dụ: thiếu điểm xuất phát/điểm đến mà không có khoảng cách hợp lệ cho kiểu so khớp TIM_EMISSIONS hoặc TYPICAL_FLIGHT_EMISSIONS, hoặc thiếu khoảng cách cho kiểu so khớp DISTANCE_BASED_EMISSIONS (nếu muốn quay lại mức phát thải dựa trên khoảng cách hoặc muốn ước tính mức phát thải dựa trên khoảng cách, bạn cần chỉ định khoảng cách).
  • Ngày bay là trước năm 2019 (Dữ liệu Phạm vi 3 chỉ có từ năm 2019 trở đi).
  • Khoảng cách chuyến bay bằng 0 hoặc nhỏ hơn.
  • Thiếu hạng bay.

Vì yêu cầu được xử lý bằng logic dự phòng, nên có thể các yêu cầu được định cấu hình sai sẽ trả về số liệu ước tính lượng khí thải hợp lệ bằng phương thức dự phòng. Ví dụ: nếu một yêu cầu có số hiệu chuyến bay không chính xác nhưng có chỉ định điểm khởi hành và điểm đến, thì yêu cầu đó vẫn sẽ thành công, nhưng lượng khí thải được trả về sẽ chỉ dựa trên lượng khí thải thông thường của chuyến bay. Tương tự, nếu một yêu cầu thiếu điểm xuất phát cho một yêu cầu phát thải thông thường của chuyến bay nhưng chỉ định khoảng cách hợp lệ, thì yêu cầu đó có thể thành công chỉ dựa trên lượng khí thải dựa trên khoảng cách. Do đó, bạn nên kiểm tra nguồn của lượng khí thải được trả về (source) để xác nhận kết quả như mong đợi.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "flights": [
    {
      object (Scope3FlightSegment)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Trường
flights[]

object (Scope3FlightSegment)

Bắt buộc. Các chuyến bay để trả về lượng khí thải ước tính.
modelVersion

object (ModelVersion)

Không bắt buộc. Phiên bản mô hình được dùng để tính toán lượng khí thải ước tính cho tất cả chuyến bay trong yêu cầu này.

Nội dung phản hồi

Danh sách các chuyến bay có lượng khí thải ước tính thuộc Phạm vi 3.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "flightEmissions": [
    {
      object (Scope3FlightEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Trường
flightEmissions[]

object (Scope3FlightEmissions)

Danh sách các chặng bay kèm theo lượng khí thải ước tính.
modelVersion

object (ModelVersion)

Phiên bản mô hình được dùng để tính toán lượng khí thải ước tính cho tất cả chuyến bay trong câu trả lời này.

Scope3FlightSegment

Các thông số chuyến bay dùng để tìm nạp lượng khí thải Phạm vi 3.

Biểu diễn dưới dạng JSON 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Trường
departureDate

object (Date)

Bắt buộc. Ngày của chuyến bay theo múi giờ của sân bay khởi hành. Chỉ cần năm cho các mô hình phát thải dựa trên khoảng cách và chuyến bay thông thường (giá trị tháng và ngày bị bỏ qua và do đó, có thể bị bỏ qua, đặt thành 0 hoặc đặt thành ngày hợp lệ cho các trường hợp đó). Tương tự, nếu không có ngày cụ thể cho lượng khí thải TIM, chúng tôi sẽ quay lại sử dụng lượng khí thải của chuyến bay thông thường (hoặc dựa trên khoảng cách).
cabinClass

enum (Scope3FlightSegment.CabinClass)

Bắt buộc. Hạng bay của chuyến bay.
origin

string

Không bắt buộc. Mã sân bay IATA gồm 3 ký tự cho sân bay khởi hành, ví dụ: YVR. Thông tin này dùng để so khớp chuyến bay cụ thể nếu được cung cấp cùng với điểm đến, hãng hàng không và số hiệu chuyến bay. Nếu không có chuyến bay nào khớp, trước tiên, chúng tôi sẽ cố gắng so khớp chuyến bay đó với một chuyến bay thông thường giữa sân bay khởi hành và sân bay đến được cung cấp. Nếu không, chúng tôi sẽ sử dụng mô hình phát thải dựa trên khoảng cách nếu bạn cung cấp khoảng cách chuyến bay.
destination

string

Không bắt buộc. Mã sân bay IATA gồm 3 ký tự cho điểm đến của chuyến bay, ví dụ: ICN. Thông tin này được dùng để so khớp với chuyến bay cụ thể nếu được cung cấp cùng với điểm khởi hành, hãng hàng không và số hiệu chuyến bay. Nếu không có chuyến bay nào khớp, trước tiên, chúng tôi sẽ cố gắng so khớp chuyến bay đó với một chuyến bay thông thường giữa sân bay khởi hành và sân bay đến được cung cấp. Nếu không, chúng tôi sẽ sử dụng mô hình phát thải dựa trên khoảng cách nếu bạn cung cấp khoảng cách chuyến bay.
carrierCode

string

Không bắt buộc. Mã hãng hàng không IATA gồm 2 ký tự, ví dụ: KE. Bạn phải cung cấp thông tin này nếu muốn so khớp chuyến bay cụ thể. Nếu không, thông tin này sẽ không được dùng cho các mô hình phát thải thông thường dựa trên chuyến bay và khoảng cách. Đây có thể là cả mã hãng hàng không khai thác và mã hãng hàng không tiếp thị (tức là bao gồm cả mã liên danh).
flightNumber

integer

Không bắt buộc. Số hiệu chuyến bay có tối đa 4 chữ số, ví dụ: 71, từ [1, 9999]. Thông tin này được dùng trước tiên để so khớp một chuyến bay cụ thể nếu số hiệu chuyến bay được chỉ định cùng với điểm xuất phát, điểm đến và hãng vận chuyển. Nếu bạn không chỉ định số hiệu chuyến bay, trước tiên, chúng tôi sẽ cố gắng so khớp chuyến bay đó với một chuyến bay thông thường giữa sân bay khởi hành và sân bay đến được cung cấp. Nếu không thành công và/hoặc không có điểm khởi hành và điểm đến, chúng tôi sẽ sử dụng mô hình phát thải dựa trên khoảng cách dựa trên khoảng cách chuyến bay được cung cấp.
distanceKm

string (int64 format)

Không bắt buộc. Khoảng cách tính bằng kilomet, ví dụ: 2423, từ [1, 1e12) km. Giá trị này được dùng để so khớp một chuyến bay với lượng khí thải dựa trên khoảng cách khi không có thông tin về điểm xuất phát và điểm đến hoặc không có chuyến bay thông thường phù hợp.

Scope3FlightSegment.CabinClass

Hạng bay của chuyến bay.

Enum
CABIN_CLASS_UNSPECIFIED Hạng bay không xác định.
ECONOMY Hạng phổ thông.
PREMIUM_ECONOMY Hạng phổ thông đặc biệt.
BUSINESS Hạng thương gia.
FIRST Hạng nhất.

Scope3FlightEmissions

Chuyến bay thuộc phạm vi 3 có thông tin ước tính về lượng khí thải.

Biểu diễn dưới dạng JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType),
  "modelVersion": string
}
Trường
flight

object (Scope3FlightSegment)

Giá trị nhận dạng. Khớp với giá trị nhận dạng chuyến bay trong yêu cầu.
wtwEmissionsGramsPerPax

string (int64 format)

Không bắt buộc. Tổng lượng khí thải của chuyến bay (tổng lượng khí thải từ giếng dầu đến bình nhiên liệu và từ bình nhiên liệu đến khi xả thải) trên mỗi hành khách dựa trên thông tin được yêu cầu. Đây là tổng lượng khí thải và bạn nên sử dụng con số này, trừ phi bạn có lý do cụ thể để sử dụng lượng khí thải TTW hoặc WTT.
ttwEmissionsGramsPerPax

string (int64 format)

Không bắt buộc. Lượng khí thải của chuyến bay tính từ lúc nạp nhiên liệu đến khi kết thúc hành trình trên mỗi hành khách, dựa trên thông tin được yêu cầu.
wttEmissionsGramsPerPax

string (int64 format)

Không bắt buộc. Lượng khí thải từ quá trình sản xuất và vận chuyển nhiên liệu cho chuyến bay tính theo mỗi hành khách, dựa trên thông tin được yêu cầu.
source

enum (Scope3FlightEmissions.Scope3DataType)

Không bắt buộc. Nguồn dữ liệu về lượng khí thải.
modelVersion

string

Không bắt buộc. Phiên bản mô hình dùng để tính toán lượng khí thải.

Scope3FlightEmissions.Scope3DataType

Loại so khớp dùng để tính toán lượng khí thải Phạm vi 3. Thông tin này được dùng cho câu trả lời về Phạm vi 3, đánh dấu phương pháp được dùng để tính toán lượng khí thải.

Enum
SCOPE3_DATA_TYPE_UNSPECIFIED Loại dữ liệu không xác định.
TIM_EMISSIONS Lượng khí thải dựa trên TIM, dựa vào điểm khởi hành, điểm đến, hãng hàng không, số hiệu chuyến bay, ngày khởi hành và năm.
TYPICAL_FLIGHT_EMISSIONS Lượng khí thải thông thường của chuyến bay dựa trên điểm khởi hành, điểm đến và năm.
DISTANCE_BASED_EMISSIONS Lượng khí thải dựa trên quãng đường đã đi và năm.