İlişkilendirmeler

Belirli bir uçuş listesi için atfedilen yoğuşma izi segmentleri.

Veri biçimi

İlişkilendirilmiş uçak izleri istekleri aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
Alanlar
attributions[]

object (Attribution)

BatchGetAttributionsRequest.names içinde belirtilen her kaynak adı için birer tane olmak üzere ilişkilendirmelerin listesi. Bu listedeki ilişkilendirme sırası, BatchGetAttributionsRequest içindeki adların sırasıyla eşleşir. Uçuş bulunamazsa yanıttaki ilgili Attribution mesajında yalnızca name alanı doldurulur, flightDetails ve contrail alanları ise boş kalır.

İlişkilendirme

Belirli bir uçuş için tüm ilişkilendirilmiş yoğunlaşma izi segmentlerini (ör. toplam kilometre ve enerji) özetleyen, toplanmış bir yoğunlaşma izi etkinliğini temsil eder.

JSON gösterimi 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
Alanlar
name

string

Tanımlayıcı. Uçuşun kaynak adı.

Biçim:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

Bileşenler:

  • {carrier}: 2 karakterli IATA taşıyıcı kodu (ör. "AA", "UA").
  • {flightNumber}: 1-4 haneli uçuş numarası (ör. "123").
  • {departure_date}: YYYY-MM-DD biçiminde, kalkış havaalanının yerel saatine göre uçuş kalkış tarihi.
  • {departure_airport}: 3 harfli IATA havalimanı kodu (ör. "JFK", "LHR").
flightDetails

object (FlightDetails)

Bu uçuşun ayrıntılı bilgileri.
contrail

object (ContrailAttributes)

Uçuşun tamamı için toplanmış yoğunlaşma izi özellikleri. Bu metrik, ilişkilendirilen tüm segmentlerdeki uçak izi özelliklerini toplar.

Durum yorumu (bulunan bir uçuşta):

  • Varsa: Uçak izi analizi yapılmıştır. ContrailAttributes içindeki alanlar sonuçları gösterir (ör. lengthMeters > 0, yoğunlaşma izlerinin ilişkilendirildiği anlamına gelir). Boş bir ContrailAttributes mesajı varsa analiz yapılmış ancak hem lengthMeters hem de enerji zorlama sıfır olarak değerlendirilmiştir.
  • Yoksa: Bu uçuş için yoğunlaşma izi analizi yapılamadı.
    • Bu durum genellikle yetersiz giriş verilerinden (ör. eksik hava durumu verileri veya uçuş rotası belirsizliği) kaynaklanır.
    • Bu, hiç iz oluşmadığı anlamına GELMEZ. Yalnızca bir belirleme yapılamadığı anlamına gelir.
segments[]

object (SegmentAttribution)

Segment başına uçak izi ilişkilendirmeleri. Her giriş, uçuşun, yoğunlaşma izlerinin ilişkilendirildiği farklı bir zaman aralığını temsil eder.

FlightDetails

Yanıt içinde döndürülen tüm uçuş bilgilerini tanımlar.

JSON gösterimi 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
Alanlar
carrier

string

Uçuşun IATA hava yolu kodu (ör. "AA").
flightNumber

integer

Uçuşun uçuş numarası (ör. "123").
departureTime

string

Kalkış havaalanının saat diliminde YYYYAAGG biçimindeki kalkış tarihi.
icao24

string

ICAO 24 bit uçak adresi
originAirport

string

IATA kalkış havaalanı kodu.
destinationAirport

string

IATA varış havaalanı kodu.
callSign

string

Uçağın çağrı işareti. Bu alan, tercihen hava trafik kontrolü (ATC) iletişimlerinde kullanılan telsiz kodunu içerir. Belirli ATC çağrı işareti mevcut değilse veya standart uçuş tanımlayıcısıyla aynıysa bu alanda standart uçuş tanımlayıcısı (genellikle ticari uçuşlar için havayolu kodu ve uçuş numarası kombinasyonu) bulunur.
analyzedFlightDistanceMeters

integer

Analiz edilen uçuşun mesafesi (metre).

ContrailAttributes

Bir uçuş veya uçuş segmentinin yoğunlaşma izi özelliklerini temsil eder.

JSON gösterimi 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
Alanlar
lengthMeters

integer

Uçuş rotasının, yoğunlaşma izlerinin atfedildiği alt kümelerinin metre cinsinden uzunluğu. Bu, uçuş ara noktaları arasındaki büyük daire mesafesi olarak hesaplanır.
effectiveEnergyForcingJoules

string (int64 format)

Toplam etkili yoğunlaşma izi enerji zorlaması (Joule cinsinden). Bu değer, 4 boyutlu ızgaralı CoCiP tahmin çıktılarından etkili radyatif zorlama çıkarılarak ve bunlar doğrusal olarak enterpolasyon yapılarak elde edilir. Bu metodoloji değişebilir.

SegmentAttribution

Bir uçuşun belirli bir zaman segmenti için yoğunlaşma izi ilişkilendirmesini gösterir.

JSON gösterimi 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
Alanlar
startTime

string (Timestamp format)

Yoğunlaşma izlerinin atfedildiği uçuş segmentinin başlangıç zamanı. Bu zaman damgası, UTC sıfır zamanı saniye cinsindendir.
endTime

string (Timestamp format)

Yoğunlaşma izlerinin ilişkilendirildiği uçuş segmentinin bitiş zamanı. Bu zaman damgası, UTC sıfır zamanı saniye cinsindendir.
contrail

object (ContrailAttributes)

Bu segment için Contrail özellikleri.
detectionEvidences[]

object (ContrailDetectionEvidence)

Bu uçuş segmentine atıfta bulunulmasını sağlayan kanıtlar sunan bireysel uydu izi tespitleri.
attributionMethod

enum (AttributionMethod)

Yalnızca çıkış. Yoğunlaşma izlerini bu segmente atamak için kullanılan yöntem (ör. CoCiP modeli veya doğrudan gözlem).
longGapInterpolation

boolean

Yalnızca çıkış. Segment uçuş yolu, uzun bir ADS-B veri boşluğu (>5 dakika) üzerinde enterpolasyon yapılarak oluşturulduysa doğru.
waypointAttributions[]

object (WaypointAttribution)

Yalnızca çıkış. Bu segmentte, her bir ara nokta için yoğunlaşma izi özellikleri eşlenir.

ContrailDetectionEvidence

Bir yoğuşma izinin tek bir uydu gözleminin ayrıntıları.

JSON gösterimi 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
Alanlar
observationTime

string (Timestamp format)

Yoğunlaşma izinin tespit edildiği uydu görüntüsünün çekildiği zaman. Bu genellikle taramanın başlangıç zamanıdır. Bu zaman damgası, UTC sıfır zamanından itibaren saniye cinsindendir.
observedLengthMeters

integer

observationTime ile belirtilen uydu görüntüsünde tespit edildiği üzere, doğrusal yoğunlaşma izi özelliğinin gözlemlenen uçtan uca uzunluğu (metre cinsinden). Bu uzunluk, SegmentAttribution.contrail içindeki lengthMeters değerinden farklı olabilir. Bunun nedeni:

  • Yoğunlaşma izi, oluşum ve gözlem arasında atmosferde değişmiş (ör. yayılmış, uzamış vb.) olabilir.
  • İlişkilendirme algoritması, bu yoğunlaşma izinin yalnızca bir kısmını bu uçuşla güvenle ilişkilendirebildi.
dataSource

enum (DataSource)

Yalnızca çıkış. Bu algılama için kullanılan uydu verilerinin kaynağı.

DataSource

Yoğunlaşma izi algılama için kullanılan uydu verilerinin kaynağı. Gelecekte başka değerler eklenebilir.

Mevcut uydu verisi çıkışları arasında GOES East ve Himawari tabanlı ilişkilendirmeler üretim düzeyinde kaliteye sahipken MTG tabanlı ilişkilendirmeler hâlâ beta aşamasındadır ve kalite iyileştirmeleri aktif olarak yapılmaktadır.

Sıralamalar
DATA_SOURCE_UNSPECIFIED Belirtilmemiş veri kaynağı.
GOES_EAST_FULL_DISK GOES-East tam disk taramalarından elde edilen veriler.
GOES_WEST_FULL_DISK GOES-West tam disk taramalarından elde edilen veriler.
MTG_000_FULL_DISK MTG-000 tam disk taramalarından elde edilen veriler.
HIMAWARI_FULL_DISK Himawari tam disk taramalarından elde edilen veriler.

Contrails API'nin uydu görüntüleri şu kaynaklara dayanır:

WaypointAttribution

Bir uçuş segmentindeki belirli bir rota noktasına ait yoğunlaşma izi özelliklerini temsil eder.

JSON gösterimi 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
Alanlar
time

string (Timestamp format)

UTC sıfır zaman saniyesi cinsinden yol noktasındaki zaman.
contrailAttributes

object (ContrailAttributes)

Bu belirli ara noktada eşlenen iz özellikleri.

AttributionMethod

İlişkilendirme yapmak için kullanılan özel prosedürü veya yöntemi tanımlar.

Sıralamalar
ATTRIBUTION_METHOD_OBSERVATION Kesinlikle uydu yoğunlaşma izi tespitleriyle eşleştirilerek elde edilen ilişkilendirme.
ATTRIBUTION_METHOD_COCIP Tamamen fizik tabanlı CoCiP modellemesine dayalı ilişkilendirmeler.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

Uydu tespitleriyle düzeltilmiş CoCiP modeli tahminlerini birleştiren karma ilişkilendirme.

  • Algılamalarla: detectionEvidences simgesi varsa yoğunlaşma izi tahmin edilmiş ve gözlemle doğrulanmış olup daha fazla ısınma ağırlığı almıştır.
  • Algılama Yok: detectionEvidences eksikse yoğunlaşma izi tahmin edilmiştir ancak gözlemlenmemiştir. Bu nedenle, hesaplanan ısınma oranı düşürülür.
ATTRIBUTION_METHOD_UNSPECIFIED Belirtilmemiş yöntem.

Notlar

Her DataSource, gözleme dayalı görüntülemeleri işlemek için farklı sınırlar kullanır:

Uydu kapsama alanı sınırlayıcı kutuları (düz mercator görünümü)

Lisans

ContrailWatch Attributions API tarafından sunulan veriler CC BY-NC 4.0 kapsamında lisanslanmıştır.