Method: flights.computeFlightEmissions

Emisyon tahminlerini almak için durum bilgisi içermeyen yöntem. 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 1.000 uçuş ayağı içerebilir. İstek 1.000'den fazla doğrudan uçuş içeriyorsa INVALID_ARGUMENT hatasıyla başarısız olur.

HTTP isteği

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

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

İstek içeriği

İstek metni 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 gövdesi

flights.computeFlightEmissions 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 
{
  "flightEmissions": [
    {
      object (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Alanlar
flightEmissions[]

object (FlightWithEmissions)

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ü.

Uçuş

Doğrudan uçuş emisyon tahminleri için tek bir istek öğesiyle ilgili tüm ayrıntılar.

JSON gösterimi 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
Alanlar
origin

string

Zorunlu. Uçuşun kalkış noktasının IATA havaalanı kodu (ör. "LHR").
destination

string

Zorunlu. Uçuş varış noktasının IATA havaalanı kodu (ör. "JFK").
operatingCarrierCode

string

Zorunlu. IATA hava yolu kodu (ör. "AA").
flightNumber

integer

Zorunlu. Uçuş numarası (ör. 324)
departureDate

object (Date)

Zorunlu. Kalkış havaalanının saat dilimindeki uçuş tarihi. Bugün veya gelecekteki bir tarih olmalıdır.

Tarih

Doğum günü gibi tam veya kısmi bir takvim tarihini gösterir. Günün saati ve saat dilimi başka bir yerde belirtilmiştir veya önemsizdir. Tarih, Gregoryen Takvimi'ne göre belirlenir. Bu, aşağıdakilerden birini temsil edebilir:

  • Yıl, ay ve gün değerleri sıfır olmayan tam bir tarih.
  • Sıfır yılıyla birlikte ay ve gün (ör. yıl dönümü).
  • Tek başına bir yıl, sıfır ay ve sıfır gün.
  • Bir yıl ve ay, sıfır günle (örneğin, kredi kartının son kullanma tarihi).

İlgili türler:

JSON gösterimi 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında olmalı veya yıl içermeyen bir tarih belirtmek için 0 olmalıdır.
month

integer

Yılın ayı. 1 ile 12 arasında olmalıdır veya ay ve gün içermeyen bir yıl belirtmek için 0 olmalıdır.
day

integer

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. Yalnızca bir yılı veya günün önemli olmadığı bir yıl ve ayı belirtmek için 0 olmalıdır.

FlightWithEmissions

Emisyon tahminleriyle birlikte doğrudan uçuş.

JSON gösterimi 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
Alanlar
flight

object (Flight)

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

enum (Source)

İsteğe bağlıdır. Emisyon verilerinin kaynağı.
emissionsGramsPerPax

object (EmissionsGramsPerPax)

İsteğe bağlıdır. Yolcu başına 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.
easaLabelMetadata

object (EasaLabelMetadata)

İsteğe bağlıdır. EASA Uçuş Emisyon Etiketi ile ilgili meta veriler. Yalnızca emisyon veri kaynağı EASA olduğunda ayarlanır.
contrailsImpactBucket

enum (ContrailsImpactBucket)

İsteğe bağlıdır. Yoğunlaşma izlerinin ısınma etkisinin, toplam CO2e emisyonlarının etkisine kıyasla önemi.

Kaynak

Emisyon verilerinin kaynağı.

Sıralamalar
SOURCE_UNSPECIFIED Emisyon verilerinin kaynağı belirtilmemiş.
TIM Emisyon verileri, Seyahat Etkisi Modeli'nden alınır.
EASA Emisyon verileri, EASA çevre etiketlerinden alınır.

EasaLabelMetadata

EASA Uçuş Emisyon Etiketi ile ilgili meta veriler.

JSON gösterimi 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
Alanlar
labelIssueDate

object (Date)

Etiketin düzenlendiği tarih.
labelExpiryDate

object (Date)

Etiketin geçerliliğinin sona ereceği tarih. Etiket, bu tarihin sonuna kadar gösterilebilir.
labelVersion

string

Etiketin sürümü.
safDiscountPercentage

number

Etikete uygulanan sürdürülebilir uçak yakıtı (SAF) emisyon indirimi yüzdesi. Ondalık sayı olarak yüzde. Değerler [0,1] aralığındadır. Örneğin, 0,0021 değeri %0,21 anlamına gelir.

Bu indirim ve emisyonlardaki azalma, EASA etiketi tarafından bildirilir ancak bu API tarafından dağıtılan CO2e tahminlerine dahil edilmez.

ContrailsImpactBucket

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

Sıralamalar
CONTRAILS_IMPACT_UNSPECIFIED Yoğunlaşma izlerinin etkisi belirtilmedi.
CONTRAILS_IMPACT_NEGLIGIBLE Yoğunlaşma izlerinin etkisi, toplam CO2e emisyonlarına kıyasla ihmal edilebilir düzeydedir.
CONTRAILS_IMPACT_MODERATE Yoğunlaşma izlerinin etkisi, toplam CO2e emisyonlarıyla karşılaştırılabilir.
CONTRAILS_IMPACT_SEVERE Yoğunlaşma izlerinin etkisi, toplam CO2e emisyonlarının etkisinden daha yüksektir.