Method: flights.computeScope3FlightEmissions

স্কোপ ৩ রিপোর্টিংয়ের জন্য একগুচ্ছ ফ্লাইট সেগমেন্টের জিএইচজি নির্গমনের আনুমানিক হিসাব সংগ্রহের একটি স্টেটলেস পদ্ধতি।

প্রতিক্রিয়াটিতে ইনপুট Scope3FlightSegment ফ্লাইট সেগমেন্টগুলির সাথে মেলে এমন সমস্ত এন্ট্রি, প্রদত্ত একই ক্রমে থাকবে। নিম্নলিখিত ক্যাসকেডিং লজিক ব্যবহার করে অনুমানগুলি গণনা করা হবে (উপলব্ধ প্রথমটি ব্যবহার করে):

  1. origin , destination , carrier , flightNumber , departureDate এবং cabinClass দেওয়া থাকলে TIM-ভিত্তিক নির্গমন।
  2. origin , destination , departureDate ও বছর এবং cabinClass দেওয়া থাকলে একটি ফ্লাইটের সাধারণ নির্গমন।
  3. distanceKm , departureDate বছর এবং cabinClass ব্যবহার করে দূরত্ব-ভিত্তিক নির্গমন গণনা করা হয়।

এই ক্যালেন্ডার বছরে যদি কোনো ভবিষ্যৎ ফ্লাইটের অনুরোধ করা হয়, তাহলে আমরা টিয়ার ১ এমিশন সমর্থন করি না এবং টিয়ার ২ বা ৩ এমিশন ব্যবহার করব। অনুরোধ করা ভবিষ্যৎ ফ্লাইটটি যদি এই ক্যালেন্ডার বছরের মধ্যে না হয়, তাহলে আমরা একটি খালি প্রতিক্রিয়া ফেরত দেব। আমরা সুপারিশ করি যে ভবিষ্যৎ ফ্লাইটের জন্য এর পরিবর্তে computeFlightEmissions API ব্যবহার করা হোক।

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

নিম্নলিখিত ক্ষেত্রে অনুরোধটি INVALID_ARGUMENT ত্রুটির সাথে ব্যর্থ হবে:

  • অনুরোধটিতে ১,০০০টিরও বেশি ফ্লাইট লেগ রয়েছে।
  • ইনপুট ফ্লাইট লেগে এক বা একাধিক শনাক্তকারী অনুপস্থিত। উদাহরণস্বরূপ, TIM_EMISSIONS বা TYPICAL_FLIGHT_EMISSIONS ধরনের মিলের জন্য বৈধ দূরত্ব ছাড়া উৎস/গন্তব্য অনুপস্থিত, অথবা DISTANCE_BASED_EMISSIONS ধরনের মিলের জন্য দূরত্ব অনুপস্থিত (যদি আপনি দূরত্ব-ভিত্তিক নির্গমনে ফিরে যেতে চান বা দূরত্ব-ভিত্তিক নির্গমনের একটি অনুমান চান, তাহলে আপনাকে একটি দূরত্ব নির্দিষ্ট করতে হবে)।
  • ফ্লাইটটির তারিখ ২০১৯ সালের আগের (স্কোপ ৩ ডেটা শুধুমাত্র ২০১৯ এবং তার পরের জন্য উপলব্ধ)।
  • উড্ডয়নের দূরত্ব ০ বা তার কম।
  • কেবিন ক্লাস অনুপস্থিত।

যেহেতু অনুরোধটি ফলব্যাক লজিক ব্যবহার করে প্রক্রিয়া করা হয়, তাই এমনটা হতে পারে যে ভুলভাবে কনফিগার করা অনুরোধগুলোও ফলব্যাক পদ্ধতি ব্যবহার করে সঠিক নির্গমনের হিসাব ফেরত দেবে। উদাহরণস্বরূপ, যদি কোনো অনুরোধে ভুল ফ্লাইট নম্বর থাকে কিন্তু উৎস এবং গন্তব্য নির্দিষ্ট করা থাকে, তাহলে অনুরোধটি সফল হবে, কিন্তু ফেরত আসা নির্গমনের হিসাবটি শুধুমাত্র সাধারণ ফ্লাইট নির্গমনের উপর ভিত্তি করে হবে। একইভাবে, যদি একটি সাধারণ ফ্লাইট নির্গমনের অনুরোধে উৎস উল্লেখ না থাকে, কিন্তু একটি সঠিক দূরত্ব নির্দিষ্ট করা থাকে, তাহলে অনুরোধটি শুধুমাত্র দূরত্ব-ভিত্তিক নির্গমনের উপর ভিত্তি করে সফল হতে পারে। ফলস্বরূপ, ফলাফল প্রত্যাশিত কিনা তা নিশ্চিত করার জন্য ফেরত আসা নির্গমনের উৎস ( source ) পরীক্ষা করা উচিত।

HTTP অনুরোধ

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

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "flights": [
    {
      object (Scope3FlightSegment)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
ক্ষেত্র
flights[]

object ( Scope3FlightSegment )

প্রয়োজনীয়। ফ্লাইটগুলোর জন্য নির্গমনের আনুমানিক হিসাব ফেরত দিতে হবে।

modelVersion

object ( ModelVersion )

ঐচ্ছিক। এই অনুরোধের সমস্ত ফ্লাইটের জন্য নির্গমন অনুমান যে মডেল সংস্করণের অধীনে গণনা করা হয়েছিল।

প্রতিক্রিয়া সংস্থা

স্কোপ ৩ নির্গমন অনুমানসহ ফ্লাইটগুলোর একটি তালিকা।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "flightEmissions": [
    {
      object (Scope3FlightEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
ক্ষেত্র
flightEmissions[]

object ( Scope3FlightEmissions )

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

modelVersion

object ( ModelVersion )

এই প্রতিক্রিয়ায় সমস্ত ফ্লাইটের নির্গমন অনুমান যে মডেল সংস্করণের অধীনে গণনা করা হয়েছিল।

স্কোপ৩ফ্লাইটসেগমেন্ট

ফ্লাইট প্যারামিটার, যার মাধ্যমে স্কোপ ৩ নির্গমন সংগ্রহ করা হয়।

JSON উপস্থাপনা 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
ক্ষেত্র
departureDate

object ( Date )

আবশ্যক। উৎস বিমানবন্দরের সময় অঞ্চল অনুযায়ী ফ্লাইটের তারিখ। সাধারণ ফ্লাইট এবং দূরত্ব-ভিত্তিক নির্গমন মডেলের জন্য শুধুমাত্র বছর প্রয়োজন (মাস এবং দিনের মান উপেক্ষা করা হয় এবং তাই, সেগুলি বাদ দেওয়া যেতে পারে, ০ সেট করা যেতে পারে, অথবা সেই ক্ষেত্রে একটি বৈধ তারিখ সেট করা যেতে পারে)। একইভাবে, TIM নির্গমনের জন্য যদি কোনো নির্দিষ্ট তারিখ প্রদান করা না হয়, তাহলে আমরা সাধারণ ফ্লাইট (বা দূরত্ব-ভিত্তিক) নির্গমনে ফিরে যাব।

cabinClass

enum ( CabinClass )

আবশ্যক। ফ্লাইটের কেবিন শ্রেণি।

origin

string

ঐচ্ছিক। ফ্লাইটের উৎসস্থলের জন্য ৩-অক্ষরের IATA এয়ারপোর্ট কোড , যেমন YVR । গন্তব্য, বিমান সংস্থা এবং ফ্লাইট নম্বরের সাথে এটি প্রদান করা হলে, নির্দিষ্ট ফ্লাইট মেলানোর জন্য এটি ব্যবহৃত হয়। যদি কোনো মিল না পাওয়া যায়, আমরা প্রথমে প্রদত্ত উৎস এবং গন্তব্য বিমানবন্দরের মধ্যে চলাচলকারী একটি সাধারণ ফ্লাইটের সাথে ফ্লাইটটিকে মেলানোর চেষ্টা করব। অন্যথায়, ফ্লাইটের দূরত্ব প্রদান করা হলে আমরা দূরত্ব-ভিত্তিক নির্গমন মডেলটি ব্যবহার করব।

destination

string

ঐচ্ছিক। ফ্লাইটের গন্তব্যের জন্য ৩-অক্ষরের IATA এয়ারপোর্ট কোড , যেমন ICN । উৎস, বাহক এবং ফ্লাইট নম্বরের সাথে এটি প্রদান করা হলে, নির্দিষ্ট ফ্লাইট মেলানোর জন্য এটি ব্যবহৃত হয়। যদি কোনো মিল না পাওয়া যায়, আমরা প্রথমে প্রদত্ত উৎস এবং গন্তব্য বিমানবন্দরের মধ্যে চলাচলকারী একটি সাধারণ ফ্লাইটের সাথে ফ্লাইটটিকে মেলানোর চেষ্টা করব। অন্যথায়, ফ্লাইটের দূরত্ব প্রদান করা হলে আমরা দূরত্ব-ভিত্তিক নির্গমন মডেলটি ব্যবহার করব।

carrierCode

string

ঐচ্ছিক। ২-অক্ষরের IATA ক্যারিয়ার কোড , যেমন KE । নির্দিষ্ট ফ্লাইট মেলানোর প্রয়োজন হলে এটি আবশ্যক। অন্যথায়, সাধারণ ফ্লাইট এবং দূরত্ব-ভিত্তিক নির্গমন মডেলের জন্য এটি অব্যবহৃত থাকে। এটি অপারেটিং এবং মার্কেটিং উভয় ক্যারিয়ার কোডই হতে পারে (অর্থাৎ কোডশেয়ার এর আওতাভুক্ত)।

flightNumber

integer

ঐচ্ছিক। সর্বোচ্চ ৪-অঙ্কের ফ্লাইট নম্বর , যেমন 71 , [১, ৯৯৯৯] পরিসর থেকে। যদি উৎস, গন্তব্য এবং বিমান সংস্থার পাশাপাশি একটি ফ্লাইট নম্বর উল্লেখ করা থাকে, তবে একটি নির্দিষ্ট ফ্লাইট মেলানোর জন্য এটি প্রথমে ব্যবহৃত হয়। যদি কোনো ফ্লাইট নম্বর উল্লেখ না করা থাকে, তবে আমরা প্রথমে প্রদত্ত উৎস এবং গন্তব্য বিমানবন্দরের মধ্যে চলাচলকারী একটি সাধারণ ফ্লাইটের সাথে ফ্লাইটটিকে মেলানোর চেষ্টা করব। যদি সেটি ব্যর্থ হয় এবং/অথবা উৎস ও গন্তব্য প্রদান করা না থাকে, তবে আমরা প্রদত্ত ফ্লাইটের দূরত্বের উপর ভিত্তি করে দূরত্ব-ভিত্তিক নির্গমন মডেলটি ব্যবহার করব।

distanceKm

string ( int64 format)

ঐচ্ছিক। দূরত্ব কিলোমিটারে, যেমন 2423 , [১, ২.৫e১৬) কিমি পরিসর থেকে। যখন উৎস এবং গন্তব্য প্রদান করা হয় না বা কোনো মিলযুক্ত সাধারণ ফ্লাইট পাওয়া যায় না, তখন দূরত্ব-ভিত্তিক নির্গমনের সাথে একটি ফ্লাইট মেলানোর জন্য এটি ব্যবহৃত হয়।

কেবিন ক্লাস

উড়ানটির কেবিন শ্রেণি।

এনাম
CABIN_CLASS_UNSPECIFIED অনির্দিষ্ট কেবিন শ্রেণী।
ECONOMY ইকোনমি ক্লাস।
PREMIUM_ECONOMY প্রিমিয়াম ইকোনমি ক্লাস।
BUSINESS বিজনেস ক্লাস।
FIRST প্রথম শ্রেণি।

স্কোপ৩ফ্লাইটএমিশনস

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

JSON উপস্থাপনা 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3DataType)
}
ক্ষেত্র
flight

object ( Scope3FlightSegment )

শনাক্তকারী। অনুরোধে থাকা ফ্লাইট শনাক্তকারীগুলোর সাথে মেলে।

wtwEmissionsGramsPerPax

string ( int64 format)

ঐচ্ছিক। অনুরোধকৃত তথ্যের উপর ভিত্তি করে প্রতি যাত্রীর জন্য মোট ফ্লাইট নির্গমন (ওয়েল-টু-ট্যাঙ্ক এবং ট্যাঙ্ক-টু-ওয়েক-এর যোগফল)। এটি হলো মোট নির্গমন এবং TTW বা WTT নির্গমন ব্যবহার করার জন্য আপনার নির্দিষ্ট কোনো কারণ না থাকলে, আপনার এই সংখ্যাটিই ব্যবহার করা উচিত।

ttwEmissionsGramsPerPax

string ( int64 format)

ঐচ্ছিক। অনুরোধকৃত তথ্যের উপর ভিত্তি করে প্রতি যাত্রীর জন্য ট্যাংক থেকে উড্ডয়ন পর্যন্ত নির্গমন।

wttEmissionsGramsPerPax

string ( int64 format)

ঐচ্ছিক। অনুরোধকৃত তথ্যের উপর ভিত্তি করে প্রতি যাত্রীর জন্য ওয়েল-টু-ট্যাঙ্ক ফ্লাইট নির্গমন।

source

enum ( Scope3DataType )

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

স্কোপ৩ডেটাটাইপ

স্কোপ ৩ নির্গমন গণনা করতে ব্যবহৃত মিলকরণের ধরণ। এটি স্কোপ ৩ প্রতিক্রিয়ার জন্য ব্যবহৃত হয়, যা নির্দেশ করে যে নির্গমন গণনা করতে কোন পদ্ধতিটি ব্যবহার করা হয়েছিল।

এনাম
SCOPE3_DATA_TYPE_UNSPECIFIED অনির্দিষ্ট ডেটা টাইপ।
TIM_EMISSIONS উৎস, গন্তব্য, বাহক, ফ্লাইট নম্বর, প্রস্থানের তারিখ এবং বছর দেওয়া থাকলে TIM-ভিত্তিক নির্গমন।
TYPICAL_FLIGHT_EMISSIONS উৎস, গন্তব্য এবং বছর দেওয়া থাকলে ফ্লাইটের সাধারণ নির্গমন।
DISTANCE_BASED_EMISSIONS অতিক্রান্ত দূরত্ব এবং বছরের উপর ভিত্তি করে নির্গমন।