Erkennungsmasken abrufen

GET https://contrails.googleapis.com/v2/detections/masks: Ruft Masken zur Erkennung von Kondensstreifen im NetCDF4-Format ab.

Bei Erfolg ist die Antwort ein NetCDF von Masken zur Erkennung von Kondensstreifen.

**Hinweis**: MTG-Erkennungsmasken befinden sich in der Betaphase und können sich ändern.

Suchparameter

Parameter
start_time	string Erforderlich. Startzeit der Anfrage. Format: ISO 8601-Datum/Uhrzeit-String Beispiel: 2026-01-20T21:00:00Z
end_time	string Erforderlich. Endzeit der Anfrage (einschließlich). end_time darf start_time um nicht mehr als eine Stunde überschreiten. Format: ISO 8601-Datum/Uhrzeit-String Beispiel: 2026-01-20T22:00:00Z
satellite_origin	string Optional. Gültige Werte sind GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK und MTG-000-FULL-DISK. Sie stehen für die Satelliten GOES_EAST, Himawari und MTG. Format: String Beispiel: "GOES-EAST-FULL-DISK"

Beispiele

• So rufen Sie Erkennungsmasken von einem Satelliten für einen bestimmten Zeitpunkt ab:

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

  oder 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"
  

  Wenn diese Anfrage mit xarray geladen wird, wird das folgende Dataset zurückgegeben:

  Abmessungen: (time: 6, y: 5568, x: 5568)
  Koordinaten
  Name	Abmessungen	Datentyp	Werte
  Zeit	(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
  Datenvariablen
  Maske	(time, y, x)	float32	0.0 0.0 0.0 0.0 ... 0.0 ...
  Projektion	()	DataArray	+proj=geos +lon_0=0 +h=35786400 +x_0=0 +y_0=0 +a=6378137 +b=6356752.3 +units=m +no_defs

  Note that projection wird als Stringform eines pyproj.Proj-Objekts formatiert.

  Mit projection können Sie zwischen Kartenkoordinaten (x, y) und Koordinaten für Längen- und Breitengrade konvertieren.