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. Les décalages de temps de lecture peuvent également être inclus dans la réponse.

Remarque : Les masques de détection MTG sont en version bêta et peuvent être modifiés.

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 demande (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 Obligatoire. Les valeurs valides sont GOES-WEST-FULL-DISK, GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK et MTG-000-FULL-DISK, qui représentent respectivement les satellites GOES_WEST, GOES_EAST, Himawari et MTG. Format : chaîne Exemple : "GOES-EAST-FULL-DISK"
view	DetectionMaskView Facultatif. La valeur par défaut est DETECTION_MASK_VIEW_UNSPECIFIED. Si la valeur est DETECTION_MASK_VIEW_FULL, la réponse inclut les décalages satellites complets du disque (en secondes). Format : consultez la documentation. Exemple : DETECTION_MASK_VIEW_BASIC

Exemples

• Pour récupérer des masques de détection à partir d'un satellite pour un point temporel spécifique avec des décalages de 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},
  )
  

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

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

  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.

DetectionMaskView

Définit le niveau de détail à renvoyer pour les masques de détection.

Enums
DETECTION_MASK_VIEW_UNSPECIFIED	Vue non spécifiée. En pratique, il est traité comme BASIC.
DETECTION_MASK_VIEW_BASIC	Contient les valeurs du masque de détection et les données de projection satellite.
DETECTION_MASK_VIEW_FULL	Contient les valeurs du masque de détection, les données de projection satellite et les décalages de temps de balayage du disque complet.