Method: flights.computeFlightEmissions

Metode tanpa status untuk mengambil estimasi emisi. Detail tentang cara penghitungan estimasi emisi ada di GitHub

Respons akan berisi semua entri yang cocok dengan segmen penerbangan input, dalam urutan yang sama. Jika tidak ada estimasi yang tersedia untuk segmen penerbangan tertentu, respons akan menampilkan objek segmen penerbangan dengan kolom emisi yang kosong. Permintaan akan tetap dianggap berhasil. Alasan estimasi emisi tidak ada meliputi:

  • Penerbangan tidak diketahui oleh server.
  • Segmen penerbangan input tidak memiliki satu atau beberapa ID.
  • Tanggal penerbangan sudah lewat.
  • Jenis pesawat tidak didukung oleh model.
  • Konfigurasi tempat duduk tidak ada.

Permintaan dapat berisi hingga 1.000 segmen penerbangan. Jika permintaan memiliki lebih dari 1.000 penerbangan langsung, permintaan akan gagal dengan error INVALID_ARGUMENT.

Permintaan HTTP

POST https://travelimpactmodel.googleapis.com/v1/flights:computeFlightEmissions

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
Kolom
flights[]

object (Flight)

Wajib. Penerbangan langsung untuk mengembalikan perkiraan emisi.

Isi respons

Definisi output untuk respons flights.computeFlightEmissions.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "flightEmissions": [
    {
      object (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Kolom
flightEmissions[]

object (FlightWithEmissions)

Daftar segmen penerbangan dengan perkiraan emisi.
modelVersion

object (ModelVersion)

Versi model yang digunakan untuk menghitung perkiraan emisi untuk semua penerbangan dalam respons ini.

Penerbangan

Semua detail terkait satu item permintaan untuk perkiraan emisi penerbangan langsung.

Representasi JSON 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
Kolom
origin

string

Wajib. Kode bandara IATA untuk asal penerbangan, misalnya "LHR".
destination

string

Wajib. Kode bandara IATA untuk tujuan penerbangan, misalnya "JFK".
operatingCarrierCode

string

Wajib. Kode maskapai IATA, misalnya "AA".
flightNumber

integer

Wajib. Nomor penerbangan, misalnya 324.
departureDate

object (Date)

Wajib. Tanggal penerbangan dalam zona waktu bandara asal. Harus berupa tanggal saat ini atau di masa mendatang.

Tanggal

Menunjukkan seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal ini terkait dengan Kalender Gregorian. Hal ini dapat mewakili salah satu dari berikut ini:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Representasi JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.
month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.
day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

FlightWithEmissions

Penerbangan langsung dengan perkiraan emisi.

Representasi JSON 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
Kolom
flight

object (Flight)

Wajib. Mencocokkan ID penerbangan dalam permintaan. Catatan: semua kode IATA menggunakan huruf kapital.
source

enum (Source)

Opsional. Sumber data emisi.
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Opsional. Angka estimasi emisi per penumpang. Tidak akan ada jika emisi tidak dapat dihitung. Untuk mengetahui daftar alasan mengapa emisi tidak dapat dihitung, lihat flights.computeFlightEmissions.
easaLabelMetadata

object (EasaLabelMetadata)

Opsional. Metadata tentang Label Emisi Penerbangan EASA. Hanya disetel jika sumber data emisi adalah EASA.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Opsional. Signifikansi dampak pemanasan kontrail dibandingkan dengan total dampak emisi CO2e.

Sumber

Sumber data emisi.

Enum
SOURCE_UNSPECIFIED Sumber data emisi tidak ditentukan.
TIM Data emisi berasal dari Model Dampak Perjalanan.
EASA Data emisi berasal dari label lingkungan EASA.

EasaLabelMetadata

Metadata tentang Label Emisi Penerbangan EASA.

Representasi JSON 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
Kolom
labelIssueDate

object (Date)

Tanggal saat label dikeluarkan.
labelExpiryDate

object (Date)

Tanggal saat label berakhir. Label dapat ditampilkan hingga akhir tanggal ini.
labelVersion

string

Versi label.
safDiscountPercentage

number

Persentase diskon emisi Bahan Bakar Penerbangan Ramah Lingkungan (SAF) yang diterapkan pada label. Ini adalah persentase dalam bentuk desimal. Nilainya berada dalam interval [0,1]. Misalnya, 0,0021 berarti 0,21%.

Diskon dan pengurangan emisi ini dilaporkan oleh label EASA, tetapi tidak disertakan dalam perkiraan CO2e yang didistribusikan oleh API ini.

ContrailsImpactBucket

Signifikansi dampak pemanasan kontrail dibandingkan dengan total dampak emisi CO2e.

Enum
CONTRAILS_IMPACT_UNSPECIFIED Dampak jejak pesawat tidak ditentukan.
CONTRAILS_IMPACT_NEGLIGIBLE Dampak jejak kondensasi tidak signifikan dibandingkan dengan total emisi CO2e.
CONTRAILS_IMPACT_MODERATE Dampak jejak kontrail sebanding dengan total emisi CO2e.
CONTRAILS_IMPACT_SEVERE Dampak kontrail lebih tinggi daripada total dampak emisi CO2e.