Method: flights.computeFlightEmissions

নির্গমন অনুমান পুনরুদ্ধারের জন্য স্টেটলেস পদ্ধতি। নির্গমন অনুমান কীভাবে গণনা করা হয় তার বিশদ বিবরণ গিটহাবে রয়েছে।

প্রতিক্রিয়াটিতে ইনপুট করা ফ্লাইট লেগগুলির সাথে মেলে এমন সমস্ত এন্ট্রি একই ক্রমে থাকবে। যদি কোনো নির্দিষ্ট ফ্লাইট লেগের জন্য কোনো অনুমান উপলব্ধ না থাকে, তাহলে প্রতিক্রিয়াটি খালি এমিশন ফিল্ড সহ ফ্লাইট লেগ অবজেক্টটি ফেরত দেবে। অনুরোধটি তবুও সফল বলে বিবেচিত হবে। এমিশন অনুমান অনুপস্থিত থাকার কারণগুলির মধ্যে রয়েছে:

  • ফ্লাইটটি সার্ভারের কাছে অজানা।
  • ইনপুট ফ্লাইট লেগে এক বা একাধিক শনাক্তকারী অনুপস্থিত।
  • ফ্লাইটের তারিখটি অতীত হয়ে গেছে।
  • মডেলটি বিমানের ধরণটি সমর্থন করে না।
  • আসন বিন্যাস অনুপস্থিত।

অনুরোধটিতে সর্বোচ্চ ১০০০টি ফ্লাইট লেগ থাকতে পারে। যদি অনুরোধটিতে ১০০০টির বেশি সরাসরি ফ্লাইট থাকে, তবে এটি INVALID_ARGUMENT ত্রুটির কারণে ব্যর্থ হবে।

HTTP অনুরোধ

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

URL-টিতে 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

আবশ্যক। ফ্লাইটের উৎসস্থলের IATA বিমানবন্দর কোড, যেমন 'LHR'।

destination

string

প্রয়োজনীয়। ফ্লাইটের গন্তব্যস্থলের জন্য IATA এয়ারপোর্ট কোড, যেমন "JFK"।

operatingCarrierCode

string

আবশ্যক। IATA ক্যারিয়ার কোড, যেমন 'AA'।

flightNumber

integer

প্রয়োজনীয়। ফ্লাইট নম্বর, যেমন ৩২৪।

departureDate

object ( Date )

আবশ্যক। উৎস বিমানবন্দরের সময় অঞ্চল অনুযায়ী ফ্লাইটের তারিখ। তারিখটি অবশ্যই বর্তমান বা ভবিষ্যতের হতে হবে।

ফ্লাইটউইথএমিশনস

নির্গমন অনুমান সহ সরাসরি ফ্লাইট।

JSON উপস্থাপনা
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
ক্ষেত্র
flight

object ( Flight )

শনাক্তকারী। অনুরোধে থাকা ফ্লাইট শনাক্তকারীগুলোর সাথে মেলে। দ্রষ্টব্য: সমস্ত IATA কোড বড় হাতের অক্ষরে লেখা হয়।

source

enum ( Source )

ঐচ্ছিক। নির্গমন তথ্যের উৎস।

emissionsGramsPerPax

object ( EmissionsGramsPerPax )

ঐচ্ছিক। যাত্রীপ্রতি আনুমানিক নির্গমনের সংখ্যা। নির্গমন গণনা করা না গেলে এটি উপস্থিত থাকবে না। যে কারণগুলোর জন্য নির্গমন গণনা করা যায়নি, তার তালিকার জন্য flights.computeFlightEmissions দেখুন।

easaLabelMetadata

object ( EasaLabelMetadata )

ঐচ্ছিক। EASA ফ্লাইট নির্গমন লেবেল সম্পর্কিত মেটাডেটা। শুধুমাত্র তখনই সেট করতে হবে যখন নির্গমন ডেটার উৎস EASA হয়।

contrailsImpactBucket

enum ( ContrailsImpactBucket )

ঐচ্ছিক। মোট CO2e নির্গমনের প্রভাবের তুলনায় কনট্রেইলের উষ্ণায়ন প্রভাবের তাৎপর্য।

উৎস

নির্গমন তথ্যের উৎস।

এনাম
SOURCE_UNSPECIFIED নির্গমন তথ্যের উৎস অনির্দিষ্ট।
TIM নির্গমনের তথ্য ট্র্যাভেল ইমপ্যাক্ট মডেল থেকে নেওয়া হয়েছে।
EASA নির্গমনের তথ্য EASA-এর পরিবেশগত লেবেল থেকে নেওয়া হয়েছে।

EasaLabelMetadata

EASA ফ্লাইট নির্গমন লেবেল সম্পর্কিত মেটাডেটা।

JSON উপস্থাপনা
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
ক্ষেত্র
labelIssueDate

object ( Date )

লেবেলটি ইস্যু করার তারিখ।

labelExpiryDate

object ( Date )

লেবেলটির মেয়াদ শেষ হওয়ার তারিখ। এই তারিখের শেষ পর্যন্ত লেবেলটি প্রদর্শন করা যাবে।

labelVersion

string

লেবেলের সংস্করণ।

safDiscountPercentage

number

টেকসই বিমান জ্বালানি (SAF) নির্গমন ছাড়ের শতাংশ যা লেবেলে প্রয়োগ করা হয়। এটি দশমিক আকারে একটি শতাংশ। এর মান [0,1] ব্যবধির মধ্যে থাকে। উদাহরণস্বরূপ, 0.0021 মানে 0.21%।

এই ছাড় এবং নির্গমন হ্রাসের বিষয়টি EASA লেবেলে উল্লেখ করা হলেও, এই API দ্বারা বিতরণ করা CO2e অনুমানে তা অন্তর্ভুক্ত করা হয় না।

কন্ট্রেইলস ইমপ্যাক্ট বাকেট

মোট CO2e নির্গমনের প্রভাবের তুলনায় কনট্রেইলের উষ্ণায়ন প্রভাবের তাৎপর্য।

এনাম
CONTRAILS_IMPACT_UNSPECIFIED কনট্রেইলের প্রভাব অনির্দিষ্ট।
CONTRAILS_IMPACT_NEGLIGIBLE মোট CO2e নির্গমনের তুলনায় কনট্রেইলের প্রভাব নগণ্য।
CONTRAILS_IMPACT_MODERATE ধোঁয়ার কুণ্ডলীর প্রভাব মোট CO2e নির্গমনের সমতুল্য।
CONTRAILS_IMPACT_SEVERE ধোঁয়ার কুণ্ডলীর প্রভাব মোট CO2e নির্গমনের প্রভাবের চেয়ে বেশি।