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

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

في حال نجاح العملية، ستكون الاستجابة FeatureCollection بتنسيق GeoJSON.

الإحداثيات التي يتم عرضها هي خط الطول وخط العرض لنقاط نهاية عملية الرصد التي تم تحويلها إلى خط مستقيم، والتي تم إسقاطها على سطح الأرض من منظور القمر الصناعي. بالنسبة إلى عمليات الرصد التي تجريها الأقمار الصناعية GOES، تتضمّن الإحداثيات المعروضة اختياريًا قيم الارتفاعات المتوقّعة.

سيؤدي طلب البحث عن عمليات رصد ضمن نطاق زمني خارج النطاق، مثل وقت محدّد في المستقبل، إلى عرض 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"]
bounds[]	string اختياريّ. قائمة بأزواج السلاسل النصية، يجب أن يكون كل منها بالتنسيق "خط العرض، خط الطول"، لتحديد رؤوس مضلّع محيط. في حال توفّرها، يجب تحديد ثلاث bounds على الأقل. يجب أن تشكّل الحدود مضلّعًا صالحًا (على سبيل المثال، بدون رؤوس مكرّرة أو تقاطع ذاتي). عند توفّرها، ستعرض نقطة النهاية هذه فقط آثار الطائرات التي تتقاطع مع أي جزء من المضلّع المحيط. في حال عدم توفّرها، تعرض هذه السمة الطائرات النفاثة التي تم رصدها بغض النظر عن الموقع الجغرافي. التنسيق: مصفوفة السلاسل النصية مثلاً: ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]

أمثلة

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

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

• لاسترداد جميع عمليات رصد آثار التكاثف خلال فترة زمنية محدّدة، مع تحديدها بمضلّع محيط:

  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",
            "bounds": ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]},
    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.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"
  

  يعرض ردّ GeoJSON لهذا الطلب بيانات رصد آثار التكاثف من أقمار Himawari الاصطناعية للنطاق الزمني المطلوب:

  {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "LineString",
          "coordinates": [
            [
              90.06765747070312,
              44.201324462890625
            ],
            [
              90.99974060058594,
              43.65225601196289
            ]
          ]
        },
        "properties": {
          "time": "2026-01-27T12: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-01-27T12:10:00+00:00",
          "satellite_origin": "HIMAWARI-FULL-DISK"
        }
      }
    ]
  }