Récupérer les masques de détection

GET https://contrails.googleapis.com/v2/detections/masks : obtenez des masques de détection de traînées de condensation au format NetCDF4.

Si la requête aboutit, la réponse sera un fichier NetCDF contenant des masques de détection des traînées de condensation.

Paramètres de requête

Paramètres
start_time

string

Obligatoire. Heure de début de la demande.

Format : chaîne de date et heure ISO 8601

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

string

Obligatoire. Heure de fin de la requête (incluse). Notez que end_time ne peut pas dépasser start_time de plus d'une heure.

Format : chaîne de date et heure ISO 8601

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

string

Facultatif. Les valeurs valides sont GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK et MTG-000-FULL-DISK, qui représentent respectivement les satellites GOES_EAST, Himawari et MTG.

Format : chaîne

Exemple : "GOES-EAST-FULL-DISK"

Exemples

  • Pour récupérer les masques de détection d'un satellite pour un point temporel spécifique :

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

    ou dans 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"

    Lorsqu'elle est chargée avec xarray, cette requête renvoie l'ensemble de données suivant :

    Dimensions : (time: 6, y: 5568, x: 5568)
    Coordonnées
    Nom Dimensions Type de données Valeurs
    durée (heure) 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
    Variables de données
    masque (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

    Notez que projection est mis en forme en tant que chaîne d'un objet pyproj.Proj.

    projection peut être utilisé pour convertir les coordonnées x et y de la carte en coordonnées de longitude et de latitude, et inversement.