গুণাবলী

একটি নির্দিষ্ট ফ্লাইট তালিকার জন্য নির্ধারিত কনট্রেইল অংশসমূহ।

ডেটা ফরম্যাট

অ্যাট্রিবিউটেড কনট্রেইলের অনুরোধে নিম্নলিখিত কাঠামোযুক্ত ডেটা থাকে:

JSON উপস্থাপনা 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
ক্ষেত্র
attributions[]

object ( Attribution )

BatchGetAttributionsRequest.names এ নির্দিষ্ট করা প্রতিটি রিসোর্স নামের জন্য একটি করে অ্যাট্রিবিউশনের তালিকা। এই তালিকার অ্যাট্রিবিউশনগুলোর ক্রম BatchGetAttributionsRequest এর নামগুলোর ক্রমের সাথে মিলবে। যদি কোনো ফ্লাইট খুঁজে না পাওয়া যায়, তাহলে রেসপন্সের সংশ্লিষ্ট অ্যাট্রিবিউশন মেসেজে শুধুমাত্র name ফিল্ডটি পূরণ করা থাকবে, এবং flightDetails ' ও contrail খালি থাকবে।

অ্যাট্রিবিউশন

এটি একটি নির্দিষ্ট ফ্লাইটের জন্য একটি সামগ্রিক কনট্রেইল ঘটনাকে উপস্থাপন করে, যা এর সাথে সম্পর্কিত সমস্ত কনট্রেইল অংশকে (যেমন, মোট কিলোমিটার এবং শক্তি) সংক্ষিপ্ত আকারে তুলে ধরে।

JSON উপস্থাপনা 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
ক্ষেত্র
name

string

শনাক্তকারী। ফ্লাইটটির রিসোর্স নাম।

বিন্যাস:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

উপাদানসমূহ:

  • {carrier} : ২-অক্ষরের IATA ক্যারিয়ার কোড (যেমন, "AA" , "UA" )।
  • {flightNumber} : ১-৪ অঙ্কের ফ্লাইট নম্বর (যেমন, "123" )।
  • {departure_date} : উৎস বিমানবন্দরের স্থানীয় সময় অনুযায়ী YYYY-MM-DD ফরম্যাটে ফ্লাইট ছাড়ার তারিখ।
  • {departure_airport} : ৩-অক্ষরের IATA বিমানবন্দর কোড (যেমন, "JFK" , "LHR" )।
flightDetails

object ( FlightDetails )

এই ফ্লাইটটির বিস্তারিত তথ্য।

contrail

object ( ContrailAttributes )

সম্পূর্ণ ফ্লাইটের জন্য একত্রিত কনট্রেইল বৈশিষ্ট্যসমূহ। এটি সমস্ত বৈশিষ্ট্য-নির্ধারিত সেগমেন্টের কনট্রেইল বৈশিষ্ট্যগুলোকে যোগ করে।

রাষ্ট্রীয় ব্যাখ্যা (একটি প্রাপ্ত ফ্লাইটের মধ্যে):

  • উপস্থিত থাকলে: কন্ট্রেইল বিশ্লেষণ করা হয়েছে। ContrailAttributes ভেতরের ফিল্ডগুলো ফলাফল নির্দেশ করে (যেমন, lengthMeters > 0 মানে কন্ট্রেইল চিহ্নিত করা হয়েছে)। যদি একটি খালি ContrailAttributes বার্তা উপস্থিত থাকে, তার মানে হলো বিশ্লেষণ করা হলেও lengthMeters এবং energy forcing উভয়ের মানই শূন্য এসেছে।
  • অনুপস্থিত থাকলে: এই ফ্লাইটের জন্য কন্ট্রেইল বিশ্লেষণ করা সম্ভব হয়নি।
    • এর সাধারণ কারণ হলো অপর্যাপ্ত ইনপুট ডেটা (যেমন, আবহাওয়ার তথ্যের অভাব বা ফ্লাইট পথের অনিশ্চয়তা)।
    • এর মানে এই নয় যে কোনো কনট্রেইল তৈরি হয়নি, বরং এ বিষয়ে কোনো সিদ্ধান্ত নেওয়া সম্ভব হয়নি।

segments[]

object ( SegmentAttribution )

প্রতিটি অংশের জন্য কনট্রেইলের কারণ নির্ণয়। প্রতিটি এন্ট্রি ফ্লাইটের একটি স্বতন্ত্র সময়কালকে নির্দেশ করে, যে সময়কালের জন্য কনট্রেইল(গুলি)কে দায়ী করা হয়েছে।

ফ্লাইট বিবরণ

প্রতিক্রিয়ায় ফেরত আসা ফ্লাইট তথ্যের সম্পূর্ণ সেট নির্ধারণ করে।

JSON উপস্থাপনা 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
ক্ষেত্র
carrier

string

ফ্লাইটটির IATA ক্যারিয়ার কোড (যেমন "AA")।

flightNumber

integer

ফ্লাইটটির ফ্লাইট নম্বর (যেমন "১২৩")।

departureTime

string

যাত্রার তারিখ, উৎস বিমানবন্দরের সময় অঞ্চল অনুযায়ী YYYYMMDD বিন্যাসে।

icao24

string

ICAO ২৪-বিট বিমানের ঠিকানা

originAirport

string

IATA উৎস বিমানবন্দর কোড।

destinationAirport

string

IATA গন্তব্য বিমানবন্দর কোড।

callSign

string

বিমানের কলসাইন। এই ফিল্ডটিতে অগ্রাধিকার ভিত্তিতে এয়ার ট্রাফিক কন্ট্রোল (ATC) যোগাযোগে ব্যবহৃত কলসাইনটি থাকে। যদি নির্দিষ্ট ATC কলসাইনটি উপলব্ধ না থাকে অথবা এটি স্ট্যান্ডার্ড ফ্লাইট ডিজাইনেটরের সমান হয়, তাহলে এই ফিল্ডটিতে স্ট্যান্ডার্ড ফ্লাইট ডিজাইনেটরটি থাকে (যা সাধারণত বাণিজ্যিক ফ্লাইটের ক্ষেত্রে এয়ারলাইন কোড এবং ফ্লাইট নম্বরের একটি সমন্বয়)।

analyzedFlightDistanceMeters

integer

উড়ানের বিশ্লেষিত দূরত্ব, মিটারে।

কন্ট্রেইল অ্যাট্রিবিউটস

একটি ফ্লাইট বা ফ্লাইট সেগমেন্টের কনট্রেইল বৈশিষ্ট্যসমূহ উপস্থাপন করে।

JSON উপস্থাপনা 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
ক্ষেত্র
lengthMeters

integer

ফ্লাইট পথের যে অংশ(গুলো)র জন্য কনট্রেইল চিহ্নিত করা হয়েছে, তার দৈর্ঘ্য (মিটারে)। এটি ফ্লাইট ওয়েপয়েন্টগুলোর মধ্যবর্তী গ্রেট সার্কেল দূরত্ব হিসেবে গণনা করা হয়।

effectiveEnergyForcingJoules

string ( int64 format)

মোট কার্যকর কনট্রেইল শক্তি বল, জুল এককে। এটি ৪ডি গ্রিডেড CoCiP পূর্বাভাস আউটপুট থেকে কার্যকর বিকিরণ বল নিষ্কাশন করে এবং সেগুলোকে রৈখিকভাবে ইন্টারপোলেট করে নির্ণয় করা হয়। এই কার্যপ্রণালী পরিবর্তন সাপেক্ষ।

সেগমেন্ট অ্যাট্রিবিউশন

এটি একটি ফ্লাইটের নির্দিষ্ট সময়কালের জন্য কনট্রেইলের বৈশিষ্ট্য নির্দেশ করে।

JSON উপস্থাপনা 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
ক্ষেত্র
startTime

string ( Timestamp format)

যে ফ্লাইট সেগমেন্টের জন্য কনট্রেইলগুলো চিহ্নিত করা হয়, তার শুরুর সময়। এই টাইমস্ট্যাম্পটি ইউটিসি ইপক সেকেন্ডে দেওয়া হয়।

endTime

string ( Timestamp format)

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

contrail

object ( ContrailAttributes )

এই নির্দিষ্ট সেগমেন্টের জন্য কন্ট্রেইল অ্যাট্রিবিউটসমূহ।

detectionEvidences[]

object ( ContrailDetectionEvidence )

স্বতন্ত্র স্যাটেলাইট কনট্রেইল শনাক্তকরণ, যা এই ফ্লাইট সেগমেন্টটির সাথে এর সংযোগের প্রমাণ দেয়।

attributionMethod

enum ( AttributionMethod )

শুধুমাত্র আউটপুট। এই সেগমেন্টের জন্য কনট্রেইল নির্ধারণে ব্যবহৃত পদ্ধতি (যেমন, CoCiP মডেল বা সরাসরি পর্যবেক্ষণ)।

longGapInterpolation

boolean

শুধুমাত্র আউটপুট। যদি সেগমেন্ট ফ্লাইট পাথটি একটি দীর্ঘ ADS-B ডেটা গ্যাপ (>৫ মিনিট) জুড়ে ইন্টারপোলেশনের মাধ্যমে তৈরি করা হয়ে থাকে, তবে এটি সত্য হবে।

waypointAttributions[]

object ( WaypointAttribution )

শুধুমাত্র আউটপুট। এই অংশ জুড়ে প্রতিটি ওয়েপয়েন্টের কনট্রেইল বৈশিষ্ট্য ম্যাপ করা হয়েছে।

কন্ট্রেইল ডিটেকশন এভিডেন্স

কনট্রেইলের একটিমাত্র স্যাটেলাইট পর্যবেক্ষণের বিবরণ।

JSON উপস্থাপনা 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
ক্ষেত্র
observationTime

string ( Timestamp format)

যে স্যাটেলাইট চিত্রে কনট্রেইলটি শনাক্ত করা হয়েছিল, সেটি তোলার সময়। এটি সাধারণত স্ক্যান শুরুর সময়। এই টাইমস্ট্যাম্পটি ইউটিসি ইপক সেকেন্ডে দেওয়া হয়।

observedLengthMeters

integer

observationTime দ্বারা নির্দিষ্ট স্যাটেলাইট চিত্রে শনাক্তকৃত রৈখিক কনট্রেইল বৈশিষ্ট্যটির পর্যবেক্ষিত প্রান্ত থেকে প্রান্ত পর্যন্ত দৈর্ঘ্য (মিটারে)। এই দৈর্ঘ্যটি SegmentAttribution.contrail এর lengthMeters থেকে ভিন্ন হতে পারে, কারণ:

  • তৈরি হওয়া এবং পর্যবেক্ষণের মধ্যবর্তী সময়ে বায়ুমণ্ডলে কনট্রেইলটির বিবর্তন ঘটে থাকতে পারে (যেমন, এটি ছড়িয়ে পড়া বা দীর্ঘায়িত হওয়া ইত্যাদি)।
  • অ্যাট্রিবিউশন অ্যালগরিদমটি এই কনট্রেইলের কেবল একটি অংশকেই আত্মবিশ্বাসের সাথে এই ফ্লাইটটির সাথে যুক্ত করতে সক্ষম হয়েছিল।
dataSource

enum ( DataSource )

শুধুমাত্র আউটপুট। এই শনাক্তকরণের জন্য ব্যবহৃত স্যাটেলাইট ডেটার উৎস।

ডেটা উৎস

কনট্রেইল শনাক্তকরণের জন্য ব্যবহৃত স্যাটেলাইট ডেটার উৎস। ভবিষ্যতে অতিরিক্ত মান যোগ করা হতে পারে।

উপলব্ধ স্যাটেলাইট ডেটা আউটপুটগুলোর মধ্যে, GOES East- এবং Himawari-ভিত্তিক অ্যাট্রিবিউশনগুলোর মান প্রোডাকশন-স্তরের, অপরদিকে MTG-ভিত্তিক অ্যাট্রিবিউশনগুলো এখনও বিটা পর্যায়ে রয়েছে এবং এর মানোন্নয়নের জন্য সক্রিয়ভাবে কাজ চলছে।

এনাম
DATA_SOURCE_UNSPECIFIED অনির্দিষ্ট ডেটা উৎস।
GOES_EAST_FULL_DISK GOES-East সম্পূর্ণ ডিস্ক স্ক্যান থেকে প্রাপ্ত ডেটা।
GOES_WEST_FULL_DISK GOES-West সম্পূর্ণ ডিস্ক স্ক্যান থেকে প্রাপ্ত ডেটা।
MTG_000_FULL_DISK MTG-000 সম্পূর্ণ ডিস্ক স্ক্যান থেকে প্রাপ্ত ডেটা।
HIMAWARI_FULL_DISK হিমাওয়ারি সম্পূর্ণ ডিস্ক স্ক্যান থেকে প্রাপ্ত ডেটা।

কন্ট্রেইলস এপিআই স্যাটেলাইট চিত্রাবলী নিম্নলিখিত বিষয়ের উপর ভিত্তি করে তৈরি:

ওয়েপয়েন্ট অ্যাট্রিবিউশন

একটি ফ্লাইট সেগমেন্টের কোনো নির্দিষ্ট ওয়েপয়েন্টের কনট্রেইল বৈশিষ্ট্যসমূহ উপস্থাপন করে।

JSON উপস্থাপনা 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
ক্ষেত্র
time

string ( Timestamp format)

ওয়েপয়েন্টের সময়, ইউটিসি ইপক সেকেন্ডে।

contrailAttributes

object ( ContrailAttributes )

এই নির্দিষ্ট ওয়েপয়েন্টে কনট্রেইলের বৈশিষ্ট্যগুলো ম্যাপ করা হয়েছে।

অ্যাট্রিবিউশন পদ্ধতি

আরোপণ করার জন্য ব্যবহৃত নির্দিষ্ট কার্যপ্রণালী বা পদ্ধতিকে সংজ্ঞায়িত করে।

এনাম
ATTRIBUTION_METHOD_OBSERVATION স্যাটেলাইট থেকে প্রাপ্ত কনট্রেইল শনাক্তকরণের সাথে কঠোরভাবে মিলিয়েই এর উৎস নির্ধারণ করা হয়েছে।
ATTRIBUTION_METHOD_COCIP সম্পূর্ণরূপে পদার্থবিদ্যা-চালিত CoCiP মডেলিংয়ের ওপর নির্ভরশীল অ্যাট্রিবিউশন।
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

স্যাটেলাইট শনাক্তকরণের মাধ্যমে সমন্বয়কৃত CoCiP মডেলের পূর্বাভাসকে একত্রিত করে হাইব্রিড অ্যাট্রিবিউশন।

  • সনাক্তকরণের সাথে: যদি detectionEvidences উপস্থিত থাকে, তাহলে কনট্রেইলটি পূর্বাভাসিত ছিল এবং পর্যবেক্ষণের মাধ্যমে নিশ্চিত হয়েছে, এবং এটি বর্ধিত উষ্ণায়ন ওজন লাভ করে।
  • শনাক্তকরণ ছাড়া: যদি detectionEvidences অনুপস্থিত থাকে, তাহলে কনট্রেইলটির পূর্বাভাস দেওয়া হলেও তা পর্যবেক্ষণ করা যায়নি, তাই গণনাকৃত উষ্ণায়ন অগ্রাহ্য করা হয়।
ATTRIBUTION_METHOD_UNSPECIFIED অনির্দিষ্ট পদ্ধতি।

নোট

প্রতিটি DataSource পর্যবেক্ষণ-ভিত্তিক ভিউ প্রক্রিয়াকরণের জন্য ভিন্ন ভিন্ন সীমা ব্যবহার করে:

স্যাটেলাইট কভারেজ বাউন্ডিং বক্স (ফ্ল্যাট মারকেটর ভিউ)

লাইসেন্স

ContrailWatch Attributions API দ্বারা প্রকাশিত ডেটা CC BY-NC 4.0 লাইসেন্সের অধীনে রয়েছে।