بازیابی شبکه پیش‌بینی

GET https://contrails.googleapis.com/v2/grids : شبکه‌ای از پیش‌بینی‌های پس‌دمه‌ها را دریافت کنید.

در صورت موفقیت، پاسخ یک NetCDF از مقادیر نیروی پسدمه خواهد بود.

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

پارامترها
time	string الزامی. زمان درخواست. قالب: رشته تاریخ و زمان ISO 8601 یا عدد صحیح عصر یونیکس مثال: 2026-01-20T21:00:00Z
bbox[]	number اختیاری. مرزهای منطقه برای بازگشت. قالب: [lng_min، lat_min، lng_max، lat_max] مثال: [-40, 20, 20, 60]
aircraftType	string اختیاری. کد هواپیما. قالب: کد نوع هواپیمای ایکائو ۴ کاراکتری مثال: A320
flightLevel[]	integer اختیاری. سطوح پرواز برای بازگشت. اگر هیچ سطح پروازی مشخص نشده باشد، تمام سطوح پروازی شامل می‌شوند. قالب: سطوح پروازی بر حسب هکتوفیت؛ [۲۷۰، ۲۸۰، ۲۹۰، ۳۰۰، ۳۱۰، ۳۲۰، ۳۳۰، ۳۴۰، ۳۵۰، ۳۶۰، ۳۷۰، ۳۸۰، ۳۹۰، ۴۰۰، ۴۱۰، ۴۲۰، ۴۳۰، ۴۴۰] مثال: [270, 280, 290, 300]
format	string اختیاری. قالب درخواستی. ارسال مقداری غیر از 'netcdf4' خطای UNIMPLEMENTED را ایجاد می‌کند زیرا چندضلعی‌ها پشتیبانی نمی‌شوند.
aircraftClass	string اختیاری. کلاس هواپیما. در حال حاضر، فقط default پشتیبانی می‌شود.
data[]	string اختیاری. این فیلد مشخص می‌کند که کدام متغیرهای داده در پاسخ گنجانده شوند. می‌تواند یک یا چند متغیر داده را مدیریت کند. اگر این فیلد خالی باشد یا ارائه نشده باشد، به طور پیش‌فرض روی ["contrails"] تنظیم می‌شود. مثال: ["contrails", "expected_effective_energy_forcing"]

مثال‌ها

• برای بازیابی شبکه‌ی پیش‌فرضِ ردپای جهانی برای یک نقطه‌ی زمانی خاص:

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

  وقتی این درخواست با xarray بارگذاری شود، مجموعه داده زیر را برمی‌گرداند:

  ابعاد: (طول جغرافیایی: ۱۴۴۱، عرض جغرافیایی: ۷۲۱، سطح پرواز: ۱۸، زمان: ۱)
  مختصات
  نام	ابعاد	نوع داده	ارزش‌ها
  طول جغرافیایی	(طول جغرافیایی)	شناور32	۱۸۰.۰ -۱۷۹.۸ ... ۱۷۹.۸ ۱...
  عرض جغرافیایی	(عرض جغرافیایی)	شناور32	-۹۰.۰ -۸۹.۷۵ -۸۹.۵ ... ۸ ...
  سطح_پرواز	(سطح_پرواز)	عدد صحیح ۱۶	۲۷۰ ۲۸۰ ۲۹۰ ۳۰۰ ... ۴۱ ...
  زمان	(زمان)	تاریخ و زمان64[ns]	‎2026-01-28T20:00:00‎
  زمان مرجع پیش‌بینی	(زمان)	تاریخ و زمان64[ns]	‎2026-01-27T08:00:00‎
  متغیرهای داده
  ردپاها	(طول جغرافیایی، عرض جغرافیایی، سطح پرواز، زمان)	شناور32	۰.۰ ۰.۰ ۰.۰ ۰.۰ ۰.۰ ... ۰.۰ ...
  ویژگی‌ها
  لوله استنتاج...		خطوط لوله پیش‌بینی جریان‌های نامنظم (contrails)_20260115.02_p0
  نسخه api :		contrails.api-service_20260125.00_p0
  کلاس_هواپیما :		پیش‌فرض

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

  response = requests.get(
    url="https://contrails.googleapis.com/v2/grids",
    params={"time": 1769508160,
            "bbox": [-40, 20, 20, 60],
            "aircraftType": "A320"
            },
    headers={"x-goog-api-key": API_KEY},
  )
  

• برای بازیابی یک شبکه محدود به زیرمجموعه‌ای از سطوح پرواز و یک منطقه خاص با لایه‌های contrails و لایه‌های expected_effective_energy_forcing :

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