Method: flights.computeScope3FlightEmissions

Phương thức không trạng thái để truy xuất thông tin ước tính lượng khí thải nhà kính cho một nhóm phân đoạn chuyến bay để báo cáo Phạm vi 3.

Phản hồi sẽ chứa tất cả các mục nhập khớp với Scope3FlightSegment phân đoạn chuyến bay đầu vào, theo cùng thứ tự được cung cấp. Số liệu ước tính sẽ được tính toán bằng cách sử dụng logic xếp tầng sau đây (sử dụng số liệu đầ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 cho origin, destination, năm departureDate và cabinClass.
  3. Lượng khí thải dựa trên khoảng cách được tính bằng cách sử dụng distanceKm, năm trong departureDate và cabinClass.

Nếu có chuyến bay được yêu cầu trong năm dương lịch này, chúng tôi sẽ không hỗ trợ mức phát thải Cấp 1 và sẽ chuyển sang mức phát thải Cấp 2 hoặc 3. Nếu chuyến bay trong tương lai mà bạn 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 sau này.

Nếu không có thông tin ước tính cho một chuyến bay cụ thể bằng bất kỳ phương thức nào trong số 3 phương thức này, thì phản hồi sẽ trả về một đối tượng Scope3FlightEmissions có các trường khí 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 về lượng khí thải xảy ra khi máy chủ không biết đến 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à trả về lỗi INVALID_ARGUMENT nếu:

  • Yêu cầu chứa hơn 1.000 chặng bay.
  • Chuyến bay đầu vào bị thiếu một hoặc nhiều giá trị nhận dạng. Ví dụ: thiếu điểm xuất phát/đích đến mà không có khoảng cách hợp lệ cho loại TIM_EMISSIONS hoặc TYPICAL_FLIGHT_EMISSIONS trùng khớp, hoặc thiếu khoảng cách cho loại DISTANCE_BASED_EMISSIONS trùng khớp (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 bay là 0 hoặc thấp 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ề thông tin ước tính lượng khí thải hợp lệ bằng các 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 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 điển hình của chuyến bay. Tương tự, nếu một yêu cầu thiếu thông tin về điểm xuất phát cho một yêu cầu thông thường về lượng khí thải 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 phát thải được trả về (source) để xác nhận kết quả đúng 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ề số liệu ước tính về lượng khí thải.
modelVersion

object (ModelVersion)

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

Nội dung phản hồi

Danh sách các chuyến bay có lượng khí thải ước tính theo 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 đoạn bay có lượng khí thải ước tính.
modelVersion

object (ModelVersion)

Phiên bản mô hình mà theo đó, lượng khí thải ước tính của tất cả các chuyến bay trong phản hồi này được tính toán.

Scope3FlightSegment

Các thông số chuyến bay mà nhờ đó, lượng khí thải Phạm vi 3 được tìm nạp.

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

object (Date)

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

enum (CabinClass)

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

string

Không bắt buộc. Mã IATA của sân bay khởi hành, ví dụ: YVR. Thông tin này được 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 vận chuyển và số chuyến bay. Nếu không có kết quả trùng 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 mà bạn 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 bay.
destination

string

Không bắt buộc. Mã IATA của sân bay đến, ví dụ: ICN. Thông tin này được dùng để so khớp chuyến bay cụ thể nếu được cung cấp cùng với điểm xuất phát, hãng hàng không và số chuyến bay. Nếu không có kết quả trùng 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 mà bạn 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 bay.
carrierCode

string

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

integer

Không bắt buộc. Số hiệu chuyến bay, ví dụ: 71. Mã này được dùng trước tiên để khớp một chuyến bay cụ thể nếu bạn chỉ định số chuyến bay cùng với điểm xuất phát, điểm đến và hãng hàng không. Nếu bạn không chỉ định số 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 xuất phát và sân bay đến mà bạn cung cấp. Nếu không thành công và/hoặc bạn không cung cấp đ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 bay mà bạn cung cấp.
distanceKm

string (int64 format)

Không bắt buộc. Quãng đường tính bằng ki-lô-mét, ví dụ: 2423. Mã 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 khởi hành và điểm đến hoặc không có chuyến bay thông thường nào khớp. Trường này hỗ trợ các giá trị từ 0 đến 2,5e16 km.

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ó số liệu ướ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 (Scope3DataType)
}
Trường
flight

object (Scope3FlightSegment)

Bắt buộc. 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 đến bể chứa và từ bể chứa đến vệt nước) 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à trừ phi có lý do cụ thể để sử dụng lượng khí thải từ bể chứa đến vệt nước hoặc từ giếng đến bể chứa, bạn nên sử dụng con số này.
ttwEmissionsGramsPerPax

string (int64 format)

Không bắt buộc. Lượng khí thải của chuyến bay từ bình nhiên liệu đến khi máy bay cất cánh trên mặt nước tí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 của chuyến bay từ giếng đến bình chứa trên mỗi hành khách dựa trên thông tin được yêu cầu.
source

enum (Scope3DataType)

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

Scope3DataType

Loại so khớp được dùng để tính toán lượng khí thải Phạm vi 3. Đây là thông tin được dùng cho phản hồi 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 cho biết điểm xuất phát, điểm đến, hãng vận chuyển, số 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 xuất phát, điểm đến và năm.
DISTANCE_BASED_EMISSIONS Lượng khí thải dựa trên khoảng cách, tuỳ thuộc vào quãng đường đã đi và năm.