Recuperare le maschere di rilevamento

GET https://contrails.googleapis.com/v2/detections/masks: recupera le maschere di rilevamento delle scie di condensazione nel formato NetCDF4.

In caso di esito positivo, la risposta sarà un file NetCDF delle maschere di rilevamento delle scie di condensazione. Facoltativamente, nella risposta possono essere inclusi anche gli offset di scantime.

Parametri di query

Parametri
start_time

string

Obbligatorio. Ora di inizio della richiesta.

Formato: stringa datetime ISO 8601

Esempio: 2026-01-20T21:00:00Z
end_time

string

Obbligatorio. Ora di fine della richiesta (inclusa). Tieni presente che end_time non può superare start_time di più di 1 ora.

Formato: stringa datetime ISO 8601

Esempio: 2026-01-20T22:00:00Z
satellite_origin

string

Obbligatorio. I valori validi sono GOES-WEST-FULL-DISK, GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK e MTG-000-FULL-DISK, che rappresentano rispettivamente i satelliti GOES_WEST, GOES_EAST, Himawari e MTG.

Formato: stringa

Esempio: "GOES-EAST-FULL-DISK"
view

DetectionMaskView

Facoltativo. Il valore predefinito è DETECTION_MASK_VIEW_UNSPECIFIED. Se DETECTION_MASK_VIEW_FULL, nella risposta verranno inclusi gli offset dei satelliti full disk (in secondi).

Formato: consulta la documentazione

Esempio: DETECTION_MASK_VIEW_BASIC

Esempi

  • Per recuperare le maschere di rilevamento da un satellite per un punto specifico nel tempo con offset di scantime:

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

    oppure in CURL:

    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"

    Quando viene caricata con xarray, questa richiesta restituisce il seguente set di dati:

    Dimensioni: (time: 6, y: 5568, x: 5568)
    Coordinate
    Nome Dimensioni Tipo di dati Valori
    time (time) 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
    Variabili di dati
    mask (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. ...
    projection () DataArray +proj=geos +lon_0=0 +h=35786400 +x_0=0 +y_0=0 +a=6378137 +b=6356752.3 +units=m +no_defs

    Tieni presente che projection è formattato come la forma di stringa di un oggetto pyproj.Proj.

    projection può essere utilizzato per convertire le coordinate x, y della mappa e le coordinate di longitudine e latitudine.

DetectionMaskView

Definisce il livello di dettaglio da restituire per le maschere di rilevamento.

Enum
DETECTION_MASK_VIEW_UNSPECIFIED Visualizzazione non specificata. In pratica, viene trattata come BASIC.
DETECTION_MASK_VIEW_BASIC Contiene i valori della maschera di rilevamento e i dati di proiezione satellitare.
DETECTION_MASK_VIEW_FULL Contiene i valori della maschera di rilevamento, i dati di proiezione satellitare e gli offset di scantime full disk.