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

‫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-WEST-FULL-DISK,‏ 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"
      }
    }
  ]
}