بازیابی مناطق پیش‌بینی‌شده

GET https://contrails.googleapis.com/v2/regions : مناطق اجتناب از پسدمه را با فرمت چندچندضلعی GeoJSON دریافت کنید.

در صورت موفقیت، پاسخ یک FeatureCollection با فرمت GeoJSON خواهد بود.

مناطق اجتناب از ردپای بازگشتی در قالب چندضلعی با سطوح شدت، از ۱ تا ۴ برای هر سطح پرواز، رتبه‌بندی می‌شوند. هرچه مقدار بالاتر باشد، ردپای شدیدتر است.

پارامترهای پرس و جو

پارامترها
time

string

الزامی. زمان درخواست.

قالب: رشته تاریخ و زمان ISO 8601 یا عدد صحیح عصر یونیکس

مثال: 2026-01-20T21:00:00Z

flightLevel[]

integer

اختیاری. سطوح پرواز برای بازگشت. اگر هیچ سطح پروازی مشخص نشده باشد، تمام سطوح پروازی شامل می‌شوند.

قالب: سطوح پروازی بر حسب هکتوفیت؛ [۲۷۰، ۲۸۰، ۲۹۰، ۳۰۰، ۳۱۰، ۳۲۰، ۳۳۰، ۳۴۰، ۳۵۰، ۳۶۰، ۳۷۰، ۳۸۰، ۳۹۰، ۴۰۰، ۴۱۰، ۴۲۰، ۴۳۰، ۴۴۰]

مثال: [270, 280, 290, 300]

threshold

integer

اختیاری. آستانه حداقل سطح شدت. تنظیم این فیلد فقط مناطقی را که شدت آنها بزرگتر یا مساوی آستانه است، برمی‌گرداند.

قالب: مقادیر معتبر از ۱ تا ۴ (شامل) متغیر هستند.

aircraftClass

string

اختیاری. کلاس هواپیما. در حال حاضر، فقط default پشتیبانی می‌شود.

مثال‌ها

  • برای بازیابی تمام مناطق اجتناب از رد دنباله‌ها برای یک نقطه زمانی خاص:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={"time": 2026-01-27T12:00:00Z},
  headers={"x-goog-api-key": API_KEY},
)

    پاسخ GeoJSON تمام مناطق اجتناب از ردپیله را در قالب چندضلعی فهرست می‌کند:

    هندسه سطح_پرواز آستانه زمان زمان مرجع پیش‌بینی کلاس_هواپیما
    0 چندضلعی Z (((166.25 81.12 8229.6, 168.37 ... ۲۷۰ ۱ ‎2026-01-28T20:00:00+00:00‎ ‎2026-01-27T08:00:00+00:00‎ پیش‌فرض
    ۱ چندضلعی Z (((۹۲.۳۸ ۴۵.۵ ۸۲۲۹.۶، ۹۳ ۴۶.۶۲ ...)) ۲۷۰ ۲ ‎2026-01-28T20:00:00+00:00‎ ‎2026-01-27T08:00:00+00:00‎ پیش‌فرض
    ۲ چندضلعی Z (((۸۳.۳۸ ۶۵ ۸۲۲۹.۶، ۸۴ ۶۶.۱۲ ۸۲... ۲۷۰ ۳ ‎2026-01-28T20:00:00+00:00‎ ‎2026-01-27T08:00:00+00:00‎ پیش‌فرض
    ۳ چندضلعی Z (((57.38 76 8229.6, 57.75 76.88...)) ۲۷۰ ۴ ‎2026-01-28T20:00:00+00:00‎ ‎2026-01-27T08:00:00+00:00‎ پیش‌فرض
    ۴ چندضلعی Z (((162.38 79 8534.4, 162.75 79....)) ۲۸۰ ۱ ‎2026-01-28T20:00:00+00:00‎ ‎2026-01-27T08:00:00+00:00‎ پیش‌فرض

  • برای بازیابی مناطق اجتناب از ردپیله که محدود به سطوح پروازی خاص هستند، با زمان مشخص شده به عنوان یک عدد صحیح Unix epoch:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 1768942800,
    "flightLevel": [300,310,320,330]
  },
  headers={"x-goog-api-key": API_KEY},
)

  • برای بازیابی مناطق اجتناب از رد دنباله که محدود به سطوح پروازی خاص و برابر یا بالاتر از آستانه سطح شدت ۳ هستند:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 2026-01-27T12:00:00Z,
    "flightLevel": [300,310,320,330],
    "threshold": 3
  },
  headers={"x-goog-api-key": API_KEY},
)