Method: flights.computeScope3FlightEmissions

Mengambil estimasi emisi GHG untuk serangkaian segmen penerbangan untuk pelaporan Cakupan 3.

Respons akan berisi semua entri yang cocok dengan segmen penerbangan Scope3FlightSegment input, dalam urutan yang sama seperti yang diberikan. Estimasi akan dihitung menggunakan logika bertingkat berikut (menggunakan yang pertama tersedia):

  1. Emisi berbasis TIM yang diberikan origin, destination, carrier, flightNumber, departureDate, dan cabinClass.
  2. Emisi penerbangan standar yang diberikan origin, destination, tahun dalam departureDate, dan cabinClass.
  3. Emisi berbasis jarak yang dihitung menggunakan distanceKm, tahun dalam departureDate, dan cabinClass.

Jika ada penerbangan mendatang yang diminta pada tahun kalender ini, kami tidak mendukung emisi Tingkat 1 dan akan kembali ke emisi Tingkat 2 atau 3. Jika penerbangan mendatang yang diminta tidak ada pada tahun kalender ini, kami akan menampilkan respons kosong. Sebaiknya untuk penerbangan mendatang, gunakan computeFlightEmissions API.

Jika tidak ada estimasi yang tersedia untuk penerbangan tertentu dengan salah satu dari tiga metode, respons akan menampilkan objek Scope3FlightEmissions dengan kolom emisi kosong. Permintaan akan tetap dianggap berhasil. Umumnya, estimasi emisi yang tidak ada terjadi saat penerbangan tidak diketahui oleh server (misalnya, tidak ada penerbangan tertentu, atau emisi penerbangan standar tidak tersedia untuk pasangan yang diminta).

Permintaan akan gagal dengan error INVALID_ARGUMENT jika:

  • Permintaan berisi lebih dari 1.000 segmen penerbangan.
  • Segmen penerbangan input tidak memiliki satu atau beberapa ID. Misalnya, tidak ada asal/tujuan tanpa jarak yang valid untuk pencocokan jenis TIM_EMISSIONS atau TYPICAL_FLIGHT_EMISSIONS, atau tidak ada jarak untuk pencocokan jenis DISTANCE_BASED_EMISSIONS (jika Anda ingin kembali ke emisi berbasis jarak atau menginginkan estimasi emisi berbasis jarak, Anda harus menentukan jarak).
  • Tanggal penerbangan sebelum tahun 2019 (data Cakupan 3 hanya tersedia untuk tahun 2019 dan setelahnya).
  • Jarak penerbangan adalah 0 atau lebih rendah.
  • Tidak ada kelas kabin.

Karena permintaan diproses dengan logika penggantian, permintaan yang salah konfigurasi dapat menampilkan estimasi emisi yang valid menggunakan metode penggantian. Misalnya, jika permintaan memiliki nomor penerbangan yang salah, tetapi menentukan asal dan tujuan, permintaan akan tetap berhasil, tetapi emisi yang ditampilkan hanya akan didasarkan pada emisi penerbangan standar. Demikian pula, jika permintaan tidak memiliki asal untuk permintaan emisi penerbangan standar, tetapi menentukan jarak yang valid, permintaan dapat berhasil hanya berdasarkan emisi berbasis jarak. Oleh karena itu, Anda harus memeriksa sumber emisi yang ditampilkan (source) untuk mengonfirmasi bahwa hasilnya sesuai harapan.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "flights": [
    {
      object (Scope3FlightSegment)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Kolom
flights[]

object (Scope3FlightSegment)

Wajib. Penerbangan untuk menampilkan estimasi emisi.
modelVersion

object (ModelVersion)

Opsional. Versi model yang digunakan untuk menghitung estimasi emisi untuk semua penerbangan dalam permintaan ini.

Isi respons

Daftar penerbangan dengan estimasi emisi Cakupan 3.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (Scope3FlightEmissions)

Daftar segmen penerbangan dengan estimasi emisi.
modelVersion

object (ModelVersion)

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

Scope3FlightSegment

Parameter penerbangan yang digunakan untuk mengambil emisi Cakupan 3.

Representasi JSON 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Kolom
departureDate

object (Date)

Wajib. Tanggal penerbangan dalam zona waktu bandara asal. Hanya tahun yang diperlukan untuk model emisi penerbangan standar dan berbasis jarak (nilai bulan dan hari diabaikan dan oleh karena itu, dapat dihilangkan, ditetapkan ke 0, atau ditetapkan ke tanggal yang valid untuk kasus tersebut). Oleh karena itu, jika tanggal tertentu tidak diberikan untuk emisi TIM, kami akan kembali ke emisi penerbangan standar (atau berbasis jarak).
cabinClass

enum (Scope3FlightSegment.CabinClass)

Wajib. Kelas kabin penerbangan.
origin

string

Opsional. Kode bandara IATA 3 karakter untuk asal penerbangan, misalnya YVR. Kode ini digunakan untuk mencocokkan penerbangan tertentu jika diberikan bersama tujuan, maskapai penerbangan, dan nomor penerbangan. Jika tidak ada kecocokan, kami akan mencoba mencocokkan penerbangan dengan penerbangan standar antara bandara asal dan tujuan yang diberikan. Jika tidak, kami akan menggunakan model emisi berbasis jarak jika jarak penerbangan diberikan.
destination

string

Opsional. Kode bandara IATA 3 karakter untuk tujuan penerbangan, misalnya ICN. Kode ini digunakan untuk mencocokkan penerbangan tertentu jika diberikan bersama asal, maskapai penerbangan, dan nomor penerbangan. Jika tidak ada kecocokan, kami akan mencoba mencocokkan penerbangan dengan penerbangan standar antara bandara asal dan tujuan yang diberikan. Jika tidak, kami akan menggunakan model emisi berbasis jarak jika jarak penerbangan diberikan.
carrierCode

string

Opsional. Kode maskapai penerbangan IATA 2 karakter, misalnya KE. Kode ini diperlukan jika pencocokan penerbangan tertentu diinginkan. Jika tidak, kode ini tidak digunakan untuk model emisi penerbangan standar dan berbasis jarak. Kode ini dapat berupa kode maskapai penerbangan yang beroperasi dan pemasaran (yaitu codeshare tercakup).
flightNumber

integer

Opsional. Nomor penerbangan hingga 4 digit, misalnya 71, dari [1, 9999]. Nomor ini pertama-tama digunakan untuk mencocokkan penerbangan tertentu jika nomor penerbangan ditentukan bersama asal, tujuan, dan maskapai penerbangan. Jika nomor penerbangan tidak ditentukan, kami akan mencoba mencocokkan penerbangan dengan penerbangan standar antara bandara asal dan tujuan yang diberikan. Jika gagal dan/atau asal &tujuan tidak diberikan, kami akan menggunakan model emisi berbasis jarak berdasarkan jarak penerbangan yang diberikan.
distanceKm

string (int64 format)

Opsional. Jarak dalam kilometer, misalnya 2423, dari [1, 2,5e16) km. Jarak ini digunakan untuk mencocokkan penerbangan dengan emisi berbasis jarak jika asal dan tujuan tidak diberikan atau tidak ada penerbangan standar yang cocok.

Scope3FlightSegment.CabinClass

Kelas kabin penerbangan.

Enum
CABIN_CLASS_UNSPECIFIED Kelas kabin tidak ditentukan.
ECONOMY Kelas ekonomi.
PREMIUM_ECONOMY Kelas ekonomi premium.
BUSINESS Kelas bisnis.
FIRST Kelas satu.

Scope3FlightEmissions

Penerbangan Cakupan 3 dengan estimasi emisi.

Representasi JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType)
}
Kolom
flight

object (Scope3FlightSegment)

Pengenal. Cocok dengan ID penerbangan dalam permintaan.
wtwEmissionsGramsPerPax

string (int64 format)

Opsional. Total emisi penerbangan (jumlah emisi dari sumur ke tangki dan tangki ke bangun) per penumpang berdasarkan info yang diminta. Ini adalah total emisi dan kecuali jika Anda memiliki alasan khusus untuk menggunakan emisi TTW atau WTT, Anda harus menggunakan angka ini.
ttwEmissionsGramsPerPax

string (int64 format)

Opsional. Emisi penerbangan tangki ke bangun per penumpang berdasarkan info yang diminta.
wttEmissionsGramsPerPax

string (int64 format)

Opsional. Emisi penerbangan sumur ke tangki per penumpang berdasarkan info yang diminta.
source

enum (Scope3FlightEmissions.Scope3DataType)

Opsional. Sumber data emisi.

Scope3FlightEmissions.Scope3DataType

Jenis pencocokan yang digunakan untuk menghitung emisi Cakupan 3. Hal ini digunakan untuk respons Cakupan 3, menandai metode mana yang digunakan untuk menghitung emisi.

Enum
SCOPE3_DATA_TYPE_UNSPECIFIED Jenis data tidak ditentukan.
TIM_EMISSIONS Emisi berbasis TIM yang diberikan asal, tujuan, maskapai penerbangan, nomor penerbangan, tanggal keberangkatan, dan tahun.
TYPICAL_FLIGHT_EMISSIONS Emisi penerbangan standar yang diberikan asal, tujuan, dan tahun.
DISTANCE_BASED_EMISSIONS Emisi berbasis jarak berdasarkan jarak tempuh dan tahun.