Method: flights.computeFlightEmissions

Phương thức không có trạng thái để truy xuất lượng khí thải ước tính. Thông tin chi tiết về cách tính số liệu ước tính về lượng khí thải: https://github.com/google/travel-impact-model

Phản hồi sẽ chứa tất cả các mục nhập khớp với các chuyến bay được nhập 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ó trường phát thải trống. Yêu cầu đó vẫn sẽ được coi là thành công. Lý do thiếu số liệu ước tính về lượng khí thải bao gồm:

  • Máy chủ không xác định được chuyến bay.
  • Giai đoạn chuyến bay đầu vào thiếu một hoặc nhiều giá trị nhận dạng.
  • Chuyến bay đã diễn ra 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 1.000 chặng bay. Nếu yêu cầu có hơn 1000 chuyến bay trực tiếp, hệ thống sẽ không thực hiện được do lỗi INVALID_ACCOUNT.

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)
    }
  ]
}
Các trường
flights[]

object (Flight)

Bắt buộc. Các chuyến bay trực tiếp để trả về lượng khí thải ước tính.

Nội dung phản hồi

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:

Định nghĩa dữ liệu đầu ra cho phản hồi [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions].

Biểu diễn dưới dạng JSON 
{
  "flightEmissions": [
    {
      object (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Các trường
flightEmissions[]

object (FlightWithEmissions)

Danh sách chặng 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ả 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 cho số liệu ước tính về lượng khí thải từ chuyến bay ước tính.

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

string

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

string

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

string

Bắt buộc. Mã hãng vận chuyển 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 của chuyến bay theo múi giờ của sân bay khởi hành. Phải là một ngày ở hiện tại hoặc trong 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. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không đáng kể. Ngày này có liên quan đến Dương lịch. Điều này có thể đại diện cho một trong những điều sau:

  • Ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, với năm 0 (ví dụ: ngày kỷ niệm).
  • Chỉ có một năm, có một tháng không có ngày nào.
  • Năm và tháng, không có ngày (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
}
Các trường
year

integer

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

integer

Tháng trong năm. 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 0 để chỉ định một năm hoặc một năm và tháng không có ngày quan trọng.

FlightWithEmissions

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

Biểu diễn dưới dạng JSON 
{
  "flight": {
    object (Flight)
  },
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Các trường
flight

object (Flight)

Bắt buộc. Khớp với mã nhận dạng chuyến bay trong yêu cầu. Lưu ý: tất cả các mã IATA đều được viết hoa.
emissionsGramsPerPax

object (EmissionsGramsPerPax)

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

EmissionsGramsPerPax

Lượng khí thải theo nhóm theo kết quả của hạng ghế.

Biểu diễn dưới dạng JSON 
{
  "first": integer,
  "business": integer,
  "premiumEconomy": integer,
  "economy": integer
}
Các trường
first

integer

Lượng khí thải của một hành khách ở hạng nhất (tính theo 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

integer

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

integer

Lượng khí thải của một hành khách ở hạng phổ thông cao cấp tính theo 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 cao cấp hay không.
economy

integer

Lượng khí thải của một hành khách ở hạng phổ thông tính theo 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.

ModelVersion

Phiên bản Mô hình tác động du lịch. Để biết thêm thông tin về phiên bản của mô hình, hãy truy cập vào https://github.com/google/travel-impact-model/#versioning.

Biểu diễn dưới dạng JSON 
{
  "major": integer,
  "minor": integer,
  "patch": integer,
  "dated": string
}
Các trường
major

integer

Phiên bản chính: Những thay đổi lớn đối với phương pháp (ví dụ: thêm các nguồn dữ liệu mới vào mô hình dẫn đến những thay đổi lớn về đầu ra). Những thay đổi như vậy sẽ không thường xuyên và được thông báo từ sớm. Có thể liên quan đến các thay đổi về phiên bản API, tuân theo các nguyên tắc trong https://cloud.google.com/endpoints/docs/openapi/versioning-an-api#backwards-incompatible
minor

integer

Phiên bản nhỏ: Các thay đổi đối với mô hình nhưng nhất quán trên các phiên bản giản đồ nhưng lại làm thay đổi các tham số hoặc phương thức triển khai của mô hình.
patch

integer

Phiên bản bản vá: Các thay đổi trong quá trình triển khai nhằm giải quyết lỗi hoặc các điểm chưa chính xác trong quá trình triển khai mô hình.
dated

string

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