Method: flights.computeDetailedFlightEmissions

Ayrıntılı emisyon tahminlerini alır.

Ayrıntılı uçuş emisyonları, hesaplama metodolojisini, emisyon dökümünü, yoğunlaşma izi etkisini ve verilerin kaynağını ayrıntılı olarak açıklayan kapsamlı meta verilerle desteklenen, yolcu başına şeffaf sera gazı emisyonu tahminleridir.

Emisyon tahminlerinin nasıl hesaplandığıyla ilgili ayrıntıları GitHub'da bulabilirsiniz.

Yanıt, giriş uçuş ayaklarıyla eşleşen tüm girişleri aynı sırada içerir. Belirli bir uçuş ayağı için tahmin bulunmuyorsa yanıtta, emisyon alanları boş olan uçuş ayağı nesnesi döndürülür. İstek yine de başarılı kabul edilir. Emisyon tahminlerinin eksik olmasının nedenleri şunlardır:

  • Uçuş, sunucu tarafından bilinmiyor.
  • Giriş uçuş ayağında bir veya daha fazla tanımlayıcı eksik.
  • Uçuş tarihi geçmişte.
  • Uçak türü, model tarafından desteklenmiyor.
  • Lisans yapılandırması eksik.

İstek en fazla 100 uçuş ayağı içerebilir. İstek 100'den fazla uçuş ayağı içeriyorsa INVALID_ARGUMENT hatasıyla başarısız olur.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
Alanlar
flights[]

object (Flight)

Zorunlu. Emisyon tahminlerinin döndürüleceği doğrudan uçuşlar.

Yanıt metni

flights.computeDetailedFlightEmissions yanıtı için çıkış tanımı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "flightsWithDetailedEmissions": [
    {
      object (FlightWithDetailedEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Alanlar
flightsWithDetailedEmissions[]

object (FlightWithDetailedEmissions)

Emisyon tahminlerini içeren uçuş etaplarının listesi.
modelVersion

object (ModelVersion)

Bu yanıttaki tüm uçuşların emisyon tahminlerinin hesaplandığı model sürümü.

FlightWithDetailedEmissions

Emisyon tahminleri ayrıntılarını içeren direkt uçuş.

JSON gösterimi 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
Alanlar
flight

object (Flight)

Yalnızca çıkış. İstekteki uçuş tanımlayıcılarıyla eşleşir. Not: Tüm IATA kodları büyük harfle yazılır.
flightEmissionsDetails

object (FlightEmissionsDetails)

Yalnızca çıkış. Tüm uçuş emisyonu verileri.
emissionsMetadata

object (EmissionsMetadata)

Yalnızca çıkış. Uçuş emisyonu hesaplamasıyla ilgili ek meta veriler.

FlightEmissionsDetails

Belirli bir uçuşun emisyonlarıyla ilgili ayrıntılar.

JSON gösterimi 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
Alanlar
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Yalnızca çıkış. Yolcu başına emisyon tahmini sayıları. Emisyonlar hesaplanamadıysa gösterilmez. Emisyonların hesaplanamamasının nedenlerinin listesi için flights.computeDetailedFlightEmissions bölümüne bakın.
emissionsBreakdown

object (EmissionsBreakdown)

Yalnızca çıkış. Toplam emisyonun çeşitli emisyon kısımlarıyla ilgili ayrıntılar. Toplanan dökümlerin değeri her zaman emissionsGramsPerPax değerine eşit olmalıdır.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Yalnızca çıkış. Yoğunlaşma izlerinin ısınma etkisinin, toplam CO2e emisyonlarının etkisine kıyasla önemi.
source

enum (Source)

Yalnızca çıkış. Emisyon verilerinin kaynağı.

EmissionsBreakdown

Toplam emisyonun çeşitli emisyon kısımlarıyla ilgili ayrıntılar. Toplanan dökümlerin değeri her zaman emissionsGramsPerPax değerine eşit olmalıdır.

JSON gösterimi 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Alanlar
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Yolcu başına yakıt üretiminden depoya kadar emisyon tahmini sayıları. Emisyonlar hesaplanamadıysa gösterilmez. Emisyonların hesaplanamamasının nedenlerinin listesi için flights.computeFlightEmissions başlıklı makaleyi inceleyin.
ttwEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Yolcu başına tanktan uyanmaya kadar emisyon tahmini sayıları. Emisyonlar hesaplanamadıysa gösterilmez. Emisyonların hesaplanamamasının nedenlerinin listesi için flights.computeFlightEmissions başlıklı makaleyi inceleyin.

EmissionsMetadata

Tüm ek meta veriler.

JSON gösterimi 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
Alanlar
emissionsProvenance

object (EmissionsProvenance)

Yalnızca çıkış. Emisyon verilerini hesaplamak için kullanılan verilerin kaynağıyla ilgili ayrıntılar (veri kaynaklarıyla birlikte katkıda bulunan faktörler dahil).
easaLabelMetadata

object (EasaLabelMetadata)

Yalnızca çıkış. EASA Uçuş Emisyon Etiketi ile ilgili meta veriler. Yalnızca emisyon veri kaynağı EASA olduğunda ayarlanır.
timWebsiteEmissionsCalculatorUrl

string

Yalnızca çıkış. travelimpactmodel.org Emisyon Hesaplayıcı web sitesinin bağlantısı. Örnek: https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225.

EmissionsProvenance

Emisyon tahminlerini hesaplamak için kullanılan verilerin kaynağıyla ilgili bilgiler (katkıda bulunan faktörler ve veri kaynakları dahil).

JSON gösterimi 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
Alanlar
provenanceEntries[]

object (EmissionsProvenance.EmissionsProvenanceEntry)

Yalnızca çıkış. Emisyonları hesaplamak için kullanılan tüm katkıda bulunan faktörler.

EmissionsProvenance.EmissionsProvenanceEntry

Emisyon hesaplamalarındaki tek bir katkıda bulunan faktörle ilgili ayrıntılar.

JSON gösterimi 
{
  "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.
}
Alanlar
provenanceEntryType

enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType)

Yalnızca çıkış. Kaynak girişi türü.
source

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource)

Yalnızca çıkış. Verilerin kaynağı.
sourceVersion

string

Yalnızca çıkış. Kaynak verilerin sürümü. Örneğin, "2025/04".
dataCategory

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory)

Yalnızca çıkış. Veri kaynağının veri kategorisi.
data_strategy birleşik alanı. Belirli bir veri kaynağının emisyonlarını hesaplamak için kullanılan strateji. Alan kümesi, data_source türüne karşılık gelir. data_strategy aşağıdakilerden yalnızca biri olabilir:
fuelBurnEeaStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy)

Yalnızca çıkış. AEA'da yakıt tüketimi stratejisi.
loadFactorsT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy)

Yalnızca çıkış. T100 yük faktörleri için strateji.
loadFactorsChAviationStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy)

Yalnızca çıkış. CH Aviation yük faktörleri stratejisi.
cargoMassFractionT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy)

Yalnızca çıkış. T100 kargo kütle oranı stratejisi.
seatAreaRatioIataStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy)

Yalnızca çıkış. IATA koltuk alanı oranları stratejisi.
distanceAdjustmentStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)

Yalnızca çıkış. Mesafe ayarlama stratejisi.
data_value birleşik alanı. Belirli bir veri kaynağının veri değeri. Alan kümesi, provenance_entry_type ile eşleşir. data_value aşağıdakilerden yalnızca biri olabilir:
loadFactorsData

number

Yalnızca çıkış. Yük faktörleri veri değeri. Ayarlanmamışsa yük faktörleri değeri kullanılamaz.
cargoMassFractionData

number

Yalnızca çıkış. Kargo kütle oranı değeri. Ayarlanmamışsa kargo kütle kesri değeri kullanılamaz.
seatAreaRatioData

object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)

Yalnızca çıkış. Her koltuk sınıfı için koltuk alanı oranı değeri. Ayarlanmamışsa koltuk alanı oranı değeri kullanılamaz.
estimatedFlightDistanceKm

integer

Yalnızca çıkış. Mesafe ayarlama faktörü (DAF) kullanılarak hesaplanan, CCD uçuş aşamasında uçulan tahmini mesafenin kilometre cinsinden değeri. Ayarlanmamışsa tahmini uçuş mesafesi değeri kullanılamaz.

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

Kaynak girişi türü. Gelecekte yeni değerler eklenebilir. İstemciler, bilinmeyen enum değerlerini düzgün bir şekilde işlemeye hazır olmalıdır.

Sıralamalar
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED Belirtilmemiş kaynak girişi türü.
FUEL_BURN Yakıt tüketimi giriş türü.
LOAD_FACTORS Yük faktörleri giriş türü.
CARGO_MASS_FRACTION Kargo kütle oranı giriş türü.
SEATING_CONFIG Oturma alanı yapılandırması giriş türü.
SEAT_AREA_RATIOS Oturma alanı oranları giriş türü.
DISTANCE_ADJUSTMENT Mesafe ayarlama giriş türü.

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

Emisyon kaynağı faktörlerinin veri kaynağı. Gelecekte yeni değerler eklenebilir. İstemciler, bilinmeyen enum değerlerini düzgün bir şekilde işlemeye hazır olmalıdır.

Sıralamalar
DATA_SOURCE_UNSPECIFIED Veri kaynağı belirtilmemiş.
EEA Veriler Avrupa Çevre Ajansı (EEA) tarafından sağlanır.
T100 ABD Ulaştırma İstatistikleri Bürosu tarafından sağlanan T-100 veri kümesindeki veriler.
CH_AVIATION Veriler ch-aviation tarafından sağlanmıştır.
OAG Veriler, Official Aviation Guide (OAG) tarafından sağlanır.
OPERATING_CARRIER Veriler, işleten taşıyıcı tarafından sağlanır.
AIRCRAFT_MODEL_TYPICAL Uçak modeline göre tipik veriler.
GLOBAL_DEFAULT Başka veri kaynağı olmadığında kullanılan genel bir varsayılan değer.
IATA Uluslararası Hava Taşımacılığı Birliği (IATA) tarafından sağlanan veriler.
ICL Veriler Imperial College London tarafından sağlanmıştır.

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

AEA'da yakıt tüketimi stratejisi. Gelecekte yeni değerler eklenebilir. İstemciler, bilinmeyen enum değerlerini düzgün bir şekilde işlemeye hazır olmalıdır.

Sıralamalar
STRATEGY_UNSPECIFIED Strateji belirtilmedi.
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR Statik bir düzeltme faktörü uygulandı.
AIRCRAFT_MAPPING_EXACT Uçağın tam eşlemesi kullanıldı.
AIRCRAFT_MAPPING_FALLBACK Yedek uçak haritası kullanıldı.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

T100 yük faktörleri için strateji. Gelecekte yeni değerler eklenebilir. İstemciler, bilinmeyen enum değerlerini düzgün bir şekilde işlemeye hazır olmalıdır.

Sıralamalar
STRATEGY_UNSPECIFIED Strateji belirtilmedi.
CARRIER_ROUTE_MONTH Kargo şirketine, rotaya ve seyahat ayına göre veriler.
CARRIER_MONTH Kargo şirketine ve seyahat ayına göre veriler.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH Operatör, rota, yıl ve ay ile eşleşen geçmiş veriler.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

CH-Aviation yük faktörleri stratejisi. Gelecekte yeni değerler eklenebilir. İstemciler, bilinmeyen enum değerlerini düzgün bir şekilde işlemeye hazır olmalıdır.

Sıralamalar
STRATEGY_UNSPECIFIED Strateji belirtilmedi.
CARRIER_MONTH Kargo şirketine ve seyahat ayına göre veriler.
ACTUAL_CARRIER_YEAR_MONTH Operatör, yıl ve ay ile eşleşen geçmiş veriler.

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

T100 kargo kütle oranı stratejisi. Gelecekte yeni değerler eklenebilir. İstemciler, bilinmeyen enum değerlerini düzgün bir şekilde işlemeye hazır olmalıdır.

Sıralamalar
STRATEGY_UNSPECIFIED Strateji belirtilmedi.
CARRIER_ROUTE_AIRCRAFT_CLASS Kargo şirketine, rotaya ve uçak sınıfına göre veriler.
ROUTE_AIRCRAFT_CLASS Rota ve uçak sınıfına göre veriler.
DISTANCE_AIRCRAFT_CLASS Mesafe aralığına ve uçak sınıfına göre veriler.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS Taşıyıcı, rota, yıl, ay ve uçak sınıfıyla eşleşen geçmiş veriler.

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

IATA koltuk alanı oranları stratejisi. Gelecekte yeni değerler eklenebilir. İstemciler, bilinmeyen enum değerlerini düzgün bir şekilde işlemeye hazır olmalıdır.

Sıralamalar
STRATEGY_UNSPECIFIED Strateji belirtilmedi.
NARROW_AIRCRAFT_BODY Dar gövdeli uçaklar için koltuk alanı oranları kullanıldı.
WIDE_AIRCRAFT_BODY Geniş gövdeli uçakların koltuk alanı oranları kullanıldı.

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

Mesafe ayarlama stratejisi. Gelecekte yeni değerler eklenebilir. İstemciler, bilinmeyen enum değerlerini düzgün bir şekilde işlemeye hazır olmalıdır.

Sıralamalar
STRATEGY_UNSPECIFIED Strateji belirtilmedi.
ORIGIN_DESTINATION Kalkış ve varış havalimanı çiftine göre belirlenen mesafe düzenleme faktörü.
COUNTRY_PAIR Kalkış ve varış ülkesi çiftine göre belirlenen mesafe düzenleme faktörü.
DEFAULT Havaalanına veya ülkeye özgü bir düzenleme faktörü bulamadığımız için mesafe düzenleme faktörü varsayılan değere göre belirlenir.

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

Veri kaynağının veri kategorisi. Gelecekte yeni değerler eklenebilir. İstemciler, bilinmeyen enum değerlerini düzgün bir şekilde işlemeye hazır olmalıdır.

Sıralamalar
DATA_CATEGORY_UNSPECIFIED Veri kategorisi belirtilmemiş.
PRIMARY ISO 14083'te tanımlandığı şekilde birincil veriler.
MODELED ISO 14083'te tanımlandığı şekilde modellenmiş veriler.
DEFAULT ISO 14083'te tanımlandığı şekilde varsayılan değer verileri.