אחזור זיהויים

‫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"
      }
    }
  ]
}