Method: flights.computeDetailedFlightEmissions

Truy xuất thông tin chi tiết về lượng khí thải ước tính.

Thông tin chi tiết về lượng khí thải của chuyến bay là số liệu ước tính minh bạch về lượng khí thải nhà kính trên mỗi hành khách, được bổ sung bằng siêu dữ liệu toàn diện nêu chi tiết phương pháp tính toán, thành phần khí thải, tác động của vệt ngưng tụ và nguồn gốc dữ liệu.

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 có 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 dữ liệu về lượng khí thải ước tính bị thiếu:

  • Máy chủ không nhận biết được 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 chuyến bay là ngày trong quá khứ.
  • Mô hình không hỗ trợ loại máy bay này.
  • Thiếu cấu hình chỗ ngồi.

Yêu cầu có thể chứa tối đa 100 chặng bay. Nếu yêu cầu có hơn 100 chặng bay, 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:computeDetailedFlightEmissions

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. 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.computeDetailedFlightEmissions.

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

object (FlightWithDetailedEmissions)

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.

FlightWithDetailedEmissions

Chuyến bay thẳng kèm theo thông tin chi tiết về lượng khí thải ước tính.

Biểu diễn dưới dạng JSON 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
Trường
flight

object (Flight)

Chỉ có đầu ra. 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.
flightEmissionsDetails

object (FlightEmissionsDetails)

Chỉ có đầu ra. Tất cả dữ liệu về lượng khí thải của chuyến bay.
emissionsMetadata

object (EmissionsMetadata)

Chỉ có đầu ra. Siêu dữ liệu bổ sung về cách tính lượng khí thải của chuyến bay.

FlightEmissionsDetails

Thông tin chi tiết về lượng khí thải của một chuyến bay cụ thể.

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

object (EmissionsGramsPerPax)

Chỉ có đầu ra. Số liệu ước tính lượng khí thải theo đầu người. Sẽ không xuất hiện nếu không tính được lượng khí thải. Để xem danh sách các lý do khiến không tính được lượng khí thải, hãy xem phần flights.computeDetailedFlightEmissions
emissionsBreakdown

object (EmissionsBreakdown)

Chỉ có đầu ra. Thông tin chi tiết về các phần khí thải khác nhau của giá trị tổng lượng khí thải (GramsPerPax). Giá trị của tổng các thông tin chi tiết phải luôn bằng emissionsGramsPerPax.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Chỉ có đầu ra. 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.
source

enum (Source)

Chỉ có đầu ra. Nguồn dữ liệu về lượng khí thải.

EmissionsBreakdown

Thông tin chi tiết về các phần khí thải khác nhau của giá trị tổng lượng khí thải (GramsPerPax). Giá trị của tổng các thông tin chi tiết phải luôn bằng emissionsGramsPerPax.

Biểu diễn dưới dạng JSON 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Trường
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Số liệu ước tính về lượng khí thải từ giếng dầu đến bình nhiên liệu cho 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.
ttwEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Số liệu ước tính về lượng khí thải từ bình nhiên liệu đến đuôi tàu theo 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.

EmissionsMetadata

Tất cả siêu dữ liệu bổ sung.

Biểu diễn dưới dạng JSON 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
Trường
emissionsProvenance

object (EmissionsProvenance)

Chỉ có đầu ra. Thông tin chi tiết về nguồn gốc của dữ liệu được dùng để tính toán dữ liệu về lượng khí thải, bao gồm cả các yếu tố đóng góp cùng với nguồn dữ liệu của chúng.
easaLabelMetadata

object (EasaLabelMetadata)

Chỉ có đầu ra. 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.
timWebsiteEmissionsCalculatorUrl

string

Chỉ có đầu ra. Đường liên kết đến trang web travelimpactmodel.org Công cụ tính toán lượng khí thải. Ví dụ: https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225.

EmissionsProvenance

Thông tin về nguồn gốc của dữ liệu dùng để tính toán mức phát thải ước tính, bao gồm cả các yếu tố đóng góp và nguồn dữ liệu của các yếu tố đó.

Biểu diễn dưới dạng JSON 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
Trường
provenanceEntries[]

object (EmissionsProvenance.EmissionsProvenanceEntry)

Chỉ có đầu ra. Tất cả các yếu tố đóng góp được dùng để tính toán lượng khí thải.

EmissionsProvenance.EmissionsProvenanceEntry

Thông tin chi tiết về một yếu tố đóng góp trong phép tính lượng khí thải.

Biểu diễn dưới dạng JSON 
{
  "provenanceEntryType": enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType),
  "source": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource),
  "sourceVersion": string,
  "dataCategory": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory),

  // Union field data_strategy can be only one of the following:
  "fuelBurnEeaStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy),
  "loadFactorsT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy),
  "loadFactorsChAviationStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy),
  "cargoMassFractionT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy),
  "seatAreaRatioIataStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy),
  "distanceAdjustmentStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)
  // End of list of possible types for union field data_strategy.

  // Union field data_value can be only one of the following:
  "loadFactorsData": number,
  "cargoMassFractionData": number,
  "seatAreaRatioData": {
    object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)
  },
  "estimatedFlightDistanceKm": integer
  // End of list of possible types for union field data_value.
}
Trường
provenanceEntryType

enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType)

Chỉ có đầu ra. Loại mục nhập nguồn gốc.
source

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource)

Chỉ có đầu ra. Nguồn dữ liệu.
sourceVersion

string

Chỉ có đầu ra. Phiên bản của dữ liệu nguồn. Ví dụ: "2025/04".
dataCategory

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory)

Chỉ có đầu ra. Danh mục dữ liệu của nguồn dữ liệu.
Trường nhóm data_strategy. Chiến lược được dùng để tính toán lượng khí thải cho nguồn dữ liệu đã cho. Tập hợp trường sẽ tương ứng với loại data_source. data_strategy chỉ có thể là một trong những trạng thái sau:
fuelBurnEeaStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy)

Chỉ có đầu ra. Chiến lược đốt nhiên liệu ở Khu vực kinh tế Châu Âu (EEA).
loadFactorsT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy)

Chỉ có đầu ra. Chiến lược cho hệ số tải trọng T100.
loadFactorsChAviationStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy)

Chỉ có đầu ra. Chiến lược cho hệ số tải của CH Aviation.
cargoMassFractionT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy)

Chỉ có đầu ra. Chiến lược cho tỷ lệ khối lượng hàng hoá T100.
seatAreaRatioIataStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy)

Chỉ có đầu ra. Chiến lược về tỷ lệ diện tích ghế theo IATA.
distanceAdjustmentStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)

Chỉ có đầu ra. Chiến lược điều chỉnh khoảng cách.
Trường nhóm data_value. Giá trị dữ liệu cho nguồn dữ liệu đã cho. Tập hợp trường sẽ tương ứng với provenance_entry_type. data_value chỉ có thể là một trong những trạng thái sau:
loadFactorsData

number

Chỉ có đầu ra. Giá trị dữ liệu hệ số sử dụng ghế. Nếu bạn không đặt, giá trị hệ số tải sẽ không có sẵn.
cargoMassFractionData

number

Chỉ có đầu ra. Giá trị tỷ lệ khối lượng hàng hoá. Nếu bạn không đặt, thì giá trị phân số khối lượng hàng hoá sẽ không có sẵn.
seatAreaRatioData

object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)

Chỉ có đầu ra. Giá trị tỷ lệ diện tích ghế cho từng hạng ghế. Nếu bạn không đặt giá trị này, thì giá trị tỷ lệ diện tích ghế sẽ không có sẵn.
estimatedFlightDistanceKm

integer

Chỉ có đầu ra. Khoảng cách bay ước tính trong giai đoạn bay CCD (tính bằng km) được tính bằng hệ số điều chỉnh khoảng cách (DAF). Nếu bạn không đặt giá trị này, thì giá trị khoảng cách bay ước tính sẽ không có sẵn.

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

Loại mục nhập nguồn gốc. Các giá trị mới có thể được thêm vào trong tương lai. Các ứng dụng cần chuẩn bị sẵn sàng để xử lý các giá trị enum không xác định một cách thích hợp.

Enum
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED Loại mục nguồn gốc chưa được chỉ định.
FUEL_BURN Loại mục nhập mức tiêu thụ nhiên liệu.
LOAD_FACTORS Loại mục nhập hệ số tải.
CARGO_MASS_FRACTION Loại mục nhập về tỷ lệ khối lượng hàng hoá.
SEATING_CONFIG Loại mục nhập cấu hình chỗ ngồi.
SEAT_AREA_RATIOS Loại mục nhập về tỷ lệ diện tích chỗ ngồi.
DISTANCE_ADJUSTMENT Loại mục nhập điều chỉnh khoảng cách.

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

Nguồn dữ liệu cho các hệ số nguồn gốc phát thải. Các giá trị mới có thể được thêm vào trong tương lai. Các ứng dụng nên chuẩn bị sẵn sàng để xử lý các giá trị enum không xác định một cách thích hợp.

Enum
DATA_SOURCE_UNSPECIFIED Nguồn dữ liệu chưa được chỉ định.
EEA Dữ liệu do Cơ quan Môi trường Châu Âu (EEA) cung cấp.
T100 Dữ liệu từ tập dữ liệu T-100 do Cục Thống kê Giao thông vận tải Hoa Kỳ cung cấp.
CH_AVIATION Dữ liệu do ch-aviation cung cấp.
OAG Dữ liệu do Official Aviation Guide (OAG) cung cấp.
OPERATING_CARRIER Dữ liệu do hãng vận chuyển khai thác cung cấp.
AIRCRAFT_MODEL_TYPICAL Dữ liệu thông thường dựa trên mẫu máy bay.
GLOBAL_DEFAULT Giá trị mặc định chung, được dùng khi không có nguồn dữ liệu nào khác.
IATA Dữ liệu do Hiệp hội Vận tải Hàng không Quốc tế (IATA) cung cấp.
ICL Dữ liệu do Imperial College London cung cấp.

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

Chiến lược đốt nhiên liệu ở Khu vực kinh tế Châu Âu (EEA). Các giá trị mới có thể được thêm vào trong tương lai. Các ứng dụng cần chuẩn bị sẵn sàng để xử lý các giá trị enum không xác định một cách thích hợp.

Enum
STRATEGY_UNSPECIFIED Chiến lược không được chỉ định.
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR Hệ số điều chỉnh tĩnh đã được áp dụng.
AIRCRAFT_MAPPING_EXACT Đã sử dụng bản đồ chính xác về máy bay.
AIRCRAFT_MAPPING_FALLBACK Đã sử dụng tính năng ánh xạ máy bay dự phòng.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

Chiến lược cho hệ số tải trọng T100. Các giá trị mới có thể được thêm vào trong tương lai. Các ứng dụng cần chuẩn bị sẵn sàng để xử lý các giá trị enum không xác định một cách thích hợp.

Enum
STRATEGY_UNSPECIFIED Chiến lược không được chỉ định.
CARRIER_ROUTE_MONTH Dữ liệu theo hãng vận chuyển, tuyến đường và tháng đi lại.
CARRIER_MONTH Dữ liệu theo hãng vận chuyển và tháng đi lại.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH Dữ liệu trong quá khứ khớp với hãng vận chuyển, tuyến đường, năm và tháng.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

Chiến lược về hệ số sử dụng ghế ngồi của CH-Aviation. Các giá trị mới có thể được thêm vào trong tương lai. Các ứng dụng cần chuẩn bị sẵn sàng để xử lý các giá trị enum không xác định một cách thích hợp.

Enum
STRATEGY_UNSPECIFIED Chiến lược không được chỉ định.
CARRIER_MONTH Dữ liệu theo hãng vận chuyển và tháng đi lại.
ACTUAL_CARRIER_YEAR_MONTH Dữ liệu trước đây khớp với hãng vận chuyển, năm và tháng.

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

Chiến lược cho tỷ lệ khối lượng hàng hoá T100. Các giá trị mới có thể được thêm vào trong tương lai. Các ứng dụng cần chuẩn bị sẵn sàng để xử lý các giá trị enum không xác định một cách thích hợp.

Enum
STRATEGY_UNSPECIFIED Chiến lược không được chỉ định.
CARRIER_ROUTE_AIRCRAFT_CLASS Dữ liệu theo hãng vận chuyển, tuyến đường và hạng máy bay.
ROUTE_AIRCRAFT_CLASS Dữ liệu theo chặng bay và hạng máy bay.
DISTANCE_AIRCRAFT_CLASS Dữ liệu theo dải khoảng cách và hạng máy bay.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS Dữ liệu trước đây khớp với hãng hàng không, tuyến đường, năm, tháng và hạng máy bay.

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

Chiến lược về tỷ lệ diện tích ghế theo IATA. Các giá trị mới có thể được thêm vào trong tương lai. Các ứng dụng cần chuẩn bị sẵn sàng để xử lý các giá trị enum không xác định một cách thích hợp.

Enum
STRATEGY_UNSPECIFIED Chiến lược không được chỉ định.
NARROW_AIRCRAFT_BODY Tỷ lệ diện tích ghế cho máy bay thân hẹp được sử dụng.
WIDE_AIRCRAFT_BODY Tỷ lệ diện tích ghế cho máy bay thân rộng đã được sử dụng.

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

Chiến lược điều chỉnh khoảng cách. Các giá trị mới có thể được thêm vào trong tương lai. Các ứng dụng cần chuẩn bị sẵn sàng để xử lý các giá trị enum không xác định một cách thích hợp.

Enum
STRATEGY_UNSPECIFIED Chiến lược không được chỉ định.
ORIGIN_DESTINATION Hệ số điều chỉnh khoảng cách được xác định theo cặp sân bay khởi hành và sân bay đến.
COUNTRY_PAIR Hệ số điều chỉnh khoảng cách được xác định theo cặp quốc gia nơi xuất phát và nơi đến.
DEFAULT Hệ số điều chỉnh khoảng cách dựa trên giá trị mặc định vì chúng tôi không tìm thấy hệ số điều chỉnh theo sân bay hoặc quốc gia cụ thể.

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

Danh mục dữ liệu của nguồn dữ liệu. Các giá trị mới có thể được thêm vào trong tương lai. Các ứng dụng cần chuẩn bị sẵn sàng để xử lý các giá trị enum không xác định một cách thích hợp.

Enum
DATA_CATEGORY_UNSPECIFIED Danh mục dữ liệu chưa được chỉ định.
PRIMARY Dữ liệu chính, theo định nghĩa trong ISO 14083.
MODELED Dữ liệu được mô hình hoá, theo định nghĩa trong ISO 14083.
DEFAULT Dữ liệu giá trị mặc định, như được xác định trong ISO 14083.