Pelajari apa yang dapat Anda bangun dengan Contrails API dan pahami perilaku endpoint-nya.
Ringkasan
Contrails API menggabungkan data cuaca berskala besar, data penerbangan, dan gambar satelit dengan model computer vision canggih untuk menghasilkan prediksi jejak pesawat bertenaga AI. Prediksi ini memperkirakan zona yang kemungkinan akan terbentuk jejak pesawat dan potensi dampak jejak pesawat selama 48 jam ke depan.
Mengintegrasikan prediksi ini ke dalam alur kerja perencanaan penerbangan dapat membantu pilot menghindari terbang melalui wilayah ini, sehingga mencegah terbentuknya jejak kondensasi pemanasan.
Untuk memahami insight tentang tempat pembentukan jejak pesawat dan seberapa besar pemanasan yang akan terjadi, Contrails API menawarkan perkiraan sebagai petak dan wilayah.
Perkiraan
Contrails API menawarkan prakiraan sebagai:
Petak: Data 4D fidelitas tinggi yang merepresentasikan Nilai indeks paksaan jejak pesawat pada sumbu lintang, bujur, ketinggian, dan waktu, dalam format NetCDF. Petak ini merepresentasikan seluruh dunia sebagai petak seperempat derajat, dengan langkah lintang dan bujur adalah 0,25 derajat. Setiap petak diperkirakan akan berlangsung selama satu jam penuh (UTC).
Nilai indeks paksaan jejak pesawat berkisar dari 0, yang merepresentasikan lokasi tanpa pemanasan yang signifikan, hingga 4, yang merepresentasikan lokasi dengan pemanasan jejak pesawat yang parah.
Petak direkomendasikan untuk perencanaan penerbangan terprogram, terutama untuk mengubah rute penerbangan.
Wilayah: Versi prakiraan yang disederhanakan dan dipoligonkan, yang merepresentasikan wilayah penghindaran jejak pesawat dalam format multipoligon GeoJSON.
Wilayah penghindaran jejak pesawat dinilai dengan tingkat keparahan yang sama, tetapi tidak menyertakan 0 dan hanya dimulai dari 1 (dampak ringan).
Wilayah direkomendasikan untuk perencana penerbangan manusia yang dapat menetapkan kebijakan berdasarkan tingkat keparahan dan dapat mengalihkan rute penerbangan secara manual, biasanya melalui penyimpangan vertikal (yaitu, dengan menyesuaikan tingkat penerbangan).
Autentikasi
Untuk menggunakan Contrails API, Anda memerlukan kunci API dan harus mengaktifkan Contrails API.
Untuk mengetahui detailnya, ikuti panduan Menyiapkan lingkungan Anda.
Error
Saat menggunakan Contrails API, Anda mungkin mengalami error berikut:
| Kode | Penyebab | Penanganan error |
|---|---|---|
| 400 (permintaan tidak valid) | Permintaan dengan data yang salah | Tidak mencoba lagi secara otomatis. Error ini disebabkan oleh masalah dalam kode; periksa apakah Anda menggunakan format parameter yang benar. |
| 404 | Meminta waktu perkiraan yang belum dihitung | Coba lagi dengan strategi backoff eksponensial. |
| 429 | Terlalu banyak permintaan (lihat Batas penggunaan) | Coba lagi dengan backoff eksponensial. |
| 5XX | Error server | Coba lagi dengan backoff eksponensial. |
Pembuatan Versi
Rilis versi utama, seperti peluncuran v2, dapat memperkenalkan perilaku yang tidak kompatibel dengan rilis sebelumnya dan mungkin memerlukan perubahan kode.
Update reguler di antara rilis versi utama diharapkan memiliki kompatibilitas mundur.
Anda dapat membaca info tentang update utama di catatan rilis Contrails API.
Langkah berikutnya
- Untuk mulai menggunakan Contrails API, siapkan lingkungan Anda.
- Baca dokumentasi referensi Contrails API untuk mendapatkan panduan mendetail tentang metode Contrails API yang tersedia.
- Baca Ringkasan perkiraan jejak pesawat untuk memahami cara penghitungan perkiraan Contrails API.