אחזור של טבלת תחזית

‫GET https://contrails.googleapis.com/v2/grids: מקבלים רשת של תחזיות לגבי שובלי התעבות.

אם הפעולה בוצעה ללא שגיאות, התגובה תהיה קובץ NetCDF של ערכי כוח ההשפעה של ענני התעבות.

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

פרמטרים
time	string חובה. השעה שבה נשלחה הבקשה. פורמט: מחרוזת של תאריך ושעה בפורמט ISO 8601 או מספר שלם של חותמת זמן של מערכת Unix דוגמה: 2026-01-20T21:00:00Z
bbox[]	number אופציונלי. גבולות האזור שרוצים להחזיר. פורמט: [lng_min, lat_min, lng_max, lat_max] דוגמה: [-40, 20, 20, 60]
aircraftType	string אופציונלי. קוד המטוס. פורמט: קוד סוג כלי טיס של ICAO בן 4 תווים דוגמה: 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
  משתני נתונים
  פסי התעבות	(longitude, latitude, flight_level, time)	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:

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