Method: batchGetAttributions

Mendapatkan beberapa atribusi kontrail berdasarkan informasi penerbangan.

Jika berhasil, responsnya akan berupa daftar atribusi jejak pesawat.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Resource induk yang dibagikan oleh semua atribusi yang diambil. Format: atribusi

Parameter kueri

Parameter
names[]

string

Wajib. Nama resource penerbangan yang akan diambil. Maksimum 100 nama dapat diberikan dalam satu permintaan.

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").

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons yang berisi jejak pesawat yang diatribusikan untuk attributions.batchGet.

Jika berhasil, isi respons memuat 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 di zona waktu bandara asal int: epoch Unix; 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 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 pesawat. Ini dihitung sebagai jarak lingkaran besar antara titik jalan penerbangan.
effectiveEnergyForcingJoules

string (int64 format)

Total gaya radiasi efektif energi jejak pesawat, dalam joule. Saat ini, nilai ini dihitung berdasarkan rata-rata klimatologi dan 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)
    }
  ]
}
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 kondensasi. Stempel waktu ini dalam detik epoch UTC.
contrail

object (ContrailAttributes)

Atribut kontraksi 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 terdeteksi 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.

Enum
DATA_SOURCE_UNSPECIFIED Sumber data 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 cakupan penuh Himawari.