Contrails API ile neler geliştirebileceğinizi keşfedin ve uç noktalarının nasıl çalıştığını öğrenin.
Genel Bakış
Kuyruk izi API'si, yapay zeka destekli kuyruk izi tahminleri oluşturmak için büyük ölçekli hava durumu verilerini, uçuş verilerini ve uydu görüntülerini son teknoloji ürünü bir bilgisayar görüntüleme modeliyle birleştirir. Bu tahminler, yoğunlaşma izi oluşma olasılığı olan bölgeleri ve önümüzdeki 48 saat içinde yoğunlaşma izlerinin olası etkisini tahmin eder.
Bu tahminleri uçuş planlama iş akışlarına entegre etmek, pilotların bu bölgelerden uçmaktan kaçınmasına yardımcı olabilir ve ısınmaya neden olan yoğunlaşma izlerinin oluşmasını önleyebilir.
Uçak izlerinin nerede oluşacağı ve ne kadar ısınmaya neden olacağıyla ilgili bu analizleri anlamak için Contrails API, tahminleri ızgaralar ve bölgeler olarak sunar.
Tahminler
Contrails API, tahminleri şu şekilde sunar:
Izgaralar: Enlem, boylam, yükseklik ve zaman eksenlerinde yoğunlaşma zorlama dizin değerlerini temsil eden yüksek doğruluk oranlı 4D veriler, NetCDF biçiminde. Bu ızgaralar, enlem ve boylam adımlarının 0,25 derece olduğu, tüm dünyayı çeyrek derecelik bir ızgara olarak gösterir. Her ızgara için bir saatlik (UTC) tahmin yapılır.
Uçak izi zorlama indeksi değerleri, önemli bir ısınmanın olmadığı bir konumu temsil eden 0 ile şiddetli uçak izi ısınmasının olduğu bir konumu temsil eden 4 arasında değişir.
Programatik uçuş planlaması için, özellikle uçuşların yeniden yönlendirilmesi söz konusu olduğunda ızgaralar önerilir.
Bölgeler: Tahminin basitleştirilmiş, poligonlaştırılmış sürümü. GeoJSON çoklu poligon biçiminde yoğunlaşma izi önleme bölgelerini gösterir.
Yoğunlaşma izi önleme bölgeleri aynı önem dereceleriyle derecelendirilir ancak 0 değeri atlanır ve yalnızca 1'den (hafif etki) başlar.
Bölgeler, genellikle dikey sapmalarla (ör. uçuş seviyelerini ayarlayarak) uçuşları manuel olarak yeniden yönlendirebilen ve politikaları şiddet düzeylerine göre belirleyebilen insan uçuş planlayıcıları için önerilir.
Kimlik doğrulama
Contrails API'yi kullanmak için bir API anahtarına ihtiyacınız vardır ve Contrails API'yi etkinleştirmeniz gerekir.
Ayrıntılı bilgi için Ortamınızı ayarlama kılavuzu'nu inceleyin.
Hatalar
Contrails API'yi kullanırken aşağıdaki hatalarla karşılaşabilirsiniz:
| Kod | Neden | Hata işleme |
|---|---|---|
| 400 (geçersiz istekler) | Yanlış verilerle yapılan istek | Otomatik olarak yeniden denemeyin. Bu hata, kodlardaki sorunlardan kaynaklanır. Doğru parametre biçimini kullandığınızdan emin olun. |
| 404 | Henüz hesaplanmamış bir tahmin zamanı için istekte bulunma | Eksponansiyel geri yükleme stratejisiyle yeniden deneyin. |
| 429 | Çok fazla istek var (Kullanım sınırları bölümüne bakın) | Eksponansiyel geri yüklemeyle yeniden deneyin. |
| 5XX | Sunucu hatası | Eksponansiyel geri yüklemeyle yeniden deneyin. |
Sürüm oluşturma
v2'nin kullanıma sunulması gibi ana sürüm yayınları, önceki sürümlerle uyumsuz davranışlar ortaya çıkarabilir ve kod değişiklikleri gerektirebilir.
Ana sürüm yayınları arasındaki düzenli güncellemelerin geriye dönük uyumlu olması beklenir.
Önemli güncellemeler hakkında bilgiyi Contrails API sürüm notlarında bulabilirsiniz.
Sırada ne var?
- Contrails API'yi kullanmaya başlamak için ortamınızı ayarlayın.
- Kullanılabilir Contrails API yöntemleri hakkında ayrıntılı bilgi için Contrails API referans belgelerini okuyun.
- Contrails API tahminlerinin nasıl hesaplandığını anlamak için Yoğunlaşma izi tahmini genel bakış başlıklı makaleyi okuyun.