Method: flights.computeFlightEmissions

Phương thức không trạng thái để truy xuất số liệu ước tính lượng khí thải. Thông tin chi tiết về cách tính toán số liệu ước tính lượng khí thải có trong GitHub

Nội dung phản hồi sẽ chứa tất cả các mục khớp với các chặng bay đầu vào, theo cùng một thứ tự. Nếu không có số liệu ước tính cho một chặng bay nhất định, thì nội dung phản hồi sẽ trả về đối tượng chặng bay có các trường lượng khí thải trống. Yêu cầu vẫn được coi là thành công. Sau đây là một số lý do khiến số liệu ước tính lượng khí thải bị thiếu:

  • Máy chủ không biết đến chuyến bay.
  • Chặng bay đầu vào bị thiếu một hoặc nhiều giá trị nhận dạng.
  • Ngày bay là ngày trong quá khứ.
  • Mẫu không hỗ trợ loại máy bay.
  • Thiếu cấu hình chỗ ngồi.

Yêu cầu có thể chứa tối đa 1.000 chặng bay. Nếu yêu cầu có hơn 1.000 chuyến bay thẳng, thì yêu cầu đó sẽ không thành công và gặp lỗi INVALID_ARGUMENT.

Yêu cầu HTTP

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

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 (Flight)
    }
  ]
}
Trường
flights[]

object (Flight)

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

Nội dung phản hồi

Định nghĩa đầu ra cho phản hồi flights.computeFlightEmissions.

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 (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Trường
flightEmissions[]

object (FlightWithEmissions)

Danh sách các chặng bay có số liệu ước tính lượng khí thải.
modelVersion

object (ModelVersion)

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

Vé Flight

Tất cả thông tin chi tiết liên quan đến một mục yêu cầu cho số liệu ước tính lượng khí thải của chuyến bay thẳng.

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

string

Bắt buộc. Mã sân bay IATA cho điểm khởi hành, ví dụ: "LHR".
destination

string

Bắt buộc. Mã sân bay IATA cho điểm đến, ví dụ: "JFK".
operatingCarrierCode

string

Bắt buộc. Mã hãng hàng không IATA, ví dụ: "AA".
flightNumber

integer

Bắt buộc. Số hiệu chuyến bay, ví dụ: 324.
departureDate

object (Date)

Bắt buộc. Ngày bay theo múi giờ của sân bay khởi hành. Phải là ngày hiện tại hoặc ngày trong tương lai.

FlightWithEmissions

Chuyến bay thẳng có số liệu ước tính lượng khí thải.

Biểu diễn dưới dạng JSON 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
Trường
flight

object (Flight)

Số nhận dạng. Khớp với giá trị nhận dạng chuyến bay trong yêu cầu. Lưu ý: tất cả mã IATA đều được viết hoa.
source

enum (Source)

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

object (EmissionsGramsPerPax)

Không bắt buộc. Số liệu ước tính lượng khí thải trên mỗi hành khách. Sẽ không xuất hiện nếu không tính toán được lượng khí thải. Để biết danh sách các lý do không tính toán được lượng khí thải, hãy xem flights.computeFlightEmissions.
easaLabelMetadata

object (EasaLabelMetadata)

Không bắt buộc. Siêu dữ liệu về Nhãn lượng khí thải của chuyến bay do EASA cấp. Chỉ được đặt khi nguồn dữ liệu về lượng khí thải là EASA.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Không bắt buộc. Mức độ quan trọng của tác động do vệt khói trắng gây ra đối với hiệu ứng nóng lên so với tổng tác động do lượng khí thải CO2e gây ra.

Nguồn

Nguồn dữ liệu về lượng khí thải.

Enum
SOURCE_UNSPECIFIED Nguồn dữ liệu về lượng khí thải chưa được chỉ định.
TIM Dữ liệu về lượng khí thải là từ Travel Impact Model.
EASA Dữ liệu về lượng khí thải là từ nhãn môi trường của EASA.

EasaLabelMetadata

Siêu dữ liệu về Nhãn lượng khí thải của chuyến bay do EASA cấp.

Biểu diễn dưới dạng JSON 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
Trường
labelIssueDate

object (Date)

Ngày cấp nhãn.
labelExpiryDate

object (Date)

Ngày nhãn hết hạn. Nhãn có thể được hiển thị cho đến hết ngày này.
labelVersion

string

Phiên bản của nhãn.
safDiscountPercentage

number

Tỷ lệ phần trăm chiết khấu lượng khí thải của Nhiên liệu hàng không bền vững (SAF) được áp dụng cho nhãn. Đây là tỷ lệ phần trăm dưới dạng số thập phân. Các giá trị nằm trong khoảng [0,1]. Ví dụ: 0,0021 có nghĩa là 0,21%.

Khoản chiết khấu và mức giảm lượng khí thải này do nhãn EASA báo cáo nhưng không được tính vào số liệu ước tính CO2e do API này phân phối.

ContrailsImpactBucket

Mức độ quan trọng của tác động do vệt khói trắng gây ra đối với hiệu ứng nóng lên so với tổng tác động do lượng khí thải CO2e gây ra.

Enum
CONTRAILS_IMPACT_UNSPECIFIED Tác động do vệt khói trắng gây ra chưa được chỉ định.
CONTRAILS_IMPACT_NEGLIGIBLE Tác động do vệt khói trắng gây ra là không đáng kể so với tổng lượng khí thải CO2e.
CONTRAILS_IMPACT_MODERATE Tác động do vệt khói trắng gây ra có thể so sánh với tổng lượng khí thải CO2e.
CONTRAILS_IMPACT_SEVERE Tác động do vệt khói trắng gây ra cao hơn tác động do tổng lượng khí thải CO2e gây ra.