İlişkilendirmeler

Belirli bir uçuş listesi için atfedilen yoğuş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 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 toplu 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 uçuş kalkış tarihi.
  • {departure_airport}: 3 harfli IATA havaalanı kodu (ör. "JFK", "LHR").
flightDetails

object (FlightDetails)

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

object (ContrailAttributes)

Uçuşun tamamı için yoğunlaşma izi özelliklerinin toplu görünümü. Bu, ilişkilendirilen tüm segmentlerdeki uçak izi özelliklerini toplar.

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

  • Varsa: Contrail analizi yapılmıştır. ContrailAttributes içindeki alanlar sonuçları gösterir (ör. lengthMeters > 0, uçak izlerinin atfedildiği anlamına gelir).
  • 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ç yoğunlaşma izi 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 dilimindeki kalkış tarihi; int: Unix dönemi VEYA str: ISO 8601.
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 hava yolu kodu ve uçuş numarası kombinasyonu) bulunur.
analyzedFlightDistanceMeters

integer

Analiz edilen uçuş mesafesi (metre).

ContrailAttributes

Bir uçuş veya uçuş segmenti için 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 şu anda klimatolojik ortalamalara göre hesaplanmaktadır ve değişebilir.

SegmentAttribution

Bir uçuşun belirli bir zaman segmenti için yoğunlaşma izi katkısını gösterir.

JSON gösterimi 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
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 saniyesi biçimindedir.
endTime

string (Timestamp format)

Yoğunlaşma izlerinin ilişkilendirildiği uçuş segmentinin bitiş zamanı. Bu zaman damgası, UTC sıfır zaman saniyesi biçimindedir.
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 yoğunlaşma izi tespitleri.

ContrailDetectionEvidence

Bir yoğuşma izinin tek bir uydu gözlemine ait 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 saniyesi biçimindedir.
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.

Şu anda GOES East ve MTG, kullanılabilen uydu verisi çıkışlarıdır. GOES East 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.