Method: flights.computeFlightEmissions

उत्सर्जन के अनुमानों को वापस पाने का स्टेटलेस तरीका. उत्सर्जन के अनुमानों का हिसाब कैसे लगाया जाता है, इसकी जानकारी GitHub में दी गई है

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

  • सर्वर को फ़्लाइट की जानकारी नहीं है.
  • इनपुट किए गए फ़्लाइट लेग में एक या एक से ज़्यादा आइडेंटिफ़ायर मौजूद नहीं हैं.
  • फ़्लाइट की तारीख बीत चुकी है.
  • इस मॉडल के साथ एयरक्राफ्ट टाइप काम नहीं करता.
  • सीट का कॉन्फ़िगरेशन मौजूद नहीं है.

अनुरोध में ज़्यादा से ज़्यादा 1,000 फ़्लाइट लेग हो सकते हैं. अगर अनुरोध में 1,000 से ज़्यादा सीधी फ़्लाइट हैं, तो INVALID_ARGUMENT गड़बड़ी की वजह से अनुरोध पूरा नहीं होगा.

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

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

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

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

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

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

object (Flight)

ज़रूरी है. वापस आने वाली फ़्लाइट के लिए, अनुमानित कार्बन उत्सर्जन.

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

flights.computeFlightEmissions के जवाब के लिए आउटपुट की परिभाषा.

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

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

object (FlightWithEmissions)

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

object (ModelVersion)

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

फ़्लाइट

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

JSON के काेड में दिखाना 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
फ़ील्ड
origin

string

ज़रूरी है. फ़्लाइट के ऑरिजिन एयरपोर्ट का आईएटीए कोड, जैसे कि "LHR".
destination

string

ज़रूरी है. फ़्लाइट के डेस्टिनेशन का आईएटीए एयरपोर्ट कोड, जैसे कि "JFK".
operatingCarrierCode

string

ज़रूरी है. आईएटीए कैरियर कोड, जैसे कि "AA".
flightNumber

integer

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

object (Date)

ज़रूरी है. ऑरिजिन एयरपोर्ट के टाइम ज़ोन के हिसाब से, फ़्लाइट की तारीख. यह मौजूदा या आने वाले समय की कोई तारीख होनी चाहिए.

FlightWithEmissions

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

JSON के काेड में दिखाना 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
फ़ील्ड
flight

object (Flight)

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

enum (Source)

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

object (EmissionsGramsPerPax)

ज़रूरी नहीं. हर यात्री के हिसाब से, अनुमानित कार्बन उत्सर्जन के आंकड़े. अगर उत्सर्जन का हिसाब नहीं लगाया जा सका, तो यह जानकारी मौजूद नहीं होगी. कार्बन उत्सर्जन का हिसाब न लगाने की वजहों की सूची देखने के लिए, flights.computeFlightEmissions पर जाएं.
easaLabelMetadata

object (EasaLabelMetadata)

ज़रूरी नहीं. ईएएसए फ़्लाइट के उत्सर्जन से जुड़े लेबल के बारे में मेटाडेटा. इस कुकी को सिर्फ़ तब सेट किया जाता है, जब उत्सर्जन डेटा सोर्स EASA हो.
contrailsImpactBucket

enum (ContrailsImpactBucket)

ज़रूरी नहीं. कुल CO2e उत्सर्जन के मुकाबले, कॉन्ट्रेल से होने वाली गर्मी के असर का महत्व.

स्रोत

उत्सर्जन के डेटा का सोर्स.

Enums
SOURCE_UNSPECIFIED कार्बन उत्सर्जन के डेटा के सोर्स की जानकारी नहीं दी गई है.
TIM कार्बन उत्सर्जन का डेटा, ट्रैवल इंपैक्ट मॉडल से लिया गया है.
EASA उत्सर्जन का डेटा, ईएएसए के एनवायरमेंटल लेबल से लिया गया है.

EasaLabelMetadata

ईएएसए फ़्लाइट के उत्सर्जन से जुड़े लेबल के बारे में मेटाडेटा.

JSON के काेड में दिखाना 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
फ़ील्ड
labelIssueDate

object (Date)

वह तारीख जब लेबल जारी किया गया था.
labelExpiryDate

object (Date)

लेबल की समयसीमा खत्म होने की तारीख. यह लेबल, इस तारीख के खत्म होने तक दिखाया जा सकता है.
labelVersion

string

लेबल का वर्शन.
safDiscountPercentage

number

सस्टेनेबल एविएशन फ़्यूल (एसएएफ़) के इस्तेमाल से होने वाले कार्बन उत्सर्जन में कमी के आधार पर, लेबल पर लागू होने वाली छूट का प्रतिशत. यह दशमलव के तौर पर प्रतिशत होता है. वैल्यू, [0,1] इंटरवल में होती हैं. उदाहरण के लिए, 0.0021 का मतलब 0.21% है.

ईएएसए के लेबल के मुताबिक, इस फ़्लाइट में छूट दी गई है और इससे उत्सर्जन में कमी आई है. हालांकि, इस एपीआई से मिले CO2e के अनुमानों में इन बातों को शामिल नहीं किया गया है.

ContrailsImpactBucket

कुल CO2e उत्सर्जन के मुकाबले, कॉन्ट्रेल से होने वाली गर्मी के असर का महत्व.

Enums
CONTRAILS_IMPACT_UNSPECIFIED जेट विमानों के धुएं से होने वाले असर के बारे में जानकारी नहीं दी गई है.
CONTRAILS_IMPACT_NEGLIGIBLE कुल CO2e उत्सर्जन की तुलना में, कॉन्ट्रेल का असर न के बराबर होता है.
CONTRAILS_IMPACT_MODERATE कॉन्ट्रेल से होने वाला असर, कुल CO2e उत्सर्जन के बराबर होता है.
CONTRAILS_IMPACT_SEVERE कॉन्ट्रेल का असर, CO2e के कुल उत्सर्जन के असर से ज़्यादा होता है.