Contrails API'ye genel bakış

Contrails API ile neler oluşturabileceğinizi keşfedin ve uç noktalarının nasıl davrandığını öğrenin.

Genel Bakış

Kuyruk izi API'si, yapay zeka destekli kuyruk izi tahminleri üretmek için büyük ölçekli hava durumu verilerini, uçuş verilerini ve uydu görüntülerini son teknoloji ürünü bir bilgisayarla görme 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 potansiyel 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.

Contrails API, yoğunlaşma izlerinin nerede oluşacağı ve ne kadar ısınmaya neden olacağıyla ilgili bu analizleri anlamak için ızgaralar ve bölgeler olarak tahminler 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ğruluklu 4D veriler NetCDF biçiminde. Bu ızgaralar, tüm dünyayı çeyrek derecelik bir ızgara olarak temsil eder.Bu ızgarada enlem ve boylam adımları 0,25 derecedir. Her ızgara için tam bir saatlik (UTC) tahmin yapılır.

    Uçak izi zorlama indeksi değerleri, önemli bir ısınmanın olmadığı konumu temsil eden 0 ile şiddetli uçak izi ısınmasının olduğu 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ı şiddet seviyeleriyle derecelendirilir ancak 0 değeri atlanır ve yalnızca 1'den (hafif etki) başlar.

    Bölgeler, önem düzeylerine göre politikalar oluşturabilen ve uçuşları genellikle dikey sapmalarla (ör. uçuş seviyelerini ayarlayarak) manuel olarak yeniden yönlendirebilen insan uçuş planlayıcıları için önerilir.

    Avrupa'nın bazı bölgelerindeki tahmin edilen bölgelerin ContrailExplorer görselleştirmesi. Maksimum uçuş seviyesi 340 ve minimum uçuş seviyesi 310 olan seçili yoğunlaşma izi önleme bölgesi gösterilmektedir.

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ılar için Ortamınızı ayarlama kılavuzundaki adımları uygulayın.

Hatalar

Contrails API'yi kullanırken aşağıdaki hatalarla karşılaşabilirsiniz:

Kod Neden Hata işleme
400 (geçersiz istekler) Yanlış veriler içeren istek Otomatik olarak yeniden denemeyin. Bu hata, koddaki 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 tekrar deneyin.
429 Çok fazla istek (Kullanım sınırları bölümüne bakın) Eksponansiyel geri yüklemeyle yeniden deneme yapılıyor.
5XX Sunucu hatası Eksponansiyel geri yüklemeyle yeniden deneme yapılıyor.

Sürüm oluşturma

v2'nin kullanıma sunulması gibi ana sürüm yayınları, önceki sürümlerle uyumlu olmayan davranışlar getirebilir 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?