Algılamaları alma

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

Başarılı olursa yanıt, GeoJSON biçiminde bir FeatureCollection olur.

Döndürülen koordinatlar, doğrusal hale getirilmiş algılamanın uç noktalarının boylam ve enlemidir. Bu noktalar, uydunun bakış açısından Dünya yüzeyine yansıtılır. GOES algılamaları için döndürülen koordinatlar, isteğe bağlı olarak tahmin edilen yükseklik değerlerini de içerir.

Kapsam dışı bir zaman aralığıyla (ör. gelecekteki bir zaman) yapılan sorgularda boş bir FeatureCollection döndürülür.

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 süresinin start_time süresini 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.

Bu uç nokta mevcut olduğunda yalnızca satellite_origins içinde belirtilen uydulardan algılanan yoğunlaşma izlerini döndürür.

Mevcut olmadığında, geçerli tüm uydu verisi sağlayıcılarından tespit edilen yoğunlaşma izlerini döndürür.

Biçim: dize dizisi

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

string

İsteğe bağlı. Her biri "enlem,boylam" biçiminde olması gereken ve sınırlayıcı bir çokgenin köşelerini belirten dize çiftleri listesi.

Bu özellik varsa en az üç bounds belirtilmelidir. Sınırlar geçerli bir poligon oluşturmalıdır (ör.yinelenen köşe noktası veya kendi kendini kesme olmamalıdır).

Bu uç nokta mevcut olduğunda yalnızca sınırlayıcı poligonun herhangi bir bölümüyle kesişen algılanan yoğunlaşma izlerini döndürür.

Bu parametre mevcut olmadığında, konumdan bağımsız olarak tespit edilen yoğunlaşma izlerini döndürür.

Biçim: dize dizisi

Örnek: ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]

Örnekler

  • Belirli bir zaman aralığındaki 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},
)

  • Sınırlayıcı çokgenle sınırlı olarak belirli bir zaman aralığındaki 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",
          "bounds": ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]},
  headers={"x-goog-api-key": API_KEY},
)

  • Belirli bir zaman aralığına ait, Himawari algılamalarıyla sınırlı olan yoğunlaşma 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.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"

    Bu isteğin GeoJSON yanıtında, istenen zaman aralığı için Himawari uydularından elde edilen yoğunlaşma izi algılama verileri listelenir:

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