Method: batchGetAttributions

Nhận nhiều thông tin về vệt ngưng tụ theo thông tin chuyến bay.

Nếu thành công, phản hồi sẽ là một danh sách các thuộc tính của vệt khói.

Yêu cầu HTTP

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Tài nguyên mẹ được chia sẻ bởi tất cả các mô hình phân bổ đang được truy xuất. Định dạng: attribution

Tham số truy vấn

Thông số
names[]

string

Bắt buộc. Tên tài nguyên của các chuyến bay cần truy xuất. Bạn có thể cung cấp tối đa 100 tên trong một yêu cầu.

Định dạng:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

Thành phần:

  • {carrier}: Mã hãng vận chuyển IATA gồm 2 ký tự (ví dụ: "AA", "UA").
  • {flightNumber}: Số hiệu chuyến bay gồm 1 đến 4 chữ số (ví dụ: "123").
  • {departure_date}: Ngày khởi hành chuyến bay theo định dạng YYYY-MM-DD.
  • {departure_airport}: Mã IATA gồm 3 chữ cái của sân bay (ví dụ: "JFK", "LHR").

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi chứa các dấu vết được phân bổ cho attributions.batchGet.

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 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
Trường
attributions[]

object (Attribution)

Một danh sách các thông tin ghi nhận quyền tác giả, mỗi thông tin cho một tên tài nguyên được chỉ định trong BatchGetAttributionsRequest.names. Thứ tự của các thông tin ghi nhận quyền tác giả trong danh sách này sẽ khớp với thứ tự của tên trong BatchGetAttributionsRequest. Nếu không tìm thấy chuyến bay, thông báo Phân bổ tương ứng trong phản hồi sẽ chỉ có trường name được điền sẵn, trong khi flightDetails và contrail sẽ trống.

Phân bổ

Biểu thị một sự kiện vệt khói tổng hợp cho một chuyến bay cụ thể, tóm tắt tất cả các đoạn vệt khói được phân bổ (ví dụ: tổng số km và năng lượng).

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  }
}
Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của chuyến bay.

Định dạng:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

Thành phần:

  • {carrier}: Mã hãng vận chuyển IATA gồm 2 ký tự (ví dụ: "AA", "UA").
  • {flightNumber}: Số hiệu chuyến bay gồm 1 đến 4 chữ số (ví dụ: "123").
  • {departure_date}: Ngày khởi hành chuyến bay theo định dạng YYYY-MM-DD.
  • {departure_airport}: Mã IATA gồm 3 chữ cái của sân bay (ví dụ: "JFK", "LHR").
flightDetails

object (FlightDetails)

Thông tin chi tiết về chuyến bay này.
contrail

object (ContrailAttributes)

Thông tin chi tiết về vệt khói trắng được quy cho chuyến bay.

Giải thích trạng thái (trong một chuyến bay được tìm thấy):

  • Nếu có: Đã thực hiện phân tích vệt khói. Các trường bên trong ContrailAttributes cho biết kết quả (ví dụ: lengthMeters > 0 nghĩa là vệt khói được ghi nhận).
  • Nếu không có: KHÔNG thể phân tích vệt khói cho chuyến bay này.
    • Điều này thường là do không có đủ dữ liệu đầu vào (ví dụ: thiếu dữ liệu thời tiết hoặc đường bay không chắc chắn).
    • Điều này KHÔNG có nghĩa là không có vệt khói nào được tạo ra, mà chỉ là không thể xác định được.

FlightDetails

Xác định toàn bộ thông tin chuyến bay được trả về trong phản hồi.

Biểu diễn dưới dạng JSON 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": string
}
Trường
carrier

string

Mã IATA của hãng hàng không khai thác chuyến bay (ví dụ: "AA").
flightNumber

integer

Số hiệu chuyến bay (ví dụ: "123").
departureTime

string

Ngày khởi hành theo múi giờ của sân bay khởi hành int: unix epoch; str: ISO 8601.
icao24

string

Địa chỉ 24 bit của máy bay theo ICAO
originAirport

string

Mã IATA của sân bay khởi hành.
destinationAirport

string

Mã IATA của sân bay đến.
callSign

string

Mã nhận dạng của máy bay được liên kết với điểm tham chiếu.
analyzedFlightDistanceMeters

string (int64 format)

Khoảng cách của chuyến bay được phân tích, tính bằng mét.

ContrailAttributes

Biểu thị các thuộc tính vệt ngưng tụ của một chuyến bay.

Biểu diễn dưới dạng JSON 
{
  "lengthMeters": string,
  "effectiveEnergyForcingJoules": string
}
Trường
lengthMeters

string (int64 format)

Chiều dài ước tính của đường mây do máy bay tạo ra, tính bằng mét.
effectiveEnergyForcingJoules

string (int64 format)

Tổng năng lượng cưỡng bức hiệu quả được quy cho chuyến bay này, tính bằng joule.