Method: batchGetAttributions

Uçuş bilgileriyle birden fazla yoğunlaşma izi ilişkilendirmesi alır.

İşlem başarılı olursa yanıt, uçak izi ilişkilendirmelerinin listesi olur.

HTTP isteği

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. Alınan tüm ilişkilendirmeler tarafından paylaşılan üst kaynak. Biçim: ilişkilendirmeler

Sorgu parametreleri

Parametreler
names[]

string

Zorunlu. Alınacak uçuşların kaynak adları. Tek bir istekte en fazla 100 ad sağlanabilir.

Biçim:

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

Bileşenler:

  • {carrier}: 2 karakterlik 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 havalimanı kodu (ör. "JFK", "LHR").

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

attributions.batchGet için ilişkilendirilmiş uçak izlerini içeren yanıt.

Başarılı olursa yanıt metni 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, ilişkilendirilmiş tüm 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 karakterlik 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 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 toplanan yoğunlaşma izi özellikleri. 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 ilişkilendirildiğ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, 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 atfedildiği farklı bir zaman aralığını temsil eder.

FlightDetails

Yanıtta 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 epoch; 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 çağrı işaretini 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şun mesafesi (metre cinsinden).

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ı 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.

ContrailDetectionEvidence

Bir yoğuşma izinin tek bir uydu gözlemiyle ilgili 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.

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.