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 (CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
फ़ील्ड
departureDate

object (Date)

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

enum (CabinClass)

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

string

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

string

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

string

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

integer

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

string (int64 format)

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

CabinClass

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

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

Scope3FlightEmissions

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

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

object (Scope3FlightSegment)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

enum (Scope3DataType)

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

Scope3DataType

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

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