Method: flights.computeScope3FlightEmissions

स्कोप 3 रिपोर्टिंग के लिए, फ़्लाइट के सेगमेंट के सेट के लिए जीएचजी उत्सर्जन के अनुमान हासिल करता है.

जवाब में वे सभी एंट्री शामिल होंगी जो इनपुट किए गए Scope3FlightSegment फ़्लाइट सेगमेंट से मेल खाती हैं. ये एंट्री उसी क्रम में होंगी जिस क्रम में दी गई हैं. अनुमानों का हिसाब, नीचे दिए गए कैस्केडिंग लॉजिक का इस्तेमाल करके लगाया जाएगा. इसके लिए, उपलब्ध पहले लॉजिक का इस्तेमाल किया जाएगा:

  1. origin, destination, carrier, flightNumber, departureDate, और cabinClass के लिए, टीआईएम के आधार पर उत्सर्जन की जानकारी.
  2. origin, destination, departureDate में साल, और cabinClass के हिसाब से, फ़्लाइट से होने वाला सामान्य उत्सर्जन.
  3. तय की गई दूरी के आधार पर उत्सर्जन का हिसाब लगाने के लिए, distanceKm, departureDate, और cabinClass का इस्तेमाल किया गया.

अगर इस कैलेंडर ईयर में आने वाले समय की किसी फ़्लाइट के लिए अनुरोध किया जाता है, तो हम टियर 1 उत्सर्जन की जानकारी नहीं देते. इसके बजाय, हम टियर 2 या 3 उत्सर्जन की जानकारी देते हैं. अगर अनुरोध की गई आने वाले समय की फ़्लाइट इस कैलेंडर वर्ष में नहीं है, तो हम कोई जवाब नहीं देंगे. हमारा सुझाव है कि आने वाले समय में फ़्लाइट के लिए, computeFlightEmissions एपीआई का इस्तेमाल करें.

अगर किसी फ़्लाइट के लिए, इन तीनों तरीकों में से किसी भी तरीके से अनुमान उपलब्ध नहीं हैं, तो जवाब में खाली उत्सर्जन फ़ील्ड वाला Scope3FlightEmissions ऑब्जेक्ट दिखेगा. अनुरोध को अब भी सफल माना जाएगा. आम तौर पर, उत्सर्जन के अनुमान की जानकारी तब नहीं मिलती, जब सर्वर को फ़्लाइट की जानकारी नहीं होती. उदाहरण के लिए, कोई खास फ़्लाइट मौजूद नहीं है या अनुरोध किए गए पेयर के लिए, फ़्लाइट से होने वाले सामान्य उत्सर्जन की जानकारी उपलब्ध नहीं है.

अनुरोध पूरा नहीं होगा और INVALID_ARGUMENT गड़बड़ी दिखेगी, अगर:

  • अनुरोध में 1,000 से ज़्यादा फ़्लाइट लेग शामिल हैं.
  • इनपुट फ़्लाइट लेग में एक या उससे ज़्यादा आइडेंटिफ़ायर मौजूद नहीं हैं. उदाहरण के लिए, TIM_EMISSIONS या TYPICAL_FLIGHT_EMISSIONS टाइप की मैचिंग के लिए, मान्य दूरी के बिना शुरुआत/मंज़िल की जानकारी मौजूद न होना या DISTANCE_BASED_EMISSIONS टाइप की मैचिंग के लिए दूरी की जानकारी मौजूद न होना. अगर आपको दूरी के हिसाब से उत्सर्जन की जानकारी चाहिए या दूरी के हिसाब से उत्सर्जन का अनुमान चाहिए, तो आपको दूरी की जानकारी देनी होगी.
  • फ़्लाइट की तारीख 2019 से पहले की है. स्कोप 3 का डेटा, सिर्फ़ 2019 और उसके बाद के लिए उपलब्ध है.
  • फ़्लाइट की दूरी 0 या इससे कम है.
  • केबिन क्लास की जानकारी मौजूद नहीं है.

अनुरोध को फ़ॉलबैक लॉजिक के साथ प्रोसेस किया जाता है. इसलिए, हो सकता है कि गलत तरीके से कॉन्फ़िगर किए गए अनुरोध, फ़ॉलबैक तरीकों का इस्तेमाल करके उत्सर्जन के मान्य अनुमान दिखाएं. उदाहरण के लिए, अगर किसी अनुरोध में फ़्लाइट नंबर गलत है, लेकिन फ़्लाइट के शुरू होने और खत्म होने की जगह की जानकारी दी गई है, तो अनुरोध पूरा हो जाएगा. हालांकि, उत्सर्जन की जानकारी सिर्फ़ सामान्य फ़्लाइट के उत्सर्जन पर आधारित होगी. इसी तरह, अगर किसी अनुरोध में फ़्लाइट से होने वाले उत्सर्जन की जानकारी के लिए, यात्रा शुरू होने की जगह की जानकारी मौजूद नहीं है, लेकिन यात्रा की दूरी की मान्य जानकारी दी गई है, तो अनुरोध को सिर्फ़ दूरी के आधार पर उत्सर्जन की जानकारी के आधार पर पूरा किया जा सकता है. इसलिए, यह पक्का करने के लिए कि नतीजे उम्मीद के मुताबिक हैं, उत्सर्जन (source) के सोर्स की जांच करनी चाहिए.

एचटीटीपी अनुरोध

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

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "flights": [
    {
      object (Scope3FlightSegment)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
फ़ील्ड
flights[]

object (Scope3FlightSegment)

ज़रूरी है. वे फ़्लाइट जिनके लिए उत्सर्जन के अनुमान दिखाने हैं.
modelVersion

object (ModelVersion)

ज़रूरी नहीं. मॉडल का वह वर्शन जिसके तहत, इस अनुरोध में शामिल सभी फ़्लाइट के लिए उत्सर्जन के अनुमान का हिसाब लगाया गया था.

जवाब का मुख्य भाग

स्कोप 3 उत्सर्जन के अनुमान के साथ फ़्लाइट की सूची.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "flightEmissions": [
    {
      object (Scope3FlightEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
फ़ील्ड
flightEmissions[]

object (Scope3FlightEmissions)

उत्सर्जन के अनुमान के साथ, फ़्लाइट सेगमेंट की सूची.
modelVersion

object (ModelVersion)

मॉडल का वह वर्शन जिसके तहत, इस जवाब में मौजूद सभी फ़्लाइट के लिए, उत्सर्जन के अनुमान का हिसाब लगाया गया था.

Scope3FlightSegment

फ़्लाइट के वे पैरामीटर जिनकी मदद से, स्कोप 3 उत्सर्जन का डेटा फ़ेच किया जाता है.

JSON के काेड में दिखाना 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
फ़ील्ड
departureDate

object (Date)

ज़रूरी है. ऑरिजिन एयरपोर्ट के टाइम ज़ोन के हिसाब से, फ़्लाइट की तारीख. फ़्लाइट और दूरी के आधार पर उत्सर्जन के सामान्य मॉडल के लिए, सिर्फ़ साल की जानकारी देना ज़रूरी है. महीने और दिन की वैल्यू को अनदेखा कर दिया जाता है. इसलिए, इन मामलों में उन्हें छोड़ा जा सकता है, 0 पर सेट किया जा सकता है या किसी मान्य तारीख पर सेट किया जा सकता है. इसी तरह, अगर टीआईएम उत्सर्जन के लिए कोई तारीख नहीं दी गई है, तो हम सामान्य फ़्लाइट (या दूरी के हिसाब से) उत्सर्जन का इस्तेमाल करेंगे.
cabinClass

enum (Scope3FlightSegment.CabinClass)

ज़रूरी है. फ़्लाइट की केबिन क्लास.
origin

string

ज़रूरी नहीं. फ़्लाइट के ऑरिजिन एयरपोर्ट का तीन वर्णों वाला आईएटीए एयरपोर्ट कोड. उदाहरण के लिए, YVR. इसका इस्तेमाल, किसी खास फ़्लाइट से मैच करने के लिए किया जाता है. हालांकि, इसके लिए डेस्टिनेशन, कैरियर, और फ़्लाइट नंबर की जानकारी देना ज़रूरी है. अगर कोई मैच नहीं मिलता है, तो हम सबसे पहले फ़्लाइट को, दिए गए ओरिजन और डेस्टिनेशन एयरपोर्ट के बीच की सामान्य फ़्लाइट से मैच करने की कोशिश करेंगे. अगर फ़्लाइट की दूरी की जानकारी दी गई है, तो हम दूरी के आधार पर उत्सर्जन का मॉडल इस्तेमाल करेंगे.
destination

string

ज़रूरी नहीं. फ़्लाइट के डेस्टिनेशन के लिए, तीन वर्णों वाला आईएटीए हवाई अड्डे का कोड. उदाहरण के लिए, ICN. इसका इस्तेमाल, किसी खास फ़्लाइट से मैच करने के लिए किया जाता है. हालांकि, इसके लिए ज़रूरी है कि ऑरिजिन, कैरियर, और फ़्लाइट नंबर की जानकारी दी गई हो. अगर कोई मैच नहीं मिलता है, तो हम सबसे पहले फ़्लाइट को, दिए गए ओरिजन और डेस्टिनेशन एयरपोर्ट के बीच की सामान्य फ़्लाइट से मैच करने की कोशिश करेंगे. अगर फ़्लाइट की दूरी की जानकारी दी गई है, तो हम दूरी के आधार पर उत्सर्जन का मॉडल इस्तेमाल करेंगे.
carrierCode

string

ज़रूरी नहीं. दो वर्णों वाला आईएटीए कैरियर कोड, जैसे कि KE. अगर आपको किसी खास फ़्लाइट से मैच करना है, तो यह ज़रूरी है. आम तौर पर, फ़्लाइट और दूरी के आधार पर उत्सर्जन का अनुमान लगाने वाले मॉडल के लिए, इस एट्रिब्यूट का इस्तेमाल नहीं किया जाता. यह ऑपरेटिंग और मार्केटिंग कैरियर कोड, दोनों हो सकता है. इसका मतलब है कि कोड शेयर की सुविधा शामिल है.
flightNumber

integer

ज़रूरी नहीं. चार अंकों तक का फ़्लाइट नंबर, जैसे कि 71, [1, 9999] से. अगर फ़्लाइट नंबर के साथ-साथ, फ़्लाइट के शुरू होने की जगह, मंज़िल, और कैरियर की जानकारी दी गई है, तो इसका इस्तेमाल सबसे पहले किसी खास फ़्लाइट से मैच करने के लिए किया जाता है. अगर फ़्लाइट नंबर नहीं दिया गया है, तो हम सबसे पहले फ़्लाइट को, दिए गए मूल और डेस्टिनेशन एयरपोर्ट के बीच की सामान्य फ़्लाइट से मैच करने की कोशिश करेंगे. अगर ऐसा नहीं होता है और/या फ़्लाइट के शुरू होने और खत्म होने की जगह की जानकारी नहीं दी जाती है, तो हम फ़्लाइट की दूरी के आधार पर उत्सर्जन का मॉडल इस्तेमाल करेंगे.
distanceKm

string (int64 format)

ज़रूरी नहीं. किलोमीटर में दूरी, जैसे कि 2423, [1, 1e12) कि॰मी॰ से. इसका इस्तेमाल, दूरी के हिसाब से उत्सर्जन की जानकारी देने वाली फ़्लाइट से मैच करने के लिए किया जाता है. ऐसा तब किया जाता है, जब यात्रा शुरू होने और खत्म होने की जगह की जानकारी न दी गई हो या मैच होने वाली कोई सामान्य फ़्लाइट न हो.

Scope3FlightSegment.CabinClass

फ़्लाइट की केबिन क्लास.

Enums
CABIN_CLASS_UNSPECIFIED केबिन क्लास की जानकारी नहीं दी गई है.
ECONOMY इकॉनमी क्लास.
PREMIUM_ECONOMY प्रीमियम इकॉनमी क्लास.
BUSINESS बिज़नेस क्लास.
FIRST फ़र्स्ट क्लास.

Scope3FlightEmissions

स्कोप 3 के तहत, फ़्लाइट से होने वाले उत्सर्जन के अनुमान.

JSON के काेड में दिखाना 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType),
  "modelVersion": string
}
फ़ील्ड
flight

object (Scope3FlightSegment)

आइडेंटिफ़ायर. अनुरोध में मौजूद फ़्लाइट आइडेंटिफ़ायर से मेल खाता हो.
wtwEmissionsGramsPerPax

string (int64 format)

ज़रूरी नहीं. अनुरोध की गई जानकारी के आधार पर, हर यात्री के लिए फ़्लाइट से होने वाला कुल उत्सर्जन (वेल-टू-टैंक और टैंक-टू-वेक का योग). यह कुल उत्सर्जन है. अगर आपके पास टीटीडब्ल्यू या डब्ल्यूटीटी उत्सर्जन का इस्तेमाल करने की कोई खास वजह नहीं है, तो आपको इस संख्या का इस्तेमाल करना चाहिए.
ttwEmissionsGramsPerPax

string (int64 format)

ज़रूरी नहीं. अनुरोध की गई जानकारी के आधार पर, हर यात्री के लिए टैंक-टू-वेक फ़्लाइट से होने वाला उत्सर्जन.
wttEmissionsGramsPerPax

string (int64 format)

ज़रूरी नहीं. अनुरोध की गई जानकारी के आधार पर, हर यात्री के लिए फ़्लाइट से होने वाला वेल-टू-टैंक उत्सर्जन.
source

enum (Scope3FlightEmissions.Scope3DataType)

ज़रूरी नहीं. उत्सर्जन के डेटा का सोर्स.
modelVersion

string

ज़रूरी नहीं. मॉडल का वह वर्शन जिसके तहत उत्सर्जन का हिसाब लगाया गया था.

Scope3FlightEmissions.Scope3DataType

स्कोप 3 उत्सर्जन का हिसाब लगाने के लिए इस्तेमाल किया जाने वाला मैचिंग टाइप. इसका इस्तेमाल, स्कोप 3 के जवाब के लिए किया जाता है. इससे यह पता चलता है कि उत्सर्जन का हिसाब लगाने के लिए, किस तरीके का इस्तेमाल किया गया था.

Enums
SCOPE3_DATA_TYPE_UNSPECIFIED डेटा टाइप की जानकारी नहीं दी गई है.
TIM_EMISSIONS यात्रा की शुरुआत की जगह, मंज़िल, कैरियर, फ़्लाइट नंबर, यात्रा की तारीख, और साल के आधार पर, टीआईएम के मुताबिक उत्सर्जन की जानकारी.
TYPICAL_FLIGHT_EMISSIONS फ़्लाइट से होने वाले सामान्य उत्सर्जन की जानकारी. इसमें यात्रा की शुरुआत की जगह, मंज़िल, और साल की जानकारी शामिल है.
DISTANCE_BASED_EMISSIONS तय की गई दूरी और साल के आधार पर, दूरी के हिसाब से होने वाला उत्सर्जन.