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 menurut waktu setempat bandara asal 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. Hal 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 ada pesan ContrailAttributes kosong, artinya analisis telah dilakukan, tetapi lengthMeters dan pemaksaan energi bernilai nol.
  • 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 menjadi penyebab terbentuknya jejak kondensasi.

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 IATA penerbangan (misalnya, "AA").
flightNumber

integer

Nomor penerbangan (misalnya, "123").
departureTime

string

Tanggal keberangkatan di zona waktu bandara asal dalam format YYYYMMDD.
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 Pengatur 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 kondensasi. Ini dihitung sebagai jarak lingkaran besar antara titik jalan penerbangan.
effectiveEnergyForcingJoules

string (int64 format)

Total gaya energi jejak pesawat yang efektif, dalam joule. Nilai ini diperoleh dengan mengekstrak gaya radiatif efektif dari output perkiraan CoCiP bergrid 4D dan menginterpolasikannya secara linear. Metodologi ini dapat berubah sewaktu-waktu.

SegmentAttribution

Mewakili atribusi jejak kondensasi untuk segmen waktu tertentu dari penerbangan.

Representasi JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
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.
attributionMethod

enum (AttributionMethod)

Hanya output. Metode yang digunakan untuk mengatribusikan jejak pesawat ke segmen ini (misalnya, model CoCiP atau pengamatan langsung).
longGapInterpolation

boolean

Hanya output. Benar jika jalur penerbangan segmen dihasilkan dengan menginterpolasi kesenjangan data ADS-B yang panjang (>5 menit).
waypointAttributions[]

object (WaypointAttribution)

Hanya output. Atribut jejak pesawat per titik jalan yang dipetakan di seluruh segmen 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 terdeteksi jejak pesawat. Ini biasanya adalah waktu mulai pemindaian. Stempel waktu ini dalam detik epoch UTC.
observedLengthMeters

integer

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

  • Jejak pesawat 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.

Di antara output data satelit yang tersedia, atribusi berbasis GOES East dan Himawari 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 disk penuh Himawari.

Citra satelit Contrails API didasarkan pada:

WaypointAttribution

Mewakili atribut jejak kondensasi untuk titik jalan tertentu dalam segmen penerbangan.

Representasi JSON 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
Kolom
time

string (Timestamp format)

Waktu di titik jalan dalam detik epoch UTC.
contrailAttributes

object (ContrailAttributes)

Atribut jejak pesawat yang dipetakan di titik jalan tertentu ini.

AttributionMethod

Menentukan prosedur atau metodologi spesifik yang digunakan untuk melakukan atribusi.

Enum
ATTRIBUTION_METHOD_OBSERVATION Atribusi yang diperoleh secara ketat dengan mencocokkan deteksi jejak pesawat terhadap deteksi jejak pesawat satelit.
ATTRIBUTION_METHOD_COCIP Atribusi yang mengandalkan pemodelan CoCiP yang sepenuhnya didorong oleh fisika.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

Atribusi hybrid yang menggabungkan perkiraan model CoCiP yang disesuaikan dengan deteksi satelit.

  • Dengan Deteksi: Jika detectionEvidences ada, jejak pesawat diprediksi dan dikonfirmasi oleh pengamatan, sehingga menerima bobot pemanasan yang lebih tinggi.
  • Tanpa Deteksi: Jika detectionEvidences tidak ada, jejak pesawat diprediksi tetapi tidak diamati, sehingga pemanasan yang dihitung didiskon.
ATTRIBUTION_METHOD_UNSPECIFIED Metode tidak ditentukan.

Catatan

Setiap DataSource menggunakan batas yang berbeda untuk memproses tampilan berbasis pengamatan:

Kotak pembatas cakupan satelit (tampilan mercator datar)

Lisensi

Data yang diekspos oleh ContrailWatch Attributions API dilisensikan berdasarkan CC BY-NC 4.0.