Phân bổ

Các phân đoạn vệt mây do máy bay tạo ra đượ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 mây do máy bay tạo ra được phân bổ 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 phân bổ, mỗi phân bổ cho một tên tài nguyên được chỉ định trong BatchGetAttributionsRequest.names. Thứ tự của các phân bổ 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ì thông báo Phân bổ tương ứng trong phản hồi sẽ chỉ có trường name được điền, trong khi flightDetails và contrail sẽ trống.

Phân bổ

Đại diện cho một sự kiện vệt mây do máy bay tạo ra được tổng hợp cho một chuyến bay cụ thể, tóm tắt tất cả các phân đoạn vệt mây do máy bay tạo ra được phân bổ (ví dụ: tổng số ki-lô-mét 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

Số 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ã IATA gồm 2 ký tự của hãng hàng không (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 của chuyến bay ở đị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 vệt mây do máy bay tạo ra được tổng hợp cho toàn bộ chuyến bay. Thuộc tính này tổng hợp các thuộc tính vệt mây do máy bay tạo ra từ tất cả các phân đ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 mây do máy bay tạo ra. Các trường bên trong ContrailAttributes cho biết kết quả (ví dụ: lengthMeters > 0 có nghĩa là các vệt mây do máy bay tạo ra đã được phân bổ).
  • Nếu không có: KHÔNG thể thực hiện phân tích vệt mây do máy bay tạo ra cho chuyến bay này.
    • Nguyên nhân thường là do không có đủ thông tin đầ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 mây do máy bay tạo ra, mà chỉ là không thể xác định được.
segments[]

object (SegmentAttribution)

Phân bổ vệt mây do máy bay tạo ra theo từng phân đoạn. Mỗi mục đại diện cho một khoảng thời gian riêng biệt của chuyến bay mà vệt mây do máy bay tạo ra được phân bổ.

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: thời gian bắt đầu của hệ thống Unix HOẶC str: ISO 8601.
icao24

string

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

string

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

string

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

string

Dấu hiệu nhận dạng của máy bay. Trường này ưu tiên chứa dấu hiệu nhận dạng được dùng trong thông tin liên lạc của Kiểm soát không lưu (ATC). Nếu không có dấu hiệu nhận dạng ATC cụ thể hoặc dấu hiệu nhận dạng đó giống với dấu hiệu nhận dạng chuyến bay tiêu chuẩn, thì trường này sẽ chứa dấu hiệu 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

Đại diện cho các thuộc tính vệt mây do máy bay tạo ra 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 mây do máy bay tạo ra được phân bổ. Thuộc tính này được tính là 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 vệt mây do máy bay tạo ra có hiệu quả, tính bằng joule. Thuộc tính này hiện được tính dựa trên mức trung bình khí hậu và có thể thay đổi.

SegmentAttribution

Đại diện cho việc phân bổ vệt mây do máy bay tạo ra cho một phân đ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 phân đoạn chuyến bay mà vệt mây do máy bay tạo ra được phân bổ. Dấu thời gian này tính bằng giây kể từ thời điểm bắt đầu của hệ thống Unix theo múi giờ UTC.
endTime

string (Timestamp format)

Thời gian kết thúc của phân đoạn chuyến bay mà vệt mây do máy bay tạo ra được phân bổ. Dấu thời gian này tính bằng giây kể từ thời điểm bắt đầu của hệ thống Unix theo múi giờ UTC.
contrail

object (ContrailAttributes)

Các thuộc tính vệt mây do máy bay tạo ra cho phân đoạn cụ thể này.
detectionEvidences[]

object (ContrailDetectionEvidence)

Các lần phát hiện vệt mây do máy bay tạo ra bằng vệ tinh riêng lẻ cung cấp bằng chứng cho việc phân bổ cho phân đoạn chuyến bay này.

ContrailDetectionEvidence

Thông tin chi tiết về một lần quan sát vệt mây do máy bay tạo ra 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 hình ảnh vệ tinh phát hiện vệt mây do máy bay tạo ra. Đâ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 kể từ thời điểm bắt đầu của hệ thống Unix theo múi giờ UTC.
observedLengthMeters

integer

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

  • Vệt mây do máy bay tạo ra có thể đã phát triển (ví dụ: lan rộng, kéo dài, 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 mây do máy bay tạo ra 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 cho lần phát hiện này.

DataSource

Nguồn dữ liệu vệ tinh được dùng để phát hiện vệt mây do máy bay tạo ra. Các giá trị khác có thể được thêm vào trong tương lai.

Hiện tại, GOES East và MTG là các đầu ra dữ liệu vệ tinh có sẵn. Các phân bổ dựa trên GOES East có chất lượng ở cấp độ sản xuất, trong khi các phân bổ dựa trên MTG vẫn đang ở giai đoạn Beta và đang tích cự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 lần quét toàn bộ đĩa GOES-East.
GOES_WEST_FULL_DISK Dữ liệu từ các lần quét toàn bộ đĩa GOES-West.
MTG_000_FULL_DISK Dữ liệu từ các lần quét toàn bộ đĩa MTG-000.
HIMAWARI_FULL_DISK Dữ liệu từ các lần quét toàn bộ đĩa Himawari.

Giấy phép

Dữ liệu do API Phân bổ ContrailWatch cung cấp được cấp phép theo CC BY-NC 4.0.