ارجاع‌ها

بخش‌های پس‌دمه منسوب‌شده برای فهرست خاصی از پروازها.

قالب داده‌ها

درخواست‌های مربوط به پس‌دمه‌های منسوب حاوی داده‌هایی با ساختار زیر است:

نمایش 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

فقط خروجی. پیوند به تجسم تعاملی از انتساب پس‌دمه این پرواز در صفحه ContrailWatch در ContrailExplorer. این مدل مسیر پرواز را با پس‌دمه‌های شناسایی‌شده توسط ماهواره‌ها مطابقت می‌دهد.

فقط برای پروازهای پیداشده هنگام استفاده از نمای 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)

مجموع انرژی مؤثر پس‌دمه، به ژول. این مقدار با استخراج واداشت تابشی مؤثر از بروندادهای پیش‌بینی 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 شناسایی شده است. این طول ممکن است با lengthMeters در SegmentAttribution.contrail متفاوت باشد زیرا:

  • ممکن است پس‌دمه در فاصله زمانی بین تشکیل و مشاهده در جو تکامل یافته باشد (مثلاً پخش شده باشد، طولانی‌تر شده باشد، و غیره).
  • الگوریتم اِسناد فقط توانست بخشی از این پس‌دمه را با اطمینان به این پرواز نسبت دهد.
dataSource

enum (DataSource)

فقط خروجی. منبع داده‌های ماهواره‌ای استفاده‌شده برای این تشخیص.

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 داده‌های اسکن‌های دیسک کامل Himawari.

تصاویر ماهواره‌ای Contrails API براساس موارد زیر است:

WaypointAttribution

نشان‌دهنده مشخصه‌های پس‌دمه برای نقطه‌مسیر خاصی در بخش پرواز است.

نمایش JSON 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
فیلدها
time

string (Timestamp format)

زمان در نقطه‌مسیر برحسب ثانیه مبدأ UTC.
contrailAttributes

object (ContrailAttributes)

مشخصه‌های پس‌دمه که در این نقطه‌مسیر خاص نگاشت شده است.

AttributionMethod

رویه یا روش‌شناسی خاصی را که برای نسبت دادن استفاده شده است تعریف می‌کند.

شمارشی‌ها
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 است.