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 içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

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 uçak izi segmentlerini (ör. toplam kilometre ve enerji) özetleyen toplu bir uçak izi etkinliğini temsil eder.

JSON gösterimi 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  }
}
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şla ilgili atfedilen yoğunlaşma izleri hakkında ayrıntılar.

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

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": string
}
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çuş noktasıyla ilişkili uçağın çağrı işareti.
analyzedFlightDistanceMeters

string (int64 format)

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

ContrailAttributes

Bir uçuşun yoğunlaşma izi özelliklerini gösterir.

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

string (int64 format)

Yoğunlaşma izi oluşumunun tahmini uzunluğu (metre).
effectiveEnergyForcingJoules

string (int64 format)

Bu uçuşa atfedilen toplam etkili enerji zorlaması (Joule cinsinden).