Method: flights.computeScope3FlightEmissions

স্কোপ 3 রিপোর্টিংয়ের জন্য ফ্লাইট বিভাগের একটি সেটের জন্য GHG নির্গমন অনুমান পুনরুদ্ধার করার জন্য রাষ্ট্রহীন পদ্ধতি।

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

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

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

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

অনুরোধটি একটি INVALID_ARGUMENT ত্রুটির সাথে ব্যর্থ হবে যদি:

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

যেহেতু অনুরোধটি ফলব্যাক লজিক দিয়ে প্রক্রিয়া করা হয়েছে, এটা সম্ভব যে ভুল কনফিগার করা অনুরোধ ফলব্যাক পদ্ধতি ব্যবহার করে বৈধ নির্গমন অনুমান ফেরত দেয়। উদাহরণস্বরূপ, যদি একটি অনুরোধের ভুল ফ্লাইট নম্বর থাকে কিন্তু উত্স এবং গন্তব্য নির্দিষ্ট করে, তবে অনুরোধটি এখনও সফল হবে, তবে ফেরত নির্গমনগুলি শুধুমাত্র সাধারণ ফ্লাইট নির্গমনের উপর ভিত্তি করে হবে৷ একইভাবে, যদি একটি অনুরোধে একটি সাধারণ ফ্লাইট নির্গমন অনুরোধের মূল অনুপস্থিত থাকে, কিন্তু একটি বৈধ দূরত্ব নির্দিষ্ট করে, তবে অনুরোধটি শুধুমাত্র দূরত্ব-ভিত্তিক নির্গমনের উপর ভিত্তি করে সফল হতে পারে। ফলস্বরূপ, প্রত্যাশিত ফলাফলগুলি নিশ্চিত করার জন্য ফেরত নির্গমনের উত্স ( 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 )

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

প্রতিক্রিয়া শরীর

স্কোপ 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

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

destination

string

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

carrierCode

string

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

flightNumber

integer

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

distanceKm

string ( int64 format)

ঐচ্ছিক। দূরত্ব কিলোমিটারে, যেমন 2423 । এটি একটি ফ্লাইটকে দূরত্ব-ভিত্তিক নির্গমনের সাথে মেলানোর জন্য ব্যবহৃত হয় যখন উত্স এবং গন্তব্য সরবরাহ করা হয় না বা কোনও মিলিত সাধারণ ফ্লাইট নেই। এই ক্ষেত্রটি 0 এবং 2.5e16 কিলোমিটারের মধ্যে মান সমর্থন করে।

কেবিনক্লাস

ফ্লাইটের কেবিন ক্লাস।

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)

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

ttwEmissionsGramsPerPax

string ( int64 format)

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

wttEmissionsGramsPerPax

string ( int64 format)

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

source

enum ( Scope3DataType )

ঐচ্ছিক। নির্গমন ডেটার উত্স।

Scope3DataType

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

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