استرداد مناطق التوقعات

GET https://contrails.googleapis.com/v2/regions: الحصول على مناطق تجنُّب تشكّل السحب المتكاثفة بتنسيق GeoJSON متعدد الأضلاع

في حال نجاح العملية، ستكون الاستجابة FeatureCollection بتنسيق GeoJSON.

يتم تقييم المناطق التي يجب تجنُّب مسارات التكاثف فيها، والتي يتم عرضها بتنسيق مضلّع، حسب مستويات الخطورة، وتتراوح هذه المستويات بين 1 و4 لكل مستوى طيران. كلما زادت القيمة، زادت حدة أثر الطائرة.

مَعلمات طلب البحث

المعلمات
time	string الحقل مطلوب. وقت الطلب التنسيق: سلسلة التاريخ والوقت بتنسيق ISO 8601 أو عدد صحيح يمثل فترة يونكس مثلاً: 2026-01-20T21:00:00Z
flightLevel[]	integer اختياريّ. مستويات الرحلات الجوية المطلوب عرضها. في حال عدم تحديد مستوى رحلة، سيتم تضمين جميع مستويات الرحلات. التنسيق: مستويات الرحلات الجوية بالهكتوفيت [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440] مثلاً: [270, 280, 290, 300]
threshold	integer اختياريّ. الحد الأدنى لمستوى الخطورة. يؤدي ضبط هذا الحقل إلى عرض المناطق التي تكون فيها درجة الخطورة أكبر من أو تساوي الحدّ الأدنى. التنسيق: تتراوح القيم الصالحة من 1 إلى 4 (بما في ذلك).
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 جميع مناطق تجنُّب آثار التكاثف بتنسيق مضلّع:

  	علم الهندسة	flight_level	الحدّ	الوقت	forecast_reference_time	aircraft_class
  0	MULTIPOLYGON Z (((166.25 81.12 8229.6, 168.37 ...	270	1	2026-01-28T20:00:00+00:00	2026-01-27T08:00:00+00:00	المظهر التلقائي
  1	MULTIPOLYGON Z (((92.38 45.5 8229.6, 93 46.62 ...	270	2	2026-01-28T20:00:00+00:00	2026-01-27T08:00:00+00:00	المظهر التلقائي
  2	MULTIPOLYGON Z (((83.38 65 8229.6, 84 66.12 82...	270	3	2026-01-28T20:00:00+00:00	2026-01-27T08:00:00+00:00	المظهر التلقائي
  3	MULTIPOLYGON Z (((57.38 76 8229.6, 57.75 76.88...	270	4	2026-01-28T20:00:00+00:00	2026-01-27T08:00:00+00:00	المظهر التلقائي
  4	MULTIPOLYGON Z (((162.38 79 8534.4, 162.75 79....	280	1	2026-01-28T20:00:00+00:00	2026-01-27T08:00:00+00:00	المظهر التلقائي

• لاسترداد مناطق تجنُّب آثار التكاثف المحصورة بمستويات طيران معيّنة، مع تحديد الوقت كعدد صحيح لوقت بدء عصر Unix:

  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},
  )
  

• لاسترداد مناطق تجنُّب آثار التكاثف المحدودة بمستويات طيران معيّنة والتي تساوي أو تزيد عن مستوى خطورة 3:

  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},
  )