אחזור אזורים של תחזיות

‫GET https://contrails.googleapis.com/v2/regions: קבלת אזורים להימנעות מפסים של מטוסים בפורמט GeoJSON multipolygon.

אם הפעולה בוצעה ללא שגיאות, התגובה תהיה FeatureCollection בפורמט GeoJSON.

אזורים שבהם מומלץ להימנע מטיסה כדי למנוע פסי התעבות, שמוחזרים בפורמט פוליגון, מדורגים לפי רמות חומרה, מ-1 עד 4 לכל רמת טיסה. ככל שהערך גבוה יותר, כך שובל האדים חמור יותר.

פרמטרים של שאילתה

פרמטרים
time	string חובה. השעה שבה נשלחה הבקשה. פורמט: מחרוזת של תאריך ושעה בפורמט ISO 8601 או מספר שלם של חותמת זמן של מערכת Unix דוגמה: 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},
  )