Algılamaları alma

GET https://contrails.googleapis.com/v2/detections: GeoJSON LineString biçiminde yoğuşma izi algılamalarını alın.

Başarılı olursa yanıt, GeoJSON biçiminde bir FeatureCollection olur. Zaman aralığı kapsam dışındaysa (ör. gelecekte tespit edilen yoğunlaşma izleri aranıyorsa) boş bir FeatureCollection döndürmenin mümkün olduğunu unutmayın. Ayrıca, algılama modelleri güncellendikçe ve veriler yeniden doldurulduğunda algılamaların tutarlı olacağı garanti edilmez.

Sorgu parametreleri

Parametreler
start_time

string

Zorunlu. İsteğin başlangıç zamanı.

Biçim: ISO 8601 tarih saat dizesi

Örnek: 2026-01-20T21:00:00Z
end_time

string

Zorunlu. İsteğin bitiş zamanı (dahil). end_time değerinin start_time değerini 24 saatten fazla aşamayacağını unutmayın.

Biçim: ISO 8601 tarih saat dizesi

Örnek: 2026-01-20T22:00:00Z
satellite_origins[]

string

İsteğe bağlı. Geçerli değerler sırasıyla GOES_EAST, Himawari ve MTG uydularını temsil eden GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK ve MTG-000-FULL-DISK şeklindedir.

Sağlanırsa bu uç nokta satellite_origins içinde belirtilen uydulardan yalnızca algılanan yoğunlaşma izlerini döndürür.

Sağlanmazsa geçerli tüm uydu verisi sağlayıcılarından algılanan yoğunlaşma izlerini döndürür.

Biçim: dize dizisi

Örnek: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]

Örnekler

  • Belirli bir zamandaki tüm uçak izi tespitlerini almak için:

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

  • Belirli bir zamana ait, Himawari algılamalarıyla sınırlı olmak üzere uçak izi algılamalarını almak için:

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

    veya CURL'de:

    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"

Yoğunlaşma izlerinin algılandığı başarılı bir yanıt şu şekilde görünür:

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