Algılama maskelerini alma

GET https://contrails.googleapis.com/v2/detections/masks: NetCDF4 biçiminde uçak izi algılama maskeleri alın.

İşlem başarılı olursa yanıt, yoğunlaşma izi algılama maskelerinin NetCDF'si olur. İsteğe bağlı olarak, yanıta tarama süresi farkları da eklenebilir.

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, start_time değerini 1 saatten fazla aşamaz.

Biçim: ISO 8601 tarih/saat dizesi

Örnek: 2026-01-20T22:00:00Z
satellite_origin

string

Zorunlu. Geçerli değerler sırasıyla GOES_WEST, GOES_EAST, Himawari ve MTG uydularını temsil eden GOES-WEST-FULL-DISK, GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK ve MTG-000-FULL-DISK şeklindedir.

Biçim: dize

Örnek: "GOES-EAST-FULL-DISK"
view

DetectionMaskView

İsteğe bağlı. Varsayılan olarak DETECTION_MASK_VIEW_UNSPECIFIED değerine ayarlanır. DETECTION_MASK_VIEW_FULL ise yanıta tam disk uydu ofsetleri (saniye cinsinden) dahil edilir.

Biçim: Belgelere bakın.

Örnek: DETECTION_MASK_VIEW_BASIC

Örnekler

  • Uyduya ait tespit maskelerini, tarama zamanı farklarıyla belirli bir zaman noktası için almak üzere:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/detections/masks",
  params={"start_time": "2026-04-10T00:00:00Z",
          "end_time": "2026-04-10T01:00:00Z",
          "satellite_origin": "MTG-000-FULL-DISK"
          "view": "DETECTION_MASK_VIEW_FULL"},
  headers={"x-goog-api-key": API_KEY},
)

    veya CURL'de:

    curl "https://contrails.googleapis.com/v2/detections/masks?\
key=API_KEY&\
start_time=2026-04-10T00:00:00Z&\
end_time=2026-04-10T01:00:00Z&\
satellite_origin=MTG-000-FULL-DISK&\
view=DETECTION_MASK_VIEW_FULL"

    Bu istek, xarray ile yüklendiğinde aşağıdaki veri kümesini döndürür:

    Boyutlar: (zaman: 6, y: 5568, x: 5568)
    Koordinatlar
    Ad Boyutlar Veri Türü Değerler
    zaman (zaman) datetime64[ns] 2026-04-10T00:00:07 ... 2026-04-10T00:50:07
    y (y) float32 5,569e+06 5,567e+06 ... -5,569e+06
    x (x) float32 -5,569e+06 -5,567e+06 ... 5,569e+06
    Veri değişkenleri
    maske (time, y, x) float32 0.0 0.0 0.0 0.0 ... 0.0 ...
    scantime_offset (time, y, x) float64 nan nan nan nan ... 564. 568. ...
    projeksiyon () DataArray +proj=geos +lon_0=0 +h=35786400 +x_0=0 +y_0=0 +a=6378137 +b=6356752.3 +units=m +no_defs

    projection, pyproj.Proj nesnesinin dize biçiminde biçimlendirilir.

    projection, harita x, y koordinatları ile boylam ve enlem koordinatları arasında dönüşüm yapmak için kullanılabilir.

DetectionMaskView

Algılama maskeleri için döndürülecek ayrıntı düzeyini tanımlar.

Sıralamalar
DETECTION_MASK_VIEW_UNSPECIFIED Belirtilmemiş görünüm. Bu, pratikte BASIC olarak değerlendirilir.
DETECTION_MASK_VIEW_BASIC Algılama maskesi değerlerini ve uydu projeksiyon verilerini içerir.
DETECTION_MASK_VIEW_FULL Algılama maskesi değerlerini, uydu projeksiyon verilerini ve tam disk tarama süresi ofsetlerini içerir.