Erkennungen abrufen

GET https://contrails.googleapis.com/v2/detections: Ruft Kondensstreifendetektionen im GeoJSON-LineString-Format ab.

Bei Erfolg ist die Antwort ein FeatureCollection im GeoJSON-Format.

Die zurückgegebenen Koordinaten sind der Längen- und Breitengrad der Endpunkte der linearisierten Erkennung, die aus der Perspektive des Satelliten auf die Erdoberfläche projiziert werden. Bei GOES-Erkennungen enthalten die zurückgegebenen Koordinaten optional auch geschätzte Höhenwerte.

Wenn Sie Erkennungen mit einem Zeitbereich abfragen, der außerhalb des Gültigkeitsbereichs liegt, z. B. mit einer angegebenen Zeit in der Zukunft, wird ein leeres FeatureCollection zurückgegeben.

Hinweis :MTG-Erkennungen 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). Beachten Sie, dass end_time nicht mehr als 24 Stunden vor start_time liegen darf. Format: ISO 8601-Datums-/Uhrzeitstring Beispiel: 2026-01-20T22:00:00Z
satellite_origins[]	string Optional. Gültige Werte sind GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK und MTG-000-FULL-DISK, die für die Satelliten GOES_EAST, Himawari bzw. MTG stehen. Wenn dieser Endpunkt vorhanden ist, werden nur die erkannten Kondensstreifen von Satelliten zurückgegeben, die in satellite_origins angegeben sind. Wenn nicht vorhanden, werden erkannte Kondensstreifen von allen relevanten Satellitendatenanbietern zurückgegeben. Format: String-Array Beispiel: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]
bounds[]	string Optional. Eine Liste von String-Paaren, die jeweils im Format „Breitengrad,Längengrad“ angegeben werden müssen und die Eckpunkte für ein umschließendes Polygon angeben. Wenn vorhanden, müssen mindestens drei bounds angegeben werden. Die Grenzen müssen ein gültiges Polygon bilden (z. B. keine doppelten Eckpunkte, keine Selbstschneidung). Wenn dieser Endpunkt vorhanden ist, werden nur erkannte Kondensstreifen zurückgegeben, die sich mit einem beliebigen Teil des umgebenden Polygons überschneiden. Wenn nicht vorhanden, werden Kondensstreifen unabhängig vom Standort zurückgegeben. Format: String-Array Beispiel: ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]

Beispiele

• So rufen Sie alle Kondensstreifenerkennungen für einen bestimmten Zeitraum ab:

  response = requests.get(
    url="https://contrails.googleapis.com/v2/detections",
    params={"start_time": "2026-01-27T12:00:00Z",
            "end_time": "2026-01-27T12:10:00Z"},
    headers={"x-goog-api-key": API_KEY},
  )
  

• So rufen Sie alle Kondensstreifenerkennungen für ein bestimmtes Zeitfenster ab, das durch ein Begrenzungspolygon begrenzt wird:

  response = requests.get(
    url="https://contrails.googleapis.com/v2/detections",
    params={"start_time": "2026-01-27T12:00:00Z",
            "end_time": "2026-01-27T12:10:00Z",
            "bounds": ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]},
    headers={"x-goog-api-key": API_KEY},
  )
  

• So rufen Sie Kondensstreifenerkennungen für einen bestimmten Zeitraum ab, die auf Himawari-Erkennungen beschränkt sind:

  response = requests.get(
    url="https://contrails.googleapis.com/v2/detections",
    params={"start_time": "2026-01-27T12:00:00Z",
            "end_time": "2026-01-27T12:10:00Z",
            "satellite_origins": ["HIMAWARI-FULL-DISK"]},
    headers={"x-goog-api-key": API_KEY},
  )
  

  oder in CURL:

  curl "https://contrails.googleapis.com/v2/detections?\
  key=API_KEY&\
  start_time=2026-01-27T12:00:00Z&\
  end_time=2026-01-27T12:10:00Z&\
  satellite_origins=HIMAWARI-FULL-DISK"
  

  Die GeoJSON-Antwort für diese Anfrage enthält Daten zur Kondensstreifenerkennung von Himawari-Satelliten für den angeforderten Zeitraum:

  {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "LineString",
          "coordinates": [
            [
              90.06765747070312,
              44.201324462890625
            ],
            [
              90.99974060058594,
              43.65225601196289
            ]
          ]
        },
        "properties": {
          "time": "2026-01-27T12:00:00+00:00",
          "satellite_origin": "HIMAWARI-FULL-DISK"
        }
      },
      {
        "type": "Feature",
        "geometry": {
          "type": "LineString",
          "coordinates": [
            [
              105.36386108398438,
              -1.7198446989059448
            ],
            [
              105.7318115234375,
              -2.5787696838378906
            ]
          ]
        },
        "properties": {
          "time": "2026-01-27T12:10:00+00:00",
          "satellite_origin": "HIMAWARI-FULL-DISK"
        }
      }
    ]
  }