Tổng quan về Contrails API

Khám phá những gì bạn có thể tạo bằng Contrails API và tìm hiểu cách các điểm cuối của API này hoạt động.

Tổng quan

Contrails API kết hợp dữ liệu thời tiết quy mô lớn, dữ liệu chuyến bay và hình ảnh vệ tinh với một mô hình thị giác máy tính hiện đại để tạo ra thông tin dự đoán về vệt khói do AI cung cấp. Những thông tin dự đoán này dự báo các vùng có khả năng xuất hiện vết phản lực và tác động tiềm ẩn của vết phản lực trong 48 giờ tới.

Việc tích hợp những dự đoán này vào quy trình lập kế hoạch bay có thể giúp phi công tránh bay qua những khu vực này, ngăn chặn việc tạo ra các vệt ngưng tụ gây hiệu ứng ấm lên.

Để hiểu rõ những thông tin chi tiết này về nơi hình thành vết phản lực và mức độ làm nóng của chúng, Contrails API cung cấp thông tin dự đoán dưới dạng lưới và khu vực.

Dự báo

Contrails API cung cấp thông tin dự báo dưới dạng:

  • Lưới: Dữ liệu 4D có độ trung thực cao, biểu thị các giá trị chỉ số cưỡng bức của vệt khói trên các trục vĩ độ, kinh độ, độ cao và thời gian, ở định dạng NetCDF. Các lưới này biểu thị toàn bộ quả địa cầu dưới dạng lưới 0,25 độ, trong đó các bước vĩ độ và kinh độ là 0,25 độ. Mỗi lưới được dự báo trong một giờ đầy đủ (theo giờ UTC).

    Giá trị chỉ số tác động của vết phản lực dao động từ 0 (thể hiện một vị trí không có hiện tượng nóng lên đáng kể) đến 4 (thể hiện một vị trí có hiện tượng nóng lên nghiêm trọng do vết phản lực).

    Bạn nên dùng lưới để lập kế hoạch bay có lập trình, đặc biệt là khi định tuyến lại các chuyến bay.

  • Khu vực: Phiên bản đơn giản hoá, đa giác hoá của bản dự báo, thể hiện các khu vực tránh vết phản lực ở định dạng đa giác GeoJSON.

    Các khu vực tránh vết phản lực được đánh giá theo cùng mức độ nghiêm trọng, nhưng bỏ qua 0 và chỉ bắt đầu từ 1 (tác động nhẹ).

    Các khu vực này được đề xuất cho những người lập kế hoạch bay cho con người. Họ có thể thiết lập các chính sách dựa trên mức độ nghiêm trọng và có thể định tuyến lại các chuyến bay theo cách thủ công, thường là thông qua độ lệch dọc (tức là bằng cách điều chỉnh độ cao bay).

    Hình ảnh trực quan về công cụ khám phá vệt khói trắng cho các khu vực dự báo ở một số nơi tại Châu Âu, với khu vực tránh vệt khói trắng đã chọn có độ cao bay tối đa là 340 và độ cao bay tối thiểu là 310.

Xác thực

Để sử dụng Contrails API, bạn cần có khoá API và phải bật Contrails API.

Để biết thông tin chi tiết, hãy làm theo Hướng dẫn thiết lập môi trường.

Lỗi

Khi sử dụng Contrails API, bạn có thể gặp phải các lỗi sau:

Mã Nguyên nhân Xử lý lỗi
400 (yêu cầu không hợp lệ) Yêu cầu có dữ liệu không chính xác Không tự động thử lại. Lỗi này là do các vấn đề trong mã; hãy kiểm tra để đảm bảo bạn đang sử dụng đúng định dạng tham số.
404 Yêu cầu thời gian dự đoán chưa được tính toán Thử lại bằng chiến lược thời gian đợi luỹ thừa.
429 Quá nhiều yêu cầu (tham khảo phần Hạn mức sử dụng) Thử lại với thời gian đợi luỹ thừa.
5XX Lỗi máy chủ Thử lại với thời gian đợi luỹ thừa.

Lập phiên bản

Các bản phát hành phiên bản chính, chẳng hạn như việc ra mắt v2, có thể giới thiệu hành vi không tương thích với các bản phát hành trước và có thể yêu cầu thay đổi mã.

Các bản cập nhật định kỳ giữa các bản phát hành phiên bản chính dự kiến sẽ tương thích ngược.

Bạn có thể đọc về các nội dung cập nhật chính trong Ghi chú phát hành của Contrails API.

Bước tiếp theo