- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- फ़्लाइट
- तारीख
- FlightWithEmissions
- EmissionsGramsPerPax
- ModelVersion
- इसे आज़माएं!
उत्सर्जन के अनुमान पाने का स्टेटलेस तरीका. उत्सर्जन के अनुमानों का हिसाब कैसे लगाया जाता है, इससे जुड़ी जानकारी: https://github.com/google/travel-impact-model
जवाब में इनपुट फ़्लाइट लैग से मेल खाने वाली सभी एंट्री उसी क्रम में शामिल होंगी. अगर फ़्लाइट की किसी खास लेग के लिए कोई अनुमान उपलब्ध नहीं है, तो रिस्पॉन्स के तौर पर फ़्लाइट लेग ऑब्जेक्ट, उत्सर्जन के खाली फ़ील्ड के साथ दिखेगा. इसके बाद भी यह माना जाएगा कि आपके अनुरोध को स्वीकार कर लिया गया है. उत्सर्जन का अनुमान न होने की ये वजहें हैं:
- सर्वर के पास उड़ान की जानकारी नहीं है.
- इनपुट फ़्लाइट लेग में एक या उससे ज़्यादा आइडेंटिफ़ायर मौजूद नहीं हैं.
- फ़्लाइट की तारीख बीत चुकी है.
- हवाई जहाज़ का यह मॉडल, इस टाइप के मुताबिक नहीं है.
- सीट कॉन्फ़िगरेशन मौजूद नहीं है.
अनुरोध में फ़्लाइट के ज़्यादा से ज़्यादा 1,000 पैरों को शामिल किया जा सकता है. अगर अनुरोध में 1,000 से ज़्यादा डायरेक्ट फ़्लाइट हैं, तो जवाब के तौर पर दी गई वैल्यू अमान्य हो जाएगी. साथ ही, यह गड़बड़ी INVALID_VERSION के लिए होगी.
एचटीटीपी अनुरोध
POST https://travelimpactmodel.googleapis.com/v1/flights:computeFlightEmissions
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{
"flights": [
{
object ( |
फ़ील्ड | |
---|---|
flights[] |
ज़रूरी है. उत्सर्जन के अनुमान के लिए रिटर्न करने वाली सीधी फ़्लाइट. |
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
[flights.ComputeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions] जवाब के लिए आउटपुट की परिभाषा क्या है.
जेएसओएन के काेड में दिखाना |
---|
{ "flightEmissions": [ { object ( |
फ़ील्ड | |
---|---|
flightEmissions[] |
उत्सर्जन के अनुमान के साथ फ़्लाइट की लेग सूची. |
modelVersion |
वह मॉडल वर्शन जिसके तहत इस जवाब में, सभी फ़्लाइट के लिए, उत्सर्जन का अनुमान लगाया गया था. |
फ़्लाइट
सीधी फ़्लाइट के उत्सर्जन का अनुमान लगाने के लिए, एक अनुरोध किए गए आइटम से जुड़ी पूरी जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{
"origin": string,
"destination": string,
"operatingCarrierCode": string,
"flightNumber": integer,
"departureDate": {
object ( |
फ़ील्ड | |
---|---|
origin |
ज़रूरी है. फ़्लाइट की शुरुआत की जगह के लिए आईएटीए एयरपोर्ट कोड, जैसे कि "LHR". |
destination |
ज़रूरी है. फ़्लाइट की डेस्टिनेशन के लिए आईएटीए एयरपोर्ट कोड, जैसे कि "JFK". |
operatingCarrierCode |
ज़रूरी है. आईएटीए कैरियर कोड, जैसे कि "AA". |
flightNumber |
ज़रूरी है. फ़्लाइट नंबर, जैसे कि 324. |
departureDate |
ज़रूरी है. फ़्लाइट की तारीख, वह तारीख जब फ़्लाइट की शुरुआत की जगह वाले हवाई अड्डे के टाइम ज़ोन के हिसाब से होनी चाहिए. मौजूदा या आने वाले समय की तारीख होनी चाहिए. |
तारीख
कैलेंडर की पूरी या कुछ तारीख दिखाता है, जैसे कि जन्मदिन. दिन का समय और टाइम ज़ोन या तो किसी दूसरी जगह पर बताया गया है या बहुत कम है. तारीख ग्रिगॉरियन कैलेंडर के हिसाब से है. यह इनमें से किसी एक चीज़ को दिखा सकता है:
- साल, महीने, और दिन की वैल्यू के अलावा, पूरी तारीख.
- महीना और दिन, जिसमें कोई साल नहीं हो. उदाहरण के लिए, सालगिरह.
- अपने-आप में, साल की शुरुआत, जिसमें शून्य महीना और एक शून्य दिन होता है.
- साल और महीना, जिसमें शून्य दिन हो (उदाहरण के लिए, क्रेडिट कार्ड के खत्म होने की तारीख).
मिलते-जुलते टाइप:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
जेएसओएन के काेड में दिखाना |
---|
{ "year": integer, "month": integer, "day": integer } |
फ़ील्ड | |
---|---|
year |
तारीख का साल. 1 से 9999 के बीच होना चाहिए या बिना साल वाली तारीख बताने के लिए 0 होना चाहिए. |
month |
साल का महीना. बिना महीना और दिन के किसी साल के बारे में बताने के लिए, यह 1 से 12 के बीच होना चाहिए या 0 होना चाहिए. |
day |
महीने का दिन. 1 से 31 के बीच होना चाहिए और साल और महीने के लिए मान्य होना चाहिए या खुद में किसी साल या किसी साल और महीने के बारे में बताने के लिए 0 मान्य होना चाहिए, जिसमें दिन अहम नहीं होता है. |
FlightWithEmissions
उत्सर्जन के अनुमानों के साथ सीधी फ़्लाइट.
जेएसओएन के काेड में दिखाना |
---|
{ "flight": { object ( |
फ़ील्ड | |
---|---|
flight |
ज़रूरी है. अनुरोध में दिए गए फ़्लाइट आइडेंटिफ़ायर से मेल खाता है. ध्यान दें: सभी आईएटीए कोड कैपिटल लेटर में होते हैं. |
emissionsGramsPerPax |
ज़रूरी नहीं. हर यात्री के उत्सर्जन का अनुमान. अगर उत्सर्जन का हिसाब नहीं लगाया जा सकता, तो रिपोर्ट मौजूद नहीं होगी. उत्सर्जन की गिनती क्यों नहीं हो सकी, इसकी वजहों के बारे में जानने के लिए, [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions] देखें. |
EmissionsGramsPerPax
हर सीटिंग क्लास के नतीजों के हिसाब से, ग्रुप में होने वाले उत्सर्जन.
जेएसओएन के काेड में दिखाना |
---|
{ "first": integer, "business": integer, "premiumEconomy": integer, "economy": integer } |
फ़ील्ड | |
---|---|
first |
ग्राम में फ़र्स्ट क्लास के एक यात्री का उत्सर्जन. इस फ़ील्ड को हमेशा कंप्यूट किया जाता है और इससे भरे जाते हैं. इस बात से कोई फ़र्क़ नहीं पड़ता कि एयरक्राफ़्ट में फ़र्स्ट क्लास सीट हैं या नहीं. |
business |
बिज़नेस क्लास के एक यात्री का ग्राम में उत्सर्जन. इस फ़ील्ड को हमेशा कंप्यूट किया जाता है और इससे जानकारी अपने-आप भर जाती है. भले ही, एयरक्राफ़्ट में बिज़नेस क्लास की सीटें हों या नहीं. |
premiumEconomy |
ग्राम में, प्रीमियम इकॉनमी क्लास के लिए एक यात्री का उत्सर्जन. इस फ़ील्ड को हमेशा कंप्यूट किया जाता है और इसमें अपने-आप जानकारी भर जाती है. इस बात से कोई फ़र्क़ नहीं पड़ता कि एयरक्राफ़्ट में प्रीमियम इकॉनमी क्लास की सीटें हैं या नहीं. |
economy |
ग्राम में इकॉनमी क्लास के लिए, एक यात्री का उत्सर्जन. इस फ़ील्ड को हमेशा कंप्यूट किया जाता है और इससे अपने-आप जानकारी भर जाती है. इस बात से कोई फ़र्क़ नहीं पड़ता कि एयरक्राफ़्ट में इकॉनमी क्लास की सीटें हैं या नहीं. |
ModelVersion
ट्रैवल इंपैक्ट मॉडल का वर्शन. मॉडल वर्शनिंग के बारे में ज़्यादा जानकारी के लिए, https://github.com/google/travel-impact-model/#versioning देखें.
जेएसओएन के काेड में दिखाना |
---|
{ "major": integer, "minor": integer, "patch": integer, "dated": string } |
फ़ील्ड | |
---|---|
major |
मेजर वर्शन: काम करने के तरीके में बड़े बदलाव (उदाहरण के लिए, मॉडल में नए डेटा सोर्स जोड़ना, जिनकी वजह से आउटपुट में बड़े बदलाव होते हैं). ये बदलाव कभी-कभी किए जाएंगे और इनकी सूचना पहले ही दी जाएगी. इसमें एपीआई के वर्शन में हुए बदलाव शामिल हो सकते हैं, जो https://cloud.google.com/endpoints/docs/openapi/versioning-an-api#backwards-incompatible में दिए गए दिशा-निर्देशों का पालन करेंगे |
minor |
माइनर वर्शन: मॉडल में ऐसे बदलाव किए जाते हैं जिनमें सभी स्कीमा वर्शन में एक जैसा बदलाव करने के साथ-साथ, मॉडल के पैरामीटर या लागू करने की प्रोसेस में भी बदलाव होता है. |
patch |
पैच वर्शन: मॉडल लागू करने में आने वाली गड़बड़ियों या गड़बड़ियों को ठीक करने के लिए लागू किए गए बदलाव. |
dated |
तारीख वाले वर्शन: मॉडल डेटासेट, रीफ़्रेश किए गए इनपुट डेटा के साथ फिर से बनाए जाते हैं. हालांकि, एल्गोरिदम में नियमित तौर पर कोई बदलाव नहीं होता. |