Erkennungen abrufen

GET https://contrails.googleapis.com/v2/detections: Kontraildetektionen im GeoJSON-LineString-Format abrufen.

Bei Erfolg ist die Antwort eine FeatureCollection im GeoJSON-Format. Es ist möglich, dass eine leere FeatureCollection zurückgegeben wird, wenn der Zeitraum außerhalb des Gültigkeitsbereichs liegt (z.B. wenn nach erkannten Kontrails in der Zukunft gesucht wird). Außerdem sind die Detektionen nicht garantiert konsistent, da die Detektionsmodelle aktualisiert und Daten nachgefüllt werden.

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 nicht um mehr als 24 Stunden überschreiten.

Format: ISO 8601-Datum/Uhrzeit-String

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 jeweils die GOES_EAST-, Himawari- und MTG-Satelliten darstellen.

Wenn angegeben, gibt dieser Endpunkt nur erkannte Kontrails von Satelliten zurück, die in satellite_origins angegeben sind.

Wenn nicht angegeben, werden erkannte Kontrails von allen relevanten Satellitendatenanbietern zurückgegeben.

Format: String-Array

Beispiel: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]

Beispiele

  • So rufen Sie alle Kontraildetektionen für einen bestimmten Zeitpunkt 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 Kontraildetektionen für einen bestimmten Zeitpunkt ab, die auf Himawari-Detektionen 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.sandbox.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"

Eine erfolgreiche Antwort mit erkannten Kontrails sieht in etwa so aus:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            90.06765747070312,
            44.201324462890625
          ],
          [
            90.99974060058594,
            43.65225601196289
          ]
        ]
      },
      "properties": {
        "time": "2026-03-10T00: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-03-10T00:00:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    }
  ]
}