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 penerbangan 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)
  }
}
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 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)

Detail tentang kontrail yang diatribusikan untuk penerbangan.

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.

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": string
}
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 bandara tujuan IATA.
callSign

string

Tanda panggilan pesawat yang terkait dengan titik jalan.
analyzedFlightDistanceMeters

string (int64 format)

Jarak penerbangan yang dianalisis, dalam meter.

ContrailAttributes

Mewakili atribut jejak kondensasi untuk penerbangan.

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

string (int64 format)

Perkiraan panjang pembentukan jejak kondensasi, dalam meter.
effectiveEnergyForcingJoules

string (int64 format)

Total gaya energi efektif yang disebabkan oleh penerbangan ini, dalam joule.