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

‫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. הגבולות צריכים ליצור פוליגון תקין (למשל, ללא קודקודים כפולים וללא הצטלבות עצמית) אם נקודת הקצה (endpoint) הזו קיימת, היא תחזיר רק שובלי התעבות שחלק כלשהו שלהם חותך את המצולע התוחם. אם לא מציינים את המיקום, הפונקציה מחזירה שובל עיבוי שזוהה בלי קשר למיקום. פורמט: מערך מחרוזות לדוגמה: ["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"
        }
      }
    ]
  }