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

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-WEST-FULL-DISK وGOES-EAST-FULL-DISK وHIMAWARI-FULL-DISK وMTG-000-FULL-DISK، وهي تمثّل الأقمار الصناعية GOES_WEST وGOES_EAST وHimawari وMTG على التوالي. التنسيق: سلسلة مثلاً: "GOES-EAST-FULL-DISK"
view	DetectionMaskView اختياريّ. القيمة التلقائية هي DETECTION_MASK_VIEW_UNSPECIFIED. إذا كانت القيمة DETECTION_MASK_VIEW_FULL، سيتم تضمين إزاحات القمر الصناعي للقرص الكامل (بالثواني) في الردّ. التنسيق: يُرجى الاطّلاع على المستندات مثلاً: DETECTION_MASK_VIEW_BASIC

أمثلة

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

  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"
            "view": "DETECTION_MASK_VIEW_FULL"},
    headers={"x-goog-api-key": API_KEY},
  )
  

  أو في CURL:

  curl "https://contrails.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&\
  view=DETECTION_MASK_VIEW_FULL"
  

  عند تحميلها باستخدام 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 ...
  scantime_offset	(الوقت، y، x)	float64	nan nan nan nan ... 564. ‫568. ...
  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 على الخريطة وإحداثيات خط الطول وخط العرض.

DetectionMaskView

تحدّد هذه السمة مستوى التفاصيل المطلوب عرضه لأقنعة الرصد.

عمليات التعداد
DETECTION_MASK_VIEW_UNSPECIFIED	طريقة عرض غير محدّدة في الواقع، يتم التعامل مع هذا النوع على أنّه BASIC.
DETECTION_MASK_VIEW_BASIC	يحتوي على قيم قناع الرصد وبيانات إسقاط القمر الصناعي.
DETECTION_MASK_VIEW_FULL	يحتوي على قيم قناع الرصد وبيانات إسقاط القمر الصناعي وإزاحات وقت المسح للقرص الكامل.