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

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

ডেটা ফর্ম্যাট

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

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)
    }
  ],
  "visualizationUrl": string
}
ফিল্ড
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 এবং এনার্জি ফোর্সিং উভয়ই শূন্যে মূল্যায়ন করা হয়েছে।
  • যদি না থাকে: এই ফ্লাইটের জন্য কনট্রেল বিশ্লেষণ করা যায়নি।
    • সাধারণত ইনপুট ডেটা পর্যাপ্ত না হলে (যেমন, আবহাওয়ার ডেটা না থাকলে বা ফ্লাইট পাথ অনিশ্চিত হলে) এটি হয়।
    • এর অর্থ এই নয় যে কোনও কনট্রেল তৈরি হয়নি, এর অর্থ হল যে কোনও সিদ্ধান্ত নেওয়া যায়নি।
segments[]

object (SegmentAttribution)

প্রতি-সেগমেন্ট কন্ট্রেল অ্যাট্রিবিউশন। প্রতিটি এন্ট্রি ফ্লাইটের একটি নির্দিষ্ট সময়কালকে দেখায়, যার মধ্যে কন্ট্রেল(গুলি) তৈরি হয়েছে।
visualizationUrl

string

শুধুমাত্র আউটপুট। ContrailExplorer-এর ContrailWatch পৃষ্ঠায় এই ফ্লাইটের কন্ট্রেল অ্যাট্রিবিউশনের ইন্টার‍্যাক্টিভ ভিজ্যুয়ালাইজেশনের লিঙ্ক। এটি স্যাটেলাইটের মাধ্যমে শনাক্ত করা কন্ট্রেলের সাথে মিলে যাওয়া ফ্লাইটের পথ দেখায়।

ATTRIBUTION_VIEW_OBSERVATION ভিউ ব্যবহার করার সময় শুধু খুঁজে পাওয়া ফ্লাইটের জন্য পপুলেট করা হয়।

FlightDetails

উত্তরে দেখানো ফ্লাইট সংক্রান্ত তথ্যের সম্পূর্ণ সেট নির্ধারণ করে।

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

বিশ্লেষণ করা ফ্লাইটের দূরত্ব, মিটারে।

ContrailAttributes

ফ্লাইট বা ফ্লাইট সেগমেন্টের জন্য কন্ট্রেল অ্যাট্রিবিউট দেখায়।

JSON উপস্থাপনা 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
ফিল্ড
lengthMeters

integer

ফ্লাইট পাথের সাবসেটের দৈর্ঘ্য, মিটারে, যেখানে কনট্রেল দেখা গেছে। ফ্লাইটের ওয়েপয়েন্টের মধ্যে গ্রেট সার্কেল দূরত্ব হিসেবে এটি গণনা করা হয়।
effectiveEnergyForcingJoules

string (int64 format)

মোট কার্যকর কনট্রেল এনার্জি ফোর্সিং, জুলে। এটি 4D গ্রিডেড CoCiP পূর্বাভাস আউটপুট থেকে কার্যকর রেডিয়েটিভ ফোর্সিং এক্সট্র্যাক্ট করে এবং সেগুলিকে লিনিয়ারলি ইন্টারপোলেট করে পাওয়া যায়। এই পদ্ধতিতে পরিবর্তন হতে পারে।

SegmentAttribution

ফ্লাইটের নির্দিষ্ট সময়সীমার জন্য কন্ট্রেল অ্যাট্রিবিউশন দেখায়।

JSON উপস্থাপনা 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
ফিল্ড
startTime

string (Timestamp format)

ফ্লাইট সেগমেন্টের শুরুর সময় যার সাথে কনট্রেল অ্যাট্রিবিউট করা হয়েছে। এই টাইমস্ট্যাম্প UTC ইপক সেকেন্ডে দেখানো হয়।
endTime

string (Timestamp format)

ফ্লাইট সেগমেন্টের শেষ হওয়ার সময় যার সাথে কন্ট্রেল অ্যাট্রিবিউট করা হয়েছে। এই টাইমস্ট্যাম্প UTC ইপক সেকেন্ডে দেখানো হয়।
contrail

object (ContrailAttributes)

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

object (ContrailDetectionEvidence)

আলাদা আলাদা স্যাটেলাইট কনট্রেল শনাক্তকরণ যা এই ফ্লাইট সেগমেন্টের অ্যাট্রিবিউশনের প্রমাণ প্রদান করে।
attributionMethod

enum (AttributionMethod)

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

boolean

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

object (WaypointAttribution)

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

ContrailDetectionEvidence

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

JSON উপস্থাপনা 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
ফিল্ড
observationTime

string (Timestamp format)

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

integer

observationTime-এর মাধ্যমে নির্দিষ্ট করা স্যাটেলাইট ইমেজে শনাক্ত করা লিনিয়ার কনট্রেল ফিচারের এন্ড-টু-এন্ড দৈর্ঘ্য মিটারে পরিমাপ করা হয়। এই দৈর্ঘ্য SegmentAttribution.contrail-এ lengthMeters-এর থেকে আলাদা হতে পারে কারণ:

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

enum (DataSource)

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

DataSource

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

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

Enums
DATA_SOURCE_UNSPECIFIED ডেটা সোর্স উল্লেখ করা হয়নি।
GOES_EAST_FULL_DISK GOES-East ফুল ডিস্ক স্ক্যান থেকে পাওয়া ডেটা।
GOES_WEST_FULL_DISK GOES-West ফুল ডিস্ক স্ক্যান থেকে পাওয়া ডেটা।
MTG_000_FULL_DISK MTG-000 ফুল ডিস্ক স্ক্যান থেকে পাওয়া ডেটা।
HIMAWARI_FULL_DISK Himawari ফুল ডিস্ক স্ক্যান থেকে পাওয়া ডেটা।

Contrails API স্যাটেলাইট ইমেজ এগুলির উপর ভিত্তি করে তৈরি:

WaypointAttribution

ফ্লাইট সেগমেন্টে নির্দিষ্ট ওয়েপয়েন্টের জন্য কন্ট্রেল অ্যাট্রিবিউট দেখায়।

JSON উপস্থাপনা 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
ফিল্ড
time

string (Timestamp format)

UTC ইপক সেকেন্ডে ওয়েপয়েন্টের সময়।
contrailAttributes

object (ContrailAttributes)

এই নির্দিষ্ট ওয়েপয়েন্টে ম্যাপ করা কনট্রেল অ্যাট্রিবিউট।

AttributionMethod

অ্যাট্রিবিউশন করার জন্য ব্যবহৃত নির্দিষ্ট পদ্ধতি বা প্রণালী নির্ধারণ করে।

Enums
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-এর অধীনে লাইসেন্সপ্রাপ্ত।