Phân bổ

Các phân đoạn vệt khói đượ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 phân bổ chứa dữ liệu có cấu trúc như sau:

Biểu diễn dưới dạng JSON 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
Trường
attributions[]

object (Attribution)

Danh sách thông tin ghi nhận tác giả, mỗi thông tin tương ứng với một tên tài nguyên được chỉ định trong BatchGetAttributionsRequest.names. Thứ tự của các thuộc tính 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ì 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, còn flightDetails và contrail sẽ trống.

Phân bổ

Đại diện cho 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)
    }
  ],
  "visualizationUrl": string
}
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 hàng không gồm 2 ký tự theo IATA (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 theo giờ địa phương của sân bay khởi hành theo định dạng YYYY-MM-DD (có từ năm 2024 trở đi).
  • {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 về vệt ngưng tụ cho toàn bộ chuyến bay. Đây là tổng hợp các thuộc tính của vệt khói 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 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 có thông báo ContrailAttributes trống, thì tức là quá trình phân tích đã được thực hiện nhưng cả lengthMeters và lực đẩy năng lượng đều được đánh giá là bằng 0.
  • Nếu không có: KHÔNG THỂ thực hiện phân tích vệt khói cho chuyến bay này.
    • Điều này thường là do dữ liệu đầu vào không đủ (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 hình thành, mà chỉ có nghĩa là không thể đưa ra kết luận.
segments[]

object (SegmentAttribution)

Thông tin phân bổ vệt khói trắng 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à(các) vệt ngưng tụ được cho là xuất hiện.
visualizationUrl

string

Chỉ có đầu ra. Đường liên kết đến hình ảnh trực quan tương tác về thông tin phân bổ vệt khói của chuyến bay này trên trang ContrailWatch của ContrailExplorer. Biểu đồ này cho thấy đường bay khớp với vệt ngưng tụ do vệ tinh phát hiện.

Chỉ được điền sẵn cho các chuyến bay tìm thấy khi sử dụng chế độ xem ATTRIBUTION_VIEW_OBSERVATION.

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ã hãng hàng không IATA của 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, ở định dạng YYYYMMDD.
icao24

string

Địa chỉ máy bay 24 bit của ICAO
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

Hô hiệu của máy bay. Trường này ưu tiên chứa hô hiệu dùng trong hoạt động liên lạc với Kiểm soát không lưu (ATC). Nếu không có hô hiệu ATC cụ thể hoặc hô hiệu ATC giống với mã hiệu chuyến bay tiêu chuẩn, thì trường này sẽ chứa mã hiệu chuyến bay tiêu chuẩn (thường là tổ hợp 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 trắng cho một chuyến bay hoặc chặng 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 có vệt khói. Khoảng cách này được tính bằng khoảng cách vò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 bức xạ năng lượng hiệu quả của vệt khói, tính bằng joule. Giá trị này được tính bằng cách trích xuất lực bức xạ hiệu dụng từ kết quả dự báo CoCiP dạng lưới 4D và nội suy tuyến tính các kết quả đó. Phương pháp này có thể thay đổi.

SegmentAttribution

Đại diện cho thông tin phân bổ vệt khói trắng 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)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
Trường
startTime

string (Timestamp format)

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

string (Timestamp format)

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

object (ContrailAttributes)

Thuộc tính vệt khói cho phân đoạn cụ thể này.
detectionEvidences[]

object (ContrailDetectionEvidence)

Các kết quả phát hiện vệt khói riêng lẻ từ vệ tinh cung cấp bằng chứng cho thấy vệt khói này là do chặng bay này tạo ra.
attributionMethod

enum (AttributionMethod)

Chỉ có đầu ra. Phương pháp dùng để phân bổ vệt khói cho phân đoạn này (ví dụ: mô hình CoCiP hoặc quan sát trực tiếp).
longGapInterpolation

boolean

Chỉ có đầu ra. Giá trị là True nếu đường bay của phân đoạn được tạo bằng cách nội suy trong một khoảng trống dữ liệu ADS-B dài (>5 phút).
waypointAttributions[]

object (WaypointAttribution)

Chỉ có đầu ra. Các thuộc tính vệt khói theo từng điểm tham chiếu được liên kết trên đoạn đường này.

ContrailDetectionEvidence

Thông tin chi tiết về một lần quan sát vệt khói 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 thấy vệt khói. Đây thường là thời gian bắt đầu quét. Dấu thời gian này được tính bằng giây theo giờ UTC.
observedLengthMeters

integer

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

  • Vệt khói có thể đã phát triển (ví dụ: lan rộng, kéo dài, v.v.) trong bầu 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 cách chắc chắn một phần của vệt khói trắng này cho chuyến bay này.
dataSource

enum (DataSource)

Chỉ có đầu ra. Nguồn dữ liệu vệ tinh được dùng cho hoạt động phát hiện này.

DataSource

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

Trong số các kết quả dữ liệu vệ tinh hiện có, thông tin ghi nhận tác giả dựa trên GOES East và Himawari có chất lượng ở cấp độ sản xuất, trong khi thông tin ghi nhận tác giả dựa trên MTG vẫn đang trong giai đoạn thử nghiệm 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 lầ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 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 của Himawari.

Hình ảnh vệ tinh của Contrails API dựa trên:

WaypointAttribution

Biểu thị các thuộc tính của vệt khói cho một điểm tham chiếu cụ thể trong một chặng bay.

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

string (Timestamp format)

Thời gian tại điểm tham chiếu tính bằng giây theo giờ UTC.
contrailAttributes

object (ContrailAttributes)

Các thuộc tính của vệt khói được liên kết tại điểm tham chiếu cụ thể này.

AttributionMethod

Xác định quy trình hoặc phương pháp cụ thể được dùng để phân bổ.

Enum
ATTRIBUTION_METHOD_OBSERVATION Nguồn gốc được xác định hoàn toàn bằng cách so khớp với dữ liệu phát hiện vệt khói của vệ tinh.
ATTRIBUTION_METHOD_COCIP Mô hình phân bổ hoàn toàn dựa trên mô hình CoCiP dựa trên vật lý.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

Phân bổ kết hợp, kết hợp thông tin dự báo của mô hình CoCiP được điều chỉnh dự báo theo dữ liệu phát hiện của vệ tinh.

  • Có phát hiện: Nếu có detectionEvidences, vệt khói đã được dự đoán và xác nhận bằng quan sát, nhận được trọng số làm ấm cao hơn.
  • Không có dữ liệu phát hiện: Nếu thiếu detectionEvidences, thì vệt khói trắng được dự đoán nhưng không được quan sát, vì vậy, mức độ nóng lên được tính toán sẽ bị giảm đi.
ATTRIBUTION_METHOD_UNSPECIFIED Phương thức không xác định.

Ghi chú

Mỗi DataSource sử dụng các giới hạn khác nhau để xử lý lượt xem dựa trên dữ liệu quan sát:

Hộp giới hạn phạm vi phủ sóng vệ tinh (chế độ xem Mercator phẳng)

Giấy phép

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