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 eine NetCDF-Datei mit Masken zur Erkennung von Kondensstreifen. Optional können auch Scanzeit-Offsets in die Antwort aufgenommen werden.

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-Datums-/Uhrzeitstring Beispiel: 2026-01-20T21:00:00Z
end_time	string Erforderlich. Ende der Anfrage (einschließlich). end_time darf start_time um maximal eine Stunde überschreiten. Format: ISO 8601-Datums-/Uhrzeitstring Beispiel: 2026-01-20T22:00:00Z
satellite_origin	string Erforderlich. Gültige Werte sind GOES-WEST-FULL-DISK, GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK und MTG-000-FULL-DISK, die die Satelliten GOES_WEST, GOES_EAST, Himawari und MTG darstellen. Format: String Beispiel: "GOES-EAST-FULL-DISK"
view	DetectionMaskView Optional. Die Standardeinstellung ist DETECTION_MASK_VIEW_UNSPECIFIED. Wenn DETECTION_MASK_VIEW_FULL, werden in der Antwort vollständige Satelliten-Offsets für die Festplatte (in Sekunden) angegeben. Format: Dokumentation ansehen Beispiel: DETECTION_MASK_VIEW_BASIC

Beispiele

• So rufen Sie Erkennungsmasken von einem Satelliten für einen bestimmten Zeitpunkt mit Scanzeit-Offsets 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"
            "view": "DETECTION_MASK_VIEW_FULL"},
    headers={"x-goog-api-key": API_KEY},
  )
  

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

  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	(Zeit)	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 ...
  scantime_offset	(time, y, x)	float64	nan nan nan nan ... 564. 568. …
  Projektion	()	DataArray	+proj=geos +lon_0=0 +h=35786400 +x_0=0 +y_0=0 +a=6378137 +b=6356752.3 +units=m +no_defs

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

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

DetectionMaskView

Definiert die Detailebene, die für Erkennungsmasken zurückgegeben werden soll.

Enums
DETECTION_MASK_VIEW_UNSPECIFIED	Nicht angegebene Ansicht. In der Praxis wird dies als BASIC behandelt.
DETECTION_MASK_VIEW_BASIC	Enthält Werte für die Erkennungsmaske und Daten zur Satellitenprojektion.
DETECTION_MASK_VIEW_FULL	Enthält Werte für die Erkennungsmaske, Daten zur Satellitenprojektion und Offsets für die Scanzeit der gesamten Scheibe.