Phân bổ

Các đoạn đường bay có dấu vết ngưng tụ được phân bổ cho một danh sách chuyến bay cụ thể.

Định dạng dữ liệu

Yêu cầu về vệt khói có thông tin về nguồn 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ã sân bay IATA gồm 3 chữ cái (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 có nghĩa là vệt khói trắng được quy cho).
  • 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 tạo ra, mà chỉ là không thể xác định được.
segments[]

object (SegmentAttribution)

Phân bổ giá trị đóng góp theo từng đoạn đường. 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 (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 HOẶC 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 Dịch vụ 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 của đườ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 gán. 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 gán. 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 trong tương lai.

Hiện tại, GOES East và MTG là những dữ liệu đầu ra từ vệ tinh có sẵn. Thông tin phân bổ dựa trên GOES East có chất lượng ở cấp độ sản xuất, trong khi thông tin phân bổ dựa trên MTG vẫn đang ở giai đoạn Beta và đang được cải thiện chất lượng.

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.