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 thông tin ghi nhận về 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

Tham 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)

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 các 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)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
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)

Các thuộc tính tổng hợp của vệt ngưng tụ cho toàn bộ chuyến bay. Thao tác này sẽ tổng hợp các thuộc tính của vệt phản lực từ tất cả các đoạn được phân bổ.

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 phản lực nào được hình thành, mà chỉ là không thể xác định được.
segments[]

object (SegmentAttribution)

Mô hình phân bổ vệt khói theo từng đoạn. Mỗi mục nhập đại diện cho một khoảng thời gian riêng biệt của chuyến bay mà(các) vệt ngưng tụ được gán.

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": integer
}
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ã hiệu của máy bay. Trường này ưu tiên chứa mã nhận dạng được dùng trong thông tin liên lạc của Bộ phận kiểm soát không lưu (ATC). Nếu không có mã nhận dạng cuộc gọi cụ thể của ATC hoặc mã này giống với mã nhận dạng chuyến bay tiêu chuẩn, thì trường này sẽ chứa mã nhận dạng chuyến bay tiêu chuẩn (thường là sự kết hợp giữa mã hãng hàng không và số hiệu chuyến bay đối với các chuyến bay thương mại).
analyzedFlightDistanceMeters

integer

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 của vệt khói cho một chuyến bay hoặc phân đoạn chuyến bay.

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

integer

Chiều dài (tính bằng mét) của (các) tập hợp con trong đường bay mà vết phản lực được gán. Khoảng cách này được tính bằng khoảng cách đường tròn lớn giữa các điểm tham chiếu của chuyến bay.
effectiveEnergyForcingJoules

string (int64 format)

Tổng năng lượng bức xạ hiệu quả của vết phản lực, tính bằng joule. Chỉ số này hiện được tính dựa trên số liệu trung bình về khí hậu và có thể thay đổi.

SegmentAttribution

Biểu thị mức đóng góp của vệt khói trắng cho một đoạn thời gian cụ thể của chuyến bay.

Biểu diễn dưới dạng JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
Trường
startTime

string (Timestamp format)

Thời gian bắt đầu của chặng bay mà vệt khói được phân bổ. Dấu thời gian này tính bằng giây theo thời gian bắt đầu của hệ thống UTC.
endTime

string (Timestamp format)

Thời gian kết thúc của chặng bay mà vệt khói được phân bổ. Dấu thời gian này tính bằng giây theo thời gian bắt đầu của hệ thống UTC.
contrail

object (ContrailAttributes)

Các thuộc tính của đường bay cho đoạn đường cụ thể này.
detectionEvidences[]

object (ContrailDetectionEvidence)

Các lần phát hiện vệt khói riêng lẻ của vệ tinh cung cấp bằng chứng cho việc phân bổ cho đoạn bay này.

ContrailDetectionEvidence

Thông tin chi tiết về một lần quan sát vết phản lực bằng vệ tinh.

Biểu diễn dưới dạng JSON 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
Trường
observationTime

string (Timestamp format)

Thời điểm chụp ảnh vệ tinh phát hiện thấy vết phản lực. Đây thường là thời gian bắt đầu quét. Dấu thời gian này tính bằng giây theo thời gian bắt đầu của hệ thống UTC.
observedLengthMeters

integer

Chiều dài quan sát được từ đầu đến cuối của đặc điểm vệt khói dạng đường thẳng tính bằng mét, được phát hiện trong hình ảnh vệ tinh do observationTime chỉ định. Độ dài này có thể khác với lengthMeters trong SegmentAttribution.contrail vì:

  • Vệt khói có thể đã thay đổi (ví dụ: lan rộng, dài hơn, v.v.) trong khí quyển giữa thời điểm hình thành và thời điểm quan sát.
  • Thuật toán phân bổ chỉ có thể phân bổ một phần vệt khói trắng này cho chuyến bay này một cách chắc chắn.
dataSource

enum (DataSource)

Chỉ có đầu ra. Nguồn dữ liệu vệ tinh được dùng để phát hiện.

DataSource

Nguồn dữ liệu vệ tinh được dùng để phát hiện vết phản lực. Các giá trị khác có thể được thêm vào trong tương lai.

Enum
DATA_SOURCE_UNSPECIFIED Nguồn dữ liệu không xác định.
GOES_EAST_FULL_DISK Dữ liệu từ các bản quét toàn bộ đĩa của GOES-East.
GOES_WEST_FULL_DISK Dữ liệu từ các lần quét toàn bộ đĩa của GOES-West.
MTG_000_FULL_DISK Dữ liệu từ các bản quét toàn bộ đĩa MTG-000.
HIMAWARI_FULL_DISK Dữ liệu từ các bản quét toàn bộ đĩa của Himawari.