اسناد

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

قالب داده

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

نمایش 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} : کد فرودگاه سه حرفی یاتا (مثلاً "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

کد یاتا شرکت هواپیمایی مربوط به پرواز (مثلاً "AA").

flightNumber

integer

شماره پرواز (مثلاً "123").

departureTime

string

تاریخ حرکت در منطقه زمانی فرودگاه مبدا با فرمت YYYYMMDD.

icao24

string

آدرس ۲۴ بیتی هواپیما در ایکائو

originAirport

string

کد فرودگاه مبدا یاتا

destinationAirport

string

کد فرودگاه مقصد یاتا

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)

زمان شروع بخش پروازی که ردپاها به آن نسبت داده می‌شوند. این برچسب زمانی بر حسب ثانیه UTC است.

endTime

string ( Timestamp format)

زمان پایان بخش پروازی که ردپیله‌ها به آن نسبت داده می‌شوند. این برچسب زمانی بر حسب ثانیه UTC است.

contrail

object ( ContrailAttributes )

ویژگی‌های Contrail برای این بخش خاص.

detectionEvidences[]

object ( ContrailDetectionEvidence )

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

attributionMethod

enum ( AttributionMethod )

فقط خروجی. روشی که برای نسبت دادن پس‌دمه‌ها به این بخش استفاده می‌شود (مثلاً مدل CoCiP یا مشاهده مستقیم).

longGapInterpolation

boolean

فقط خروجی. اگر مسیر پرواز قطعه با درون‌یابی در یک فاصله داده طولانی ADS-B (>5 دقیقه) ایجاد شده باشد، صحیح است.

waypointAttributions[]

object ( WaypointAttribution )

فقط خروجی. ویژگی‌های ردپا به ازای هر نقطه مسیر در سراسر این بخش نقشه‌برداری شده‌اند.

شواهد تشخیص مسیر

جزئیات مشاهده یک دنباله توسط یک ماهواره.

نمایش JSON 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
فیلدها
observationTime

string ( Timestamp format)

زمانی که تصویر ماهواره‌ای گرفته شده و در آن رد دنباله شناسایی شده است. این معمولاً زمان شروع اسکن است. این برچسب زمانی بر حسب ثانیه UTC است.

observedLengthMeters

integer

طول سر تا سر مشاهده شده از ویژگی خطی پس‌دمه بر حسب متر، همانطور که در تصویر ماهواره‌ای مشخص شده توسط observationTime شناسایی شده است. این طول می‌تواند با lengthMeters در SegmentAttribution.contrail متفاوت باشد زیرا:

  • ممکن است رد دنباله در جو بین تشکیل و مشاهده، تکامل یافته باشد (مثلاً پخش شده، طولانی‌تر شده و غیره).
  • الگوریتم انتساب تنها توانست با اطمینان بخشی از این ردپا را به این پرواز نسبت دهد.
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 داده‌های حاصل از اسکن کامل دیسک هیماواری.

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

انتساب نقطه مسیر

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

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

string ( Timestamp format)

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

contrailAttributes

object ( ContrailAttributes )

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

روش انتساب

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

انوم‌ها
ATTRIBUTION_METHOD_OBSERVATION انتساب صرفاً با تطبیق با ردیابی‌های ردپای ماهواره‌ای حاصل شده است.
ATTRIBUTION_METHOD_COCIP انتساب‌ها صرفاً بر مدل‌سازی CoCiP مبتنی بر فیزیک متکی هستند.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

انتساب ترکیبی با ترکیب پیش‌بینی‌های مدل CoCiP که توسط تشخیص‌های ماهواره‌ای تنظیم شده‌اند.

  • با تشخیص‌ها: اگر detectionEvidences وجود داشته باشد، رد دنباله پیش‌بینی و با مشاهده تأیید شده و وزن گرمایشی افزایش یافته‌ای دریافت کرده است.
  • بدون تشخیص: اگر detectionEvidences وجود نداشته باشد، رد دنباله پیش‌بینی شده اما مشاهده نشده است، بنابراین گرمایش محاسبه‌شده بی‌اهمیت تلقی می‌شود.
ATTRIBUTION_METHOD_UNSPECIFIED روش نامشخص.

یادداشت‌ها

هر DataSource مرزهای متفاوتی برای پردازش نماهای مبتنی بر مشاهده استفاده می‌کند:

جعبه‌های محدودکننده پوشش ماهواره‌ای (نمای مسطح مرکاتور)

مجوز

داده‌های افشا شده توسط رابط برنامه‌نویسی کاربردی ContrailWatch Attributions تحت مجوز CC BY-NC 4.0 هستند.