Atribusi

Segmen jejak pesawat yang diatribusikan untuk daftar penerbangan tertentu.

Format data

Permintaan untuk jejak pesawat yang diatribusikan berisi data dengan struktur berikut:

Representasi JSON 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
Kolom
attributions[]

object (Attribution)

Daftar atribusi, satu untuk setiap nama resource yang ditentukan dalam BatchGetAttributionsRequest.names. Urutan atribusi dalam daftar ini akan cocok dengan urutan nama dalam BatchGetAttributionsRequest. Jika penerbangan tidak ditemukan, pesan Atribusi yang sesuai dalam respons hanya akan memiliki kolom name yang diisi, sedangkan flightDetails dan contrail akan kosong.

Atribusi

Mewakili peristiwa jejak kondensasi gabungan untuk penerbangan tertentu yang merangkum semua segmen jejak kondensasi yang diatribusikan (misalnya, total kilometer dan energi).

Representasi JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
Kolom
name

string

ID. Nama resource penerbangan.

Format:

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

Komponen:

  • {carrier}: Kode maskapai IATA 2 karakter (misalnya, "AA", "UA").
  • {flightNumber}: Nomor penerbangan 1-4 digit (misalnya, "123").
  • {departure_date}: Tanggal keberangkatan penerbangan dalam format YYYY-MM-DD.
  • {departure_airport}: Kode bandara IATA 3 huruf (misalnya, "JFK", "LHR").
flightDetails

object (FlightDetails)

Informasi detail untuk penerbangan ini.
contrail

object (ContrailAttributes)

Atribut kontrail gabungan untuk seluruh penerbangan. Tindakan ini menjumlahkan atribut jejak pesawat dari semua segmen yang diatribusikan.

Interpretasi status (dalam penerbangan yang ditemukan):

  • Jika ada: Analisis jejak pesawat telah dilakukan. Kolom di dalam ContrailAttributes menunjukkan hasil (misalnya, lengthMeters > 0 berarti jejak pesawat dikaitkan).
  • Jika tidak ada: Analisis jejak pesawat TIDAK dapat dilakukan untuk penerbangan ini.
    • Hal ini biasanya disebabkan oleh data input yang tidak memadai (misalnya, data cuaca yang tidak ada atau ketidakpastian jalur penerbangan).
    • Hal ini BUKAN berarti tidak ada jejak pesawat yang terbentuk, hanya saja penentuan tidak dapat dilakukan.
segments[]

object (SegmentAttribution)

Atribusi jejak pesawat per segmen. Setiap entri mewakili interval waktu penerbangan yang berbeda yang dikaitkan dengan jejak pesawat.

FlightDetails

Menentukan kumpulan lengkap informasi penerbangan yang ditampilkan dalam respons.

Representasi JSON 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
Kolom
carrier

string

Kode maskapai penerbangan IATA (misalnya, "AA").
flightNumber

integer

Nomor penerbangan (misalnya, "123").
departureTime

string

Tanggal keberangkatan dalam zona waktu bandara asal; int: epoch Unix ATAU str: ISO 8601.
icao24

string

Alamat pesawat 24-bit ICAO
originAirport

string

Kode bandara asal IATA.
destinationAirport

string

Kode IATA bandara tujuan.
callSign

string

Tanda panggilan pesawat. Kolom ini lebih memilih untuk berisi tanda panggilan yang digunakan dalam komunikasi Pengontrol Lalu Lintas Udara (ATC). Jika tanda panggilan ATC tertentu tidak tersedia atau sama dengan penanda penerbangan standar, kolom ini akan berisi penanda penerbangan standar (biasanya kombinasi kode maskapai dan nomor penerbangan untuk penerbangan komersial).
analyzedFlightDistanceMeters

integer

Jarak penerbangan yang dianalisis, dalam meter.

ContrailAttributes

Mewakili atribut jejak kondensasi untuk penerbangan atau segmen penerbangan.

Representasi JSON 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
Kolom
lengthMeters

integer

Panjang, dalam meter, subset jalur penerbangan yang menjadi penyebab jejak pesawat. Jarak ini dihitung sebagai jarak lingkaran besar antara titik jalan penerbangan.
effectiveEnergyForcingJoules

string (int64 format)

Total gaya energi jejak pesawat yang efektif, dalam joule. Saat ini, nilai ini dihitung berdasarkan rata-rata klimatologi dan dapat berubah sewaktu-waktu.

SegmentAttribution

Merepresentasikan atribusi jejak kondensasi untuk segmen waktu tertentu dari penerbangan.

Representasi JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
Kolom
startTime

string (Timestamp format)

Waktu mulai segmen penerbangan yang menjadi penyebab jejak pesawat. Stempel waktu ini dalam detik epoch UTC.
endTime

string (Timestamp format)

Waktu berakhir segmen penerbangan yang menjadi atribusi jejak pesawat. Stempel waktu ini dalam detik epoch UTC.
contrail

object (ContrailAttributes)

Atribut Contrail untuk segmen tertentu ini.
detectionEvidences[]

object (ContrailDetectionEvidence)

Deteksi jejak pesawat individual yang memberikan bukti atribusi ke segmen penerbangan ini.

ContrailDetectionEvidence

Detail pengamatan tunggal satelit terhadap jejak pesawat.

Representasi JSON 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
Kolom
observationTime

string (Timestamp format)

Waktu saat gambar satelit diambil yang di dalamnya terdapat jejak pesawat. Ini biasanya adalah waktu mulai pemindaian. Stempel waktu ini dalam detik epoch UTC.
observedLengthMeters

integer

Panjang end-to-end fitur jejak pesawat linear yang diamati dalam meter, seperti yang terdeteksi dalam gambar satelit yang ditentukan oleh observationTime. Panjang ini dapat berbeda dari lengthMeters di SegmentAttribution.contrail karena:

  • Contrail mungkin telah berubah (misalnya, menyebar, memanjang, dll.) di atmosfer antara pembentukan dan pengamatan.
  • Algoritma atribusi hanya dapat mengatribusikan sebagian jejak kondensasi ini ke penerbangan ini dengan yakin.
dataSource

enum (DataSource)

Hanya output. Sumber data satelit yang digunakan untuk deteksi ini.

DataSource

Sumber data satelit yang digunakan untuk deteksi jejak pesawat. Nilai tambahan dapat ditambahkan di masa mendatang.

Saat ini, GOES East dan MTG adalah output data satelit yang tersedia. Atribusi berbasis GOES East memiliki kualitas tingkat produksi, sedangkan atribusi berbasis MTG masih dalam fase Beta dan secara aktif menjalani peningkatan kualitas.

Enum
DATA_SOURCE_UNSPECIFIED Sumber data tidak ditentukan.
GOES_EAST_FULL_DISK Data dari pemindaian cakupan penuh GOES-East.
GOES_WEST_FULL_DISK Data dari pemindaian disk penuh GOES-West.
MTG_000_FULL_DISK Data dari pemindaian disk penuh MTG-000.
HIMAWARI_FULL_DISK Data dari pemindaian cakupan penuh Himawari.