Method: flights.computeDetailedFlightEmissions

Mengambil perkiraan emisi mendetail.

Emisi Penerbangan yang Mendetail adalah perkiraan emisi gas rumah kaca per penumpang yang transparan dan dilengkapi dengan metadata komprehensif yang menjelaskan metodologi penghitungan, perincian emisi, dampak kontrail, dan asal data.

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 tidak adanya estimasi emisi 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 100 segmen penerbangan. Jika permintaan memiliki lebih dari 100 segmen penerbangan, permintaan akan gagal dengan error INVALID_ARGUMENT.

Permintaan HTTP

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

URL ini 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 menampilkan perkiraan emisi.

Isi respons

Definisi output untuk respons flights.computeDetailedFlightEmissions.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "flightsWithDetailedEmissions": [
    {
      object (FlightWithDetailedEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Kolom
flightsWithDetailedEmissions[]

object (FlightWithDetailedEmissions)

Daftar segmen penerbangan dengan perkiraan emisi.
modelVersion

object (ModelVersion)

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

FlightWithDetailedEmissions

Penerbangan langsung dengan detail perkiraan emisi.

Representasi JSON 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
Kolom
flight

object (Flight)

Hanya output. Cocok dengan ID penerbangan dalam permintaan. Catatan: semua kode IATA menggunakan huruf kapital.
flightEmissionsDetails

object (FlightEmissionsDetails)

Hanya output. Semua data emisi penerbangan.
emissionsMetadata

object (EmissionsMetadata)

Hanya output. Metadata tambahan tentang perhitungan emisi penerbangan.

FlightEmissionsDetails

Detail tentang emisi penerbangan tertentu.

Representasi JSON 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
Kolom
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Hanya output. Angka perkiraan emisi per penumpang. Tidak akan ada jika emisi tidak dapat dihitung. Untuk mengetahui daftar alasan mengapa emisi tidak dapat dihitung, lihat flights.computeDetailedFlightEmissions
emissionsBreakdown

object (EmissionsBreakdown)

Hanya output. Detail tentang berbagai bagian emisi dari nilai total emisi GramsPerPax. Nilai perincian yang dijumlahkan harus selalu sama dengan emissionsGramsPerPax.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Hanya output. Signifikansi dampak pemanasan kontrail dibandingkan dengan total dampak emisi CO2e.
source

enum (Source)

Hanya output. Sumber data emisi.

EmissionsBreakdown

Detail tentang berbagai bagian emisi dari nilai total emisi GramsPerPax. Nilai perincian yang dijumlahkan harus selalu sama dengan emissionsGramsPerPax.

Representasi JSON 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Kolom
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Angka perkiraan emisi per penumpang dari sumur ke tangki. Tidak akan ada jika emisi tidak dapat dihitung. Untuk mengetahui daftar alasan mengapa emisi tidak dapat dihitung, lihat flights.computeFlightEmissions.
ttwEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Angka perkiraan emisi dari tangki ke bangun per penumpang. Tidak akan ada jika emisi tidak dapat dihitung. Untuk mengetahui daftar alasan mengapa emisi tidak dapat dihitung, lihat flights.computeFlightEmissions.

EmissionsMetadata

Semua metadata tambahan.

Representasi JSON 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
Kolom
emissionsProvenance

object (EmissionsProvenance)

Hanya output. Detail tentang asal data yang digunakan untuk menghitung data emisi, termasuk faktor-faktor yang berkontribusi dengan sumber datanya.
easaLabelMetadata

object (EasaLabelMetadata)

Hanya output. Metadata tentang Label Emisi Penerbangan EASA. Hanya disetel jika sumber data emisi adalah EASA.
timWebsiteEmissionsCalculatorUrl

string

Hanya output. Link ke situs Kalkulator Emisi travelimpactmodel.org. Contoh: https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225.

EmissionsProvenance

Informasi tentang asal data yang digunakan untuk menghitung perkiraan emisi, termasuk faktor-faktor yang berkontribusi dan sumber datanya.

Representasi JSON 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
Kolom
provenanceEntries[]

object (EmissionsProvenance.EmissionsProvenanceEntry)

Hanya output. Semua faktor kontribusi yang digunakan untuk menghitung emisi.

EmissionsProvenance.EmissionsProvenanceEntry

Detail tentang satu faktor kontribusi dalam penghitungan emisi.

Representasi JSON 
{
  "provenanceEntryType": enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType),
  "source": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource),
  "sourceVersion": string,
  "dataCategory": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory),

  // Union field data_strategy can be only one of the following:
  "fuelBurnEeaStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy),
  "loadFactorsT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy),
  "loadFactorsChAviationStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy),
  "cargoMassFractionT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy),
  "seatAreaRatioIataStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy),
  "distanceAdjustmentStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)
  // End of list of possible types for union field data_strategy.

  // Union field data_value can be only one of the following:
  "loadFactorsData": number,
  "cargoMassFractionData": number,
  "seatAreaRatioData": {
    object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)
  },
  "estimatedFlightDistanceKm": integer
  // End of list of possible types for union field data_value.
}
Kolom
provenanceEntryType

enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType)

Hanya output. Jenis entri asal-usul.
source

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource)

Hanya output. Sumber data.
sourceVersion

string

Hanya output. Versi data sumber. Misalnya, "2025/04".
dataCategory

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory)

Hanya output. Kategori data sumber data.
Kolom union data_strategy. Strategi yang digunakan untuk menghitung emisi untuk sumber data tertentu. Kumpulan kolom akan sesuai dengan jenis data_source. data_strategy hanya dapat berupa salah satu dari berikut:
fuelBurnEeaStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy)

Hanya output. Strategi untuk pembakaran bahan bakar EEA.
loadFactorsT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy)

Hanya output. Strategi untuk faktor beban T100.
loadFactorsChAviationStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy)

Hanya output. Strategi untuk faktor muatan CH Aviation.
cargoMassFractionT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy)

Hanya output. Strategi untuk fraksi massa kargo T100.
seatAreaRatioIataStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy)

Hanya output. Strategi untuk rasio area tempat duduk IATA.
distanceAdjustmentStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)

Hanya output. Strategi untuk penyesuaian jarak.
Kolom union data_value. Nilai data untuk sumber data tertentu. Kumpulan kolom akan sesuai dengan provenance_entry_type. data_value hanya dapat berupa salah satu dari berikut:
loadFactorsData

number

Hanya output. Nilai data faktor pemuatan. Jika tidak disetel, nilai faktor pemuatan tidak tersedia.
cargoMassFractionData

number

Hanya output. Nilai fraksi massa kargo. Jika tidak disetel, nilai fraksi massa kargo tidak tersedia.
seatAreaRatioData

object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)

Hanya output. Nilai rasio area kursi untuk setiap kelas tempat duduk. Jika tidak ditetapkan, nilai rasio area tempat duduk tidak tersedia.
estimatedFlightDistanceKm

integer

Hanya output. Perkiraan jarak yang ditempuh dalam fase penerbangan CCD dalam nilai kilometer yang dihitung menggunakan faktor penyesuaian jarak (DAF). Jika tidak ditetapkan, nilai perkiraan jarak penerbangan tidak tersedia.

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

Jenis entri asal-usul. Nilai baru dapat ditambahkan di masa mendatang. Klien harus siap menangani nilai enum yang tidak diketahui dengan baik.

Enum
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED Jenis entri asal tidak ditentukan.
FUEL_BURN Jenis entri pembakaran bahan bakar.
LOAD_FACTORS Jenis entri faktor pemuatan.
CARGO_MASS_FRACTION Jenis entri fraksi massa kargo.
SEATING_CONFIG Jenis entri konfigurasi tempat duduk.
SEAT_AREA_RATIOS Jenis entri rasio area tempat duduk.
DISTANCE_ADJUSTMENT Jenis entri penyesuaian jarak.

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

Sumber data untuk faktor provenance emisi. Nilai baru dapat ditambahkan di masa mendatang. Klien harus siap menangani nilai enum yang tidak diketahui dengan baik.

Enum
DATA_SOURCE_UNSPECIFIED Sumber data tidak ditentukan.
EEA Data yang disediakan oleh European Environment Agency (EEA).
T100 Data dari set data T-100, yang disediakan oleh Biro Statistik Transportasi AS.
CH_AVIATION Data disediakan oleh ch-aviation.
OAG Data yang disediakan oleh Official Aviation Guide (OAG).
OPERATING_CARRIER Data yang disediakan oleh operator yang beroperasi.
AIRCRAFT_MODEL_TYPICAL Data umum berdasarkan model pesawat.
GLOBAL_DEFAULT Nilai default global, digunakan jika tidak ada sumber data lain yang tersedia.
IATA Data disediakan oleh International Air Transport Association (IATA).
ICL Data disediakan oleh Imperial College London.

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

Strategi untuk pembakaran bahan bakar EEA. Nilai baru dapat ditambahkan di masa mendatang. Klien harus siap menangani nilai enum yang tidak diketahui dengan baik.

Enum
STRATEGY_UNSPECIFIED Strategi tidak ditentukan.
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR Faktor koreksi statis diterapkan.
AIRCRAFT_MAPPING_EXACT Pemetaan pesawat yang tepat digunakan.
AIRCRAFT_MAPPING_FALLBACK Pemetaan pesawat pengganti digunakan.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

Strategi untuk faktor beban T100. Nilai baru dapat ditambahkan di masa mendatang. Klien harus siap menangani nilai enum yang tidak diketahui dengan baik.

Enum
STRATEGY_UNSPECIFIED Strategi tidak ditentukan.
CARRIER_ROUTE_MONTH Data menurut operator, rute, dan bulan perjalanan.
CARRIER_MONTH Data menurut maskapai dan bulan perjalanan.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH Data historis yang cocok dengan ekspedisi, rute, tahun, dan bulan.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

Strategi untuk faktor muatan CH-Aviation. Nilai baru dapat ditambahkan di masa mendatang. Klien harus siap menangani nilai enum yang tidak diketahui dengan baik.

Enum
STRATEGY_UNSPECIFIED Strategi tidak ditentukan.
CARRIER_MONTH Data menurut maskapai dan bulan perjalanan.
ACTUAL_CARRIER_YEAR_MONTH Data historis yang cocok dengan ekspedisi, tahun, dan bulan.

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

Strategi untuk fraksi massa kargo T100. Nilai baru dapat ditambahkan di masa mendatang. Klien harus siap menangani nilai enum yang tidak diketahui dengan baik.

Enum
STRATEGY_UNSPECIFIED Strategi tidak ditentukan.
CARRIER_ROUTE_AIRCRAFT_CLASS Data menurut ekspedisi, rute, dan kelas pesawat.
ROUTE_AIRCRAFT_CLASS Data menurut rute dan kelas pesawat.
DISTANCE_AIRCRAFT_CLASS Data menurut rentang jarak dan kelas pesawat.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS Data historis yang cocok dengan maskapai, rute, tahun, bulan, dan kelas pesawat.

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

Strategi untuk rasio area tempat duduk IATA. Nilai baru dapat ditambahkan di masa mendatang. Klien harus siap menangani nilai enum yang tidak diketahui dengan baik.

Enum
STRATEGY_UNSPECIFIED Strategi tidak ditentukan.
NARROW_AIRCRAFT_BODY Rasio area tempat duduk untuk pesawat berbadan sempit digunakan.
WIDE_AIRCRAFT_BODY Rasio area kursi untuk pesawat berbadan lebar digunakan.

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

Strategi untuk penyesuaian jarak. Nilai baru dapat ditambahkan di masa mendatang. Klien harus siap menangani nilai enum yang tidak diketahui dengan baik.

Enum
STRATEGY_UNSPECIFIED Strategi tidak ditentukan.
ORIGIN_DESTINATION Faktor penyesuaian jarak ditentukan oleh pasangan bandara asal dan tujuan.
COUNTRY_PAIR Faktor penyesuaian jarak yang ditentukan oleh pasangan negara asal dan tujuan.
DEFAULT Faktor penyesuaian jarak didasarkan pada nilai default karena kami tidak menemukan faktor penyesuaian spesifik per bandara atau negara.

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

Kategori data sumber data. Nilai baru dapat ditambahkan di masa mendatang. Klien harus siap menangani nilai enum yang tidak diketahui dengan baik.

Enum
DATA_CATEGORY_UNSPECIFIED Kategori data tidak ditentukan.
PRIMARY Data primer, sebagaimana didefinisikan dalam ISO 14083.
MODELED Data yang dimodelkan, sebagaimana ditentukan dalam ISO 14083.
DEFAULT Data nilai default, sebagaimana ditentukan dalam ISO 14083.