Method: flights.computeScope3FlightEmissions

Kapsam 3 raporlaması için bir grup uçuş segmentinin GHG emisyonu tahminlerini alır.

Yanıt, giriş Scope3FlightSegment uçuş segmentleriyle eşleşen tüm girişleri aynı sırada içerir. Tahminler, aşağıdaki basamaklı mantık kullanılarak hesaplanır (mevcut olan ilk tahmin kullanılır):

  1. origin, destination, carrier, flightNumber, departureDate ve cabinClass için TIM tabanlı emisyonlar.
  2. origin, destination, departureDate yılı ve cabinClass göz önüne alındığında tipik uçuş emisyonları.
  3. distanceKm, departureDate yılı ve cabinClass kullanılarak hesaplanan mesafeye dayalı emisyonlar.

Bu takvim yılında gelecekteki bir uçuş talep edilirse 1. katman emisyonları desteklenmez ve 2. veya 3. katman emisyonlarına geri dönülür. İstenen gelecekteki uçuş bu takvim yılı içinde değilse boş bir yanıt döndürülür. Gelecekteki uçuşlar için computeFlightEmissions API'sinin kullanılmasını öneririz.

Üç yöntemden herhangi biriyle belirli bir uçuş için tahmin bulunmuyorsa yanıtta, emisyon alanları boş olan bir Scope3FlightEmissions nesnesi döndürülür. İstek yine de başarılı kabul edilir. Genellikle, uçuş sunucu tarafından bilinmediğinde (ör. belirli bir uçuş yoksa veya istenen çift için normal uçuş emisyonları mevcut değilse) emisyon tahminleri eksik olur.

Aşağıdaki durumlarda istek INVALID_ARGUMENT hatasıyla başarısız olur:

  • İstek 1.000'den fazla uçuş ayağı içeriyor.
  • Giriş uçuş ayağında bir veya daha fazla tanımlayıcı eksik. Örneğin, TIM_EMISSIONS veya TYPICAL_FLIGHT_EMISSIONS türü eşleşmesi için geçerli bir mesafe olmadan kaynak/hedef eksik ya da DISTANCE_BASED_EMISSIONS türü eşleşmesi için mesafe eksik (mesafeye dayalı emisyonlara geri dönmek veya mesafeye dayalı emisyon tahmini almak istiyorsanız mesafe belirtmeniz gerekir).
  • Uçuş tarihi 2019'dan önceyse (kapsam 3 verileri yalnızca 2019 ve sonrası için kullanılabilir).
  • Uçuş mesafesi 0 veya daha az olmalıdır.
  • Kabin sınıfı eksik.

İstek, yedek mantıkla işlendiğinden yanlış yapılandırılmış istekler, yedek yöntemler kullanılarak geçerli emisyon tahminleri döndürebilir. Örneğin, bir istekte yanlış uçuş numarası varsa ancak kalkış ve varış noktası belirtilmişse istek yine de başarılı olur ancak döndürülen emisyonlar yalnızca tipik uçuş emisyonlarına göre belirlenir. Benzer şekilde, tipik bir uçuş emisyonu isteğinde kaynak eksikse ancak geçerli bir mesafe belirtilmişse istek yalnızca mesafeye dayalı emisyonlara göre başarılı olabilir. Bu nedenle, sonuçların beklendiği gibi olduğunu doğrulamak için döndürülen emisyonların kaynağı (source) kontrol edilmelidir.

HTTP isteği

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

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

object (Scope3FlightSegment)

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

object (ModelVersion)

İsteğe bağlı. Bu istekteki tüm uçuşların emisyon tahminlerinin hesaplandığı model sürümü.

Yanıt metni

Kapsam 3 emisyon tahminlerini içeren uçuş listesi.

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

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

object (Scope3FlightEmissions)

Emisyon tahminlerinin yer aldığı uçuş segmentlerinin listesi.
modelVersion

object (ModelVersion)

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

Scope3FlightSegment

Kapsam 3 emisyonlarının getirildiği uçuş parametreleri.

JSON gösterimi 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Alanlar
departureDate

object (Date)

Zorunlu. Kalkış havaalanının saat dilimindeki uçuş tarihi. Normal uçuş ve mesafeye dayalı emisyon modelleri için yalnızca yıl gereklidir (ay ve gün değerleri yoksayılır. Bu nedenle, bu durumlarda değerler atlanabilir, 0 olarak ayarlanabilir veya geçerli bir tarih olarak ayarlanabilir). Benzer şekilde, TIM emisyonları için belirli bir tarih sağlanmazsa normal uçuş (veya mesafeye dayalı) emisyonlarına geri döneriz.
cabinClass

enum (Scope3FlightSegment.CabinClass)

Zorunlu. Uçuşun kabin sınıfı.
origin

string

İsteğe bağlı. Uçuşun kalkış noktası için 3 karakterli IATA havaalanı kodu (ör. YVR). Bu özellik, varış noktası, operatör ve uçuş numarasıyla birlikte sağlandığında belirli bir uçuşu eşleştirmek için kullanılır. Eşleşme yoksa önce uçuşu, belirtilen başlangıç ve varış havaalanları arasındaki normal bir uçuşla eşleştirmeye çalışırız. Aksi takdirde, uçuş mesafesi sağlanırsa mesafeye dayalı emisyon modelini kullanırız.
destination

string

İsteğe bağlı. Uçuş varış noktası için 3 karakterlik IATA havaalanı kodu (ör. ICN). Kalkış yeri, operatör ve uçuş numarasıyla birlikte sağlandığında belirli bir uçuşu eşleştirmek için kullanılır. Eşleşme yoksa önce uçuşu, belirtilen başlangıç ve varış havaalanları arasındaki normal bir uçuşla eşleştirmeye çalışırız. Aksi takdirde, uçuş mesafesi sağlanırsa mesafeye dayalı emisyon modelini kullanırız.
carrierCode

string

İsteğe bağlı. 2 karakterli IATA taşıyıcı kodu (ör. KE). Belirli bir uçuşun eşleştirilmesi isteniyorsa bu gereklidir. Aksi takdirde, bu değer normal uçuş ve mesafeye dayalı emisyon modelleri için kullanılmaz. Bu, hem işletim hem de pazarlama taşıyıcı kodu olabilir (ör. ortak uçuş desteklenir).
flightNumber

integer

İsteğe bağlı. 4 basamağa kadar uçuş numarası (ör. 71) [1, 9999] aralığında. Bu, kalkış noktası, varış noktası ve taşıyıcı ile birlikte bir uçuş numarası belirtilmişse belirli bir uçuşu eşleştirmek için ilk olarak kullanılır. Uçuş numarası belirtilmemişse önce uçuşu, belirtilen kalkış ve varış noktası havaalanları arasındaki normal bir uçuşla eşleştirmeye çalışırız. Bu işlem başarısız olursa ve/veya kalkış ve varış noktası sağlanmazsa, sağlanan uçuş mesafesine göre mesafeye dayalı emisyon modelini kullanırız.
distanceKm

string (int64 format)

İsteğe bağlı. Kilometre cinsinden mesafe (ör. 2423), [1, 2.5e16) km. Bu, kalkış ve varış noktası sağlanmadığında veya eşleşen normal uçuş olmadığında bir uçuşu mesafeye dayalı emisyonlarla eşleştirmek için kullanılır.

Scope3FlightSegment.CabinClass

Uçuşun kabin sınıfı.

Sıralamalar
CABIN_CLASS_UNSPECIFIED Belirtilmemiş kabin sınıfı.
ECONOMY Ekonomi sınıfı.
PREMIUM_ECONOMY Premium ekonomi sınıfı
BUSINESS Business class
FIRST First class.

Scope3FlightEmissions

Emisyon tahminleriyle birlikte Kapsam 3 uçuşu.

JSON gösterimi 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType)
}
Alanlar
flight

object (Scope3FlightSegment)

Tanımlayıcı. İstekteki uçuş tanımlayıcılarıyla eşleşir.
wtwEmissionsGramsPerPax

string (int64 format)

İsteğe bağlı. İstenen bilgilere göre yolcu başına toplam uçuş emisyonları (kaynaktan depoya ve depodan uyanmaya kadar olan emisyonların toplamı). Bu, toplam emisyondur ve TTW veya WTT emisyonlarını kullanmak için belirli nedenleriniz yoksa bu sayıyı kullanmanız gerekir.
ttwEmissionsGramsPerPax

string (int64 format)

İsteğe bağlı. İstenen bilgilere göre yolcu başına yakıttan kalkışa kadar olan uçuş emisyonları.
wttEmissionsGramsPerPax

string (int64 format)

İsteğe bağlı. İstenen bilgilere göre yolcu başına yakıt üretiminden depolamaya kadar olan uçuş emisyonları.
source

enum (Scope3FlightEmissions.Scope3DataType)

İsteğe bağlı. Emisyon verilerinin kaynağı.

Scope3FlightEmissions.Scope3DataType

Kapsam 3 emisyonlarını hesaplamak için kullanılan eşleme türü. Bu, Kapsam 3 yanıtı için kullanılır ve emisyonları hesaplamak için hangi yöntemin kullanıldığını işaretler.

Sıralamalar
SCOPE3_DATA_TYPE_UNSPECIFIED Belirtilmemiş veri türü.
TIM_EMISSIONS Başlangıç noktası, varış noktası, kargo şirketi, uçuş numarası, kalkış tarihi ve yıla göre TIM tabanlı emisyonlar.
TYPICAL_FLIGHT_EMISSIONS Kalkış noktası, varış noktası ve yıla göre normal uçuş emisyonları.
DISTANCE_BASED_EMISSIONS Katedilen mesafeye ve yıla göre mesafeye dayalı emisyonlar.