Atribusi

Segmen jejak kondensasi yang diatribusikan untuk daftar penerbangan tertentu.

Format data

Permintaan untuk contrail 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 di BatchGetAttributionsRequest. Jika penerbangan tidak ditemukan, pesan Atribusi yang sesuai dalam respons hanya akan mengisi kolom name, sedangkan flightDetails dan contrail akan kosong.

Atribusi

Merepresentasikan 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)
    }
  ],
  "visualizationUrl": string
}
Kolom
name

string

ID. Nama resource penerbangan.

Format:

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

Komponen:

  • {carrier}: Kode maskapai penerbangan IATA 2 karakter (misalnya, "AA", "UA").
  • {flightNumber}: nomor penerbangan 1-4 digit (misalnya, "123").
  • {departure_date}: Tanggal keberangkatan penerbangan menurut waktu lokal bandara asal dalam format YYYY-MM-DD (tersedia mulai tahun 2024 dan seterusnya).
  • {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 akan menjumlahkan atribut jejak kondensasi dari semua segmen yang diatribusikan.

Penafsiran status (dalam penerbangan yang ditemukan):

  • Jika ada: Analisis jejak kondensasi telah dilakukan. Kolom di dalam ContrailAttributes menunjukkan hasil (misalnya, lengthMeters > 0 berarti jejak kondensasi diatribusikan). Jika pesan ContrailAttributes kosong muncul, berarti analisis telah dilakukan, tetapi lengthMeters dan pemaksaan energi bernilai nol.
  • Jika tidak ada: Analisis jejak kondensasi 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 TIDAK berarti tidak ada jejak kondensasi yang terbentuk, melainkan hanya bahwa penentuan tidak dapat dilakukan.
segments[]

object (SegmentAttribution)

Atribusi jejak kondensasi per segmen. Setiap entri mewakili interval waktu yang berbeda dari penerbangan yang dikaitkan dengan jejak kondensasi.
visualizationUrl

string

Hanya output. Link ke visualisasi interaktif atribusi jejak kondensasi penerbangan ini di halaman ContrailWatch di ContrailExplorer. Gambar ini menunjukkan jalur penerbangan yang cocok dengan kontrail yang terdeteksi oleh satelit.

Hanya diisi untuk penerbangan yang ditemukan saat menggunakan tampilan ATTRIBUTION_VIEW_OBSERVATION.

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 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 panggil pesawat. Kolom ini sebaiknya berisi tanda panggil yang digunakan dalam komunikasi Air Traffic Control (ATC). Jika tanda panggil ATC tertentu tidak tersedia atau sama dengan penanda penerbangan standar, kolom ini akan berisi penanda penerbangan standar (biasanya kombinasi kode maskapai penerbangan 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 diatribusikan ke jejak kondensasi. Jarak ini dihitung sebagai jarak lingkaran besar antara titik jalan penerbangan.
effectiveEnergyForcingJoules

string (int64 format)

Total pemaksaan energi jejak kondensasi yang efektif, dalam joule. Hal ini diperoleh dengan mengekstrak pemaksaan radiasi efektif dari output perkiraan CoCiP berpetak 4D dan menginterpolasinya secara linear. Metodologi ini 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)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
Kolom
startTime

string (Timestamp format)

Waktu mulai segmen penerbangan yang diatribusikan ke contrail. Stempel waktu ini dalam detik epoch UTC.
endTime

string (Timestamp format)

Waktu berakhir segmen penerbangan yang diatribusikan ke jejak kondensasi. Stempel waktu ini dalam detik epoch UTC.
contrail

object (ContrailAttributes)

Atribut contrail untuk segmen spesifik ini.
detectionEvidences[]

object (ContrailDetectionEvidence)

Deteksi jejak kondensasi satelit individual yang memberikan bukti atribusi ke segmen penerbangan ini.
attributionMethod

enum (AttributionMethod)

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

boolean

Hanya output. True jika jalur penerbangan segmen dibuat dengan interpolasi pada kesenjangan data ADS-B yang panjang (>5 menit).
waypointAttributions[]

object (WaypointAttribution)

Hanya output. Atribut contrail per titik jalan yang dipetakan di seluruh segmen ini.

ContrailDetectionEvidence

Detail pengamatan satelit tunggal terhadap jejak kondensasi.

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

string (Timestamp format)

Waktu pengambilan gambar dari satelit yang mendeteksi jejak kondensasi. Ini biasanya adalah waktu mulai pemindaian. Stempel waktu ini dalam detik epoch UTC.
observedLengthMeters

integer

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

  • Jejak kondensasi mungkin telah berkembang (misalnya, menyebar, memanjang, dll.) di atmosfer antara pembentukan dan pengamatan.
  • Algoritma atribusi hanya dapat mengatribusikan sebagian kontrail 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 kondensasi. Nilai tambahan mungkin akan 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 sedang menjalani peningkatan kualitas secara aktif.

Enum
DATA_SOURCE_UNSPECIFIED Sumber data yang tidak ditentukan.
GOES_EAST_FULL_DISK Data dari pemindaian disk 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

Merepresentasikan atribut jejak kondensasi untuk titik jalan tertentu di 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 kondensasi yang dipetakan di titik jalan tertentu ini.

AttributionMethod

Menentukan prosedur atau metodologi spesifik yang digunakan untuk membuat atribusi.

Enum
ATTRIBUTION_METHOD_OBSERVATION Atribusi yang diperoleh secara ketat dengan mencocokkan deteksi jejak kondensasi satelit.
ATTRIBUTION_METHOD_COCIP Atribusi yang hanya mengandalkan pemodelan CoCiP berbasis fisika.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

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

  • Dengan Deteksi: Jika detectionEvidences ada, jejak kondensasi diprediksi dan dikonfirmasi melalui pengamatan, sehingga menerima bobot pemanasan yang ditingkatkan.
  • Tanpa Deteksi: Jika detectionEvidences tidak ada, jejak kondensasi diprediksi, tetapi tidak diamati, sehingga pemanasan yang dihitung akan 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.