استرداد عمليات الرصد

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

في حال نجاح العملية، سيكون الرد FeatureCollection بتنسيق GeoJSON. يُرجى العِلم أنّه من الممكن عرض FeatureCollection فارغ إذا كان النطاق الزمني خارج النطاق (مثل البحث عن آثار تكثّف مرصودة في المستقبل). بالإضافة إلى ذلك، لا يمكن ضمان اتّساق عمليات الرصد لأنّ نماذج الرصد يتم تعديلها ويتم إعادة ملء البيانات.

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

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

أمثلة

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

  response = requests.get(
    url="https://contrails.googleapis.com/v2/detections",
    params={"start_time": "2026-01-27T12:00:00Z",
            "end_time": "2026-01-27T12:10:00Z"},
    headers={"x-goog-api-key": API_KEY},
  )
  

• لاسترداد عمليات رصد آثار التكاثف في وقت معيّن، مع العلم أنّ النتائج تقتصر على عمليات الرصد التي أجراها القمر الصناعي Himawari:

  response = requests.get(
    url="https://contrails.googleapis.com/v2/detections",
    params={"start_time": "2026-01-27T12:00:00Z",
            "end_time": "2026-01-27T12:10:00Z",
            "satellite_origins": ["HIMAWARI-FULL-DISK"]}
    headers={"x-goog-api-key": API_KEY},
  )
  

  أو في CURL:

  curl "https://contrails.sandbox.googleapis.com/v2/detections?\
  key=API_KEY&\
  start_time=2026-01-27T12:00:00Z&\
  end_time=2026-01-27T12:10:00Z&\
  satellite_origins=HIMAWARI-FULL-DISK"
  

ستبدو الاستجابة الناجحة التي تتضمّن آثارًا تم رصدها بالشكل التالي:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            90.06765747070312,
            44.201324462890625
          ],
          [
            90.99974060058594,
            43.65225601196289
          ]
        ]
      },
      "properties": {
        "time": "2026-03-10T00:00:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            105.36386108398438,
            -1.7198446989059448
          ],
          [
            105.7318115234375,
            -2.5787696838378906
          ]
        ]
      },
      "properties": {
        "time": "2026-03-10T00:00:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    }
  ]
}