Method: flights.computeFlightEmissions

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

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ó thông tin ước tính cho một chặng bay nhất định, thì phản hồi sẽ trả về đối tượng chặng bay với các trường khí thải trống. Yêu cầu vẫn được coi là thành công. Sau đây là những lý do khiến bạn không thấy thông tin ước tính về lượng khí thải:

  • Máy chủ không biết đến chuyến bay này.
  • Chuyến bay đầu vào bị thiếu một hoặc nhiều giá trị nhận dạng.
  • Ngày chuyến bay là ngày trong quá khứ.
  • Mẫu này 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 kèm theo 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 có 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ề lượng khí thải ước tính.

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 kèm theo 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.

Vé Flight

Tất cả thông tin chi tiết liên quan đến một mục yêu cầu duy nhất để ước tính lượng khí thải của một 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ã IATA của sân bay khởi hành, ví dụ: "LHR".
destination

string

Bắt buộc. Mã IATA của sân bay đế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à một ngày trong hiện tại hoặc tương lai.

Ngày

Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như ngày sinh nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không quan trọng. Ngày này có liên quan đến Dương lịch. Nội dung đặc tả này có thể xuất hiện dưới dạng một trong những nội dung sau:

  • Một ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
  • Giá trị tháng và ngày, giá trị năm bằng 0 (ví dụ: ngày kỷ niệm).
  • Chỉ riêng giá trị năm, với giá trị tháng và ngày bằng 0.
  • Năm và tháng, với giá trị ngày bằng 0 (ví dụ: ngày hết hạn thẻ tín dụng).

Các loại có liên quan:

Biểu diễn dưới dạng JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Trường
year

integer

Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm.
month

integer

Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc từ 0 để chỉ định một năm không có tháng và ngày.
day

integer

Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị trong năm và tháng, hoặc bằng 0 nếu chỉ chỉ định giá trị năm, hoặc một năm và tháng, trong đó ngày là không quan trọng.

FlightWithEmissions

Chuyến bay thẳng có thông tin ước tính về 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)

Bắt buộc. 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 được lượng khí thải. Để xem danh sách lý do khiến hệ thống không tính được lượng khí thải, hãy xem phần flights.computeFlightEmissions.
easaLabelMetadata

object (EasaLabelMetadata)

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

enum (ContrailsImpactBucket)

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

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 xác định.
TIM Dữ liệu về lượng khí thải được lấy từ Mô hình tác động của chuyến đi.
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 phát thải chuyến bay của EASA.

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 phát hành nhãn.
labelExpiryDate

object (Date)

Ngày nhãn hết hạn. Nhãn này có thể xuất hiện 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 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 phát thải này được báo cáo theo nhãn của EASA 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 nóng lên do vệt khói trắng so với tổng tác động của lượng khí thải CO2e.

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