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

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", "persistent_formation_probability", "nominal_cocip_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},
  )
  

• إذا أردت استرداد شبكة تتضمّن متغيّرات البيانات contrails وpersistent_formation_probability وnominal_cocip_effective_energy_forcing، اتّبِع الخطوات التالية:

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