Package google.travel.sustainability.travelimpactmodel.v1

Chỉ mục

TravelImpactModelService

API cung cấp thông tin ước tính về lượng khí thải cacbon.

ComputeFlightEmissions

rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse)

Phương thức không trạng thái để truy xuất dữ liệu ước tính lượng khí thải. Bạn có thể xem thông tin chi tiết về cách tính toán lượng khí thải ước tính 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.
ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse)

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

rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse)

Truy xuất thông tin ước tính về lượng khí thải thông thường của chuyến bay giữa hai sân bay, còn được gọi là thị trường. Nếu không có thông tin ước tính cho một thị trường nhất định, thì phản hồi sẽ trả về đối tượng thị trường có các trường phát thải trống. Yêu cầu vẫn được coi là thành công.

Bạn có thể xem thông tin chi tiết về cách tính lượng khí thải ước tính thông thường trên GitHub.

Yêu cầu có thể chứa tối đa 1.000 thị trường. Nếu yêu cầu có hơn 1.000 thị trường, thì yêu cầu đó sẽ không thành công và trả về lỗi INVALID_ARGUMENT.

ComputeFlightEmissionsRequest

Định nghĩa đầu vào cho yêu cầu ComputeFlightEmissions.

Trường
flights[]

Flight

Bắt buộc. Chuyến bay thẳng để trả về dữ liệu ước tính lượng khí thải.

ComputeFlightEmissionsResponse

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

Trường
flight_emissions[]

FlightWithEmissions

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

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.

ComputeScope3FlightEmissionsRequest

Danh sách các chặng bay để yêu cầu thông tin về lượng khí thải Phạm vi 3.

Trường
flights[]

Scope3FlightSegment

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

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.

ComputeScope3FlightEmissionsResponse

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

Trường
flight_emissions[]

Scope3FlightEmissions

Danh sách các đoạn bay có lượng khí thải ước tính.
model_version

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.

ComputeTypicalFlightEmissionsRequest

Danh sách các cặp sân bay (thị trường) để yêu cầu lượng khí thải thông thường.

Trường
markets[]

Market

Bắt buộc. Yêu cầu ước tính lượng khí thải thông thường của chuyến bay cho cặp thị trường này. Bạn có thể yêu cầu tối đa 1.000 thị trường.

ComputeTypicalFlightEmissionsResponse

Phản hồi bao gồm cả lượng khí thải và phiên bản mô hình.

Trường
typical_flight_emissions[]

TypicalFlightEmissions

Đã yêu cầu Lượng khí thải thông thường của chuyến bay trên thị trường.
model_version

ModelVersion

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

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.

EasaLabelMetadata

Siêu dữ liệu về Nhãn phát thải chuyến bay của EASA.

Trường
label_issue_date

Date

Ngày phát hành nhãn.
label_expiry_date

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

string

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

double

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

EmissionsGramsPerPax

Kết quả về lượng khí thải theo nhóm cho từng hạng ghế.

Trường
first

int32

Lượng khí thải của một hành khách hạng nhất tính bằng gam. Trường này luôn được tính toán và điền sẵn, bất kể máy bay có ghế hạng nhất hay không.
business

int32

Lượng khí thải của một hành khách hạng thương gia tính bằng gam. Trường này luôn được tính toán và điền sẵn, bất kể máy bay có ghế hạng thương gia hay không.
premium_economy

int32

Lượng khí thải của một hành khách ở hạng phổ thông đặc biệt tính bằng gam. Trường này luôn được tính toán và điền sẵn, bất kể máy bay có ghế hạng phổ thông đặc biệt hay không.
economy

int32

Lượng khí thải của một hành khách hạng phổ thông tính bằng gam. Trường này luôn được tính toán và điền sẵn, bất kể máy bay có ghế hạng phổ thông hay không.

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.

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".
operating_carrier_code

string

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

int32

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

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.

FlightWithEmissions

Chuyến bay thẳng có thông tin ước tính về lượng khí thải.

Trường
flight

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

Source

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

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 ComputeFlightEmissions.
easa_label_metadata

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

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.

Thị trường

Một cặp sân bay.

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

ModelVersion

Phiên bản Travel Impact Model. Để biết thêm thông tin về việc tạo phiên bản mô hình, hãy xem GitHub.

Trường
major

int32

Phiên bản chính: Những thay đổi lớn về phương pháp luận (ví dụ: thêm nguồn dữ liệu mới vào mô hình dẫn đến những thay đổi lớn về kết quả). Những thay đổi như vậy sẽ không thường xuyên và được thông báo trước. Có thể liên quan đến các thay đổi về phiên bản API, tuân thủ nguyên tắc về API của Google Cloud
minor

int32

Phiên bản phụ: Các thay đổi đối với mô hình, mặc dù nhất quán trên các phiên bản giản đồ, nhưng lại thay đổi các thông số hoặc việc triển khai mô hình.
patch

int32

Phiên bản vá: Thay đổi về việc triển khai nhằm giải quyết các lỗi hoặc điểm không chính xác trong quá trình triển khai mô hình.
dated

string

Phiên bản có ngày: Các tập dữ liệu mô hình được tạo lại bằng dữ liệu đầu vào mới nhưng không có thay đổi nào đối với các thuật toán thường xuyên.

Scope3FlightEmissions

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

Trường
flight

Scope3FlightSegment

Bắt buộc. Khớp với giá trị nhận dạng chuyến bay trong yêu cầu.
wtw_emissions_grams_per_pax

int64

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

int64

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

int64

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

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.

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.

Trường
departure_date

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).
cabin_class

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

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ã).
flight_number

int32

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

int64

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.

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.

TypicalFlightEmissions

Lượng khí thải ước tính thông thường của chuyến bay cho một thị trường nhất định

Trường
market

Market

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

EmissionsGramsPerPax

Không bắt buộc. Lượng khí thải thông thường của chuyến bay trên mỗi hành khách cho thị trường được yêu cầu. Sẽ không xuất hiện nếu không tính được lượng khí thải thông thường. Để xem danh sách các lý do khiến không thể tính toán lượng khí thải của chuyến bay thông thường, hãy xem GitHub.