استرداد أقنعة الرصد

GET https://contrails.googleapis.com/v2/detections/masks: الحصول على أقنعة رصد آثار التكاثف بتنسيق NetCDF4

في حال نجاح هذا الإجراء، ستكون الاستجابة عبارة عن ملف NetCDF يتضمّن أقنعة رصد آثار التكاثف.

ملاحظة: أقنعة رصد المحتوى من إنشاء الذكاء الاصطناعي التوليدي قيد التجربة وهي قابلة للتغيير.

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

المعلمات
start_time	string الحقل مطلوب. وقت بدء الطلب التنسيق: سلسلة التاريخ والوقت ISO 8601 مثلاً: 2026-01-20T21:00:00Z
end_time	string الحقل مطلوب. وقت انتهاء الطلب (شامل) يُرجى العِلم أنّ end_time يجب ألا تتجاوز start_time بأكثر من ساعة واحدة. التنسيق: سلسلة التاريخ والوقت ISO 8601 مثلاً: 2026-01-20T22:00:00Z
satellite_origin	string اختياريّ. القيم الصالحة هي GOES-EAST-FULL-DISK وHIMAWARI-FULL-DISK وMTG-000-FULL-DISK، وهي تمثّل الأقمار الصناعية GOES_EAST وHimawari وMTG على التوالي. التنسيق: سلسلة مثلاً: "GOES-EAST-FULL-DISK"

أمثلة

• لاسترداد أقنعة الرصد من قمر صناعي في وقت محدّد، اتّبِع الخطوات التالية:

  response = requests.get(
    url="https://contrails.googleapis.com/v2/detections/masks",
    params={"start_time": "2026-04-10T00:00:00Z",
            "end_time": "2026-04-10T01:00:00Z",
            "satellite_origin": "MTG-000-FULL-DISK"},
    headers={"x-goog-api-key": API_KEY},
  )
  

  أو في CURL:

  curl "https://contrails.sandbox.googleapis.com/v2/detections/masks?\
  key=API_KEY&\
  start_time=2026-04-10T00:00:00Z&\
  end_time=2026-04-10T01:00:00Z&\
  satellite_origin=MTG-000-FULL-DISK"
  

  عند تحميلها باستخدام xarray، يعرض هذا الطلب مجموعة البيانات التالية:

  الأبعاد: (الوقت: 6، ص: 5568، س: 5568)
  الإحداثيات
  الاسم	الأبعاد	نوع البيانات	القيم
  الوقت	(الوقت)	datetime64[ns]	‫2026-04-10T00:00:07 ... 2026-04-10T00:50:07
  y	(y)	float32	5.569e+06 5.567e+06 ... -5.569e+06
  x	(x)	float32	‎-5.569e+06 -5.567e+06 ... 5.569e+06
  متغيّرات البيانات
  كمامة	(الوقت، y، x)	float32	0.0 0.0 0.0 0.0 ... 0.0 ...
  projection	()	DataArray	+proj=geos +lon_0=0 +h=35786400 +x_0=0 +y_0=0 +a=6378137 +b=6356752.3 +units=m +no_defs

  يُرجى العِلم أنّ projection منسَّق كسلسلة من عناصر pyproj.Proj.

  يمكن استخدام projection للتحويل بين إحداثيات x وy على الخريطة وإحداثيات خط الطول وخط العرض.