İlişkilendirmeler

Belirli bir uçuş listesi için ilişkilendirilmiş yoğunlaşma izi segmentleri.

Veri biçimi

İlişkilendirilmiş yoğunlaşma 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 ilişkilendirme listesi. Bu listedeki ilişkilendirmelerin sırası, BatchGetAttributionsRequest içindeki adların sırasıyla eşleşir. Uçuş bulunamazsa yanıttaki ilgili ilişkilendirme mesajında yalnızca name alanı doldurulur, flightDetails ve contrail alanları boş bırakılır.

İlişkilendirme

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

JSON gösterimi 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ],
  "visualizationUrl": string
}
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 hava yolu kodu (ör. "AA", "UA").
  • {flightNumber}: 1-4 haneli uçuş numarası (ör. "123").
  • {departure_date}: Kalkış havalimanının yerel saatine göre YYYY-MM-DD biçiminde uçuş kalkış tarihi (2024'ten itibaren kullanılabilir).
  • {departure_airport}: 3 harfli IATA havaalanı kodu (ör. "JFK", "LHR").
flightDetails

object (FlightDetails)

Bu uçuşla ilgili ayrıntılı bilgiler.
contrail

object (ContrailAttributes)

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

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

  • Mevcutsa: Yoğunlaşma izi analizi yapıldı. 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 zorlaması sıfır olarak değerlendirilmiş demektir.
  • Yoksa: Bu uçuş için yoğunlaşma izi analizi YAPILAMADI.
    • Bu durum genellikle yetersiz giriş verilerinden (ör. eksik hava durumu verileri veya uçuş rotası belirsizliği) kaynaklanır.
    • Bu, yoğunlaşma izi oluşmadığı anlamına GELMEZ. Yalnızca tespit yapılamadığı anlamına gelir.
segments[]

object (SegmentAttribution)

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

string

Yalnızca çıkış. ContrailExplorer'ın ContrailWatch sayfasında bu uçuşun yoğunlaşma izi ilişkilendirmesinin etkileşimli görselleştirmesinin bağlantısı. Uydular tarafından algılanan yoğunlaşma izleriyle eşleşen uçuş rotasını gösterir.

Yalnızca ATTRIBUTION_VIEW_OBSERVATION görünümü kullanılırken bulunan uçuşlar için doldurulur.

FlightDetails

Yanıtta döndürülen uçuş bilgilerinin tamamını 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 YYYYMMDD biçiminde kalkış tarihi.
icao24

string

ICAO 24 bit hava aracı adresi
originAirport

string

Kalkış havaalanının IATA kodu.
destinationAirport

string

Varış havaalanının IATA kodu.
callSign

string

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

integer

Analiz edilen uçuşun metre cinsinden mesafesi.

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ş yolunun, yoğunlaşma izlerinin atfedildiği alt kümelerinin metre cinsinden uzunluğu. Bu değer, uçuş noktaları arasındaki ortodromik mesafe olarak hesaplanır.
effectiveEnergyForcingJoules

string (int64 format)

Toplam etkili yoğunlaşma izi enerji zorlaması (jul cinsinden). Bu değer, 4D ızgaralı CoCiP tahmin çıktılarından etkili radyatif zorlamanın çıkarılması ve doğrusal olarak enterpolasyon yapılmasıyla elde edilir. Bu metodoloji değişebilir.

SegmentAttribution

Bir uçuşun belirli bir zaman segmenti için yoğunlaşma izi ilişkilendirmesini temsil eder.

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 ilişkilendirildiği uçuş segmentinin başlangıç zamanı. Bu zaman damgası, UTC sıfır 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 saniye cinsindendir.
contrail

object (ContrailAttributes)

Bu segment için yoğunlaşma izi özellikleri.
detectionEvidences[]

object (ContrailDetectionEvidence)

Bu uçuş segmentiyle ilişkilendirmeyi destekleyen kanıtlar sunan, uydudan tespit edilen bireysel yoğunlaşma izleri.
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ş rotası, uzun bir ADS-B veri boşluğu (>5 dakika) üzerinden interpolasyon yapılarak oluşturulduysa True (Doğru) değerini alır.
waypointAttributions[]

object (WaypointAttribution)

Yalnızca çıkış. Bu segmentte eşlenen, yol noktası başına yoğunlaşma izi özellikleri.

ContrailDetectionEvidence

Yoğunlaş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 algılandığı 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 saniye cinsindendir.
observedLengthMeters

integer

observationTime ile belirtilen uydu görüntüsünde algılanan doğrusal yoğunlaşma izi özelliğinin metre cinsinden gözlemlenen uçtan uca uzunluğu. 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 geliş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 tespiti için kullanılan uydu verilerinin kaynağı. Gelecekte başka değerler eklenebilir.

Mevcut uydu verisi çıkışları arasında GOES Doğu ve Himawari tabanlı ilişkilendirmeler üretim düzeyinde kaliteye sahipken MTG tabanlı ilişkilendirmeler hâlâ beta aşamasındadır ve aktif olarak kalite iyileştirmeleri 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 uydu görüntüleri şunları temel alır:

WaypointAttribution

Uçuş segmentindeki belirli bir ara nokta için yoğunlaşma izi özelliklerini temsil eder.

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

string (Timestamp format)

Ara noktadaki zaman (UTC sıfır saniye cinsinden).
contrailAttributes

object (ContrailAttributes)

Bu belirli ara noktada eşlenen yoğunlaşma izi özellikleri.

AttributionMethod

İlişkilendirme için kullanılan belirli prosedürü veya metodolojiyi tanımlar.

Sıralamalar
ATTRIBUTION_METHOD_OBSERVATION İlişkilendirme, yalnızca uydu yoğunlaşma izi algılamalarıyla eşleştirilerek elde edilir.
ATTRIBUTION_METHOD_COCIP İlişkilendirmeler tamamen fizik tabanlı CoCiP modellemeye dayanır.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

Uydu algılamalarına göre ayarlanmış CoCiP model öngörme düzenlemesini birleştiren karma ilişkilendirme.

  • Tespit edilenler: detectionEvidences varsa yoğunlaşma izi tahmin edilmiş ve gözlemle doğrulanmıştır. Bu durumda, gelişmiş ısınma ağırlığı alır.
  • Algılama yok: detectionEvidences eksikse yoğunlaşma izi tahmin edilmiş ancak gözlemlenmemiştir. Bu nedenle, hesaplanan ısınma dikkate alınmaz.
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.