Recuperare le maschere di rilevamento

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

In caso di esito positivo, la risposta sarà un NetCDF delle maschere di rilevamento delle scie di condensazione.

Parametri di query

Parametri
start_time

string

Obbligatorio. Ora di inizio della richiesta.

Formato: stringa di data e ora 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 di data e ora ISO 8601

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

string

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

Formato: stringa

Esempio: "GOES-EAST-FULL-DISK"

Esempi

  • Per recuperare le maschere di rilevamento da un satellite per un momento specifico:

    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"},
  headers={"x-goog-api-key": API_KEY},
)

    Oppure in CURL:

    curl "https://contrails.sandbox.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"

    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 ...
    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.