استرداد شبكة توقعات

‫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 اختياريّ. رمز الطائرة التنسيق: رمز نوع الطائرة المكوّن من 4 أحرف وفقًا لمنظمة الطيران المدني الدولي (ICAO) مثلاً: A320
flightLevel[]	integer اختياريّ. مستويات الرحلات الجوية المطلوب عرضها. في حال عدم تحديد مستوى رحلة، سيتم تضمين جميع مستويات الرحلات. التنسيق: مستويات الرحلات الجوية بالهكتوفيت [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440] مثلاً: [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، يعرض مجموعة البيانات التالية:

  الأبعاد: (خط الطول: 1441، خط العرض: 721، مستوى الطيران: 18، الوقت: 1)
  الإحداثيات
  الاسم	الأبعاد	نوع البيانات	القيم
  longitude	(خط الطول)	float32	‎-180.0 -179.8 ... 179.8 1...‎
  latitude	(خط العرض)	float32	‎-90.0 -89.75 -89.5 ... 8...‎
  flight_level	(flight_level)	int16	270 280 290 300 ... 41...
  الوقت	(الوقت)	datetime64[ns]	2026-01-28T20:00:00
  forecast_reference_time	(الوقت)	datetime64[ns]	2026-01-27T08:00:00
  متغيّرات البيانات
  مسارات التكاثف	(خط الطول، خط العرض، مستوى الطيران، الوقت)	float32	0.0 0.0 0.0 0.0 ... 0.0 ...
  السمات
  inference_pipeli...		contrails.forecast-pipeline_20260115.02_p0
  api_version :		contrails.api-service_20260125.00_p0
  aircraft_class :		المظهر التلقائي

• لاسترداد شبكة تقتصر على حدود جغرافية معيّنة ويتم فلترتها حسب نوع طائرة معيّن، مع تحديد الوقت كعدد صحيح بتنسيق 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},
  )