Method: flights.computeScope3FlightEmissions

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

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

  1. TIM-ভিত্তিক নির্গমনের origin , destination , carrier , flightNumber , departureDate এবং cabinClass উল্লেখ করা হয়েছে।
  2. origin , destination , departureDate বছর তারিখ এবং cabinClass ভিত্তিতে সাধারণ ফ্লাইট নির্গমন।
  3. দূরত্ব-ভিত্তিক নির্গমন গণনা করা হয়েছে distanceKm , year in 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 সম্পর্কে

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

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

object ( Date )

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

cabinClass

enum ( CabinClass )

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

origin

string

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

destination

string

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

carrierCode

string

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

flightNumber

integer

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

distanceKm

string ( int64 format)

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

কেবিনক্লাস

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

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

Scope3FlightEmirations সম্পর্কে

নির্গমন অনুমান সহ স্কোপ 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 সম্পর্কে

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

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