Method: flights.computeScope3FlightEmissions

স্কোপ ৩ রিপোর্টিংয়ের জন্য ফ্লাইটের সেগমেন্টের সেট থেকে GHG নির্গমনের অনুমান সংক্রান্ত তথ্য নিয়ে আসে।

উত্তরে ইনপুট 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)

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

Scope3FlightSegment

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

JSON উপস্থাপনা 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
ফিল্ড
departureDate

object (Date)

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

enum (Scope3FlightSegment.CabinClass)

প্রয়োজনীয়। ফ্লাইটের কেবিন ক্লাস।
origin

string

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

string

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

string

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

integer

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

string (int64 format)

ঐচ্ছিক। কিলোমিটারে দূরত্ব, যেমন 2423, [1, 1e12) কিমি থেকে। এটি ব্যবহার করে ফ্লাইটের দূরত্ব-ভিত্তিক নির্গমন হিসেব করা হয়, যখন উৎস এবং গন্তব্য প্রদান করা হয় না বা কোনও সাধারণ ফ্লাইট মেলে না।

Scope3FlightSegment.CabinClass

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

Enums
CABIN_CLASS_UNSPECIFIED কেবিন ক্লাস উল্লেখ করা নেই।
ECONOMY ইকোনমি ক্লাস।
PREMIUM_ECONOMY প্রিমিয়াম ইকোনমি ক্লাস।
BUSINESS বিজনেস ক্লাস।
FIRST ফার্স্ট ক্লাস।

Scope3FlightEmissions

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

JSON উপস্থাপনা 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType),
  "modelVersion": string
}
ফিল্ড
flight

object (Scope3FlightSegment)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

enum (Scope3FlightEmissions.Scope3DataType)

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

string

ঐচ্ছিক। মডেলের যে ভার্সনের অধীনে নির্গমন গণনা করা হয়েছে।

Scope3FlightEmissions.Scope3DataType

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

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