Pobieranie wykrytych zagrożeń

GET https://contrails.googleapis.com/v2/detections: pobieranie wykrytych smug kondensacyjnych w formacie GeoJSON LineString.

Jeśli operacja się powiedzie, odpowiedź będzie zawierać FeatureCollection w formacie GeoJSON.

Zwracane współrzędne to długość i szerokość geograficzna punktów końcowych wykrycia liniowego, rzutowane na powierzchnię Ziemi z perspektywy satelity. W przypadku wykryć GOES zwracane współrzędne mogą też opcjonalnie zawierać przewidywane wartości wysokości.

Wysyłanie zapytań o wykrycia z zakresem czasu, który jest poza zakresem, np. z określonym czasem w przyszłości, zwraca pusty FeatureCollection.

Parametry zapytania

Parametry
start_time

string

Wymagane. Czas rozpoczęcia żądania.

Format: ciąg znaków daty i godziny ISO 8601

Przykład: 2026-01-20T21:00:00Z
end_time

string

Wymagane. Czas zakończenia żądania (włącznie). Pamiętaj, że end_time nie może przekraczać start_time o więcej niż 24 godziny.

Format: ciąg znaków daty i godziny ISO 8601

Przykład: 2026-01-20T22:00:00Z
satellite_origins[]

string

Opcjonalnie. Prawidłowe wartości to GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK i MTG-000-FULL-DISK, które reprezentują odpowiednio satelity GOES_EAST, Himawari i MTG.

Jeśli ten parametr jest obecny, ten punkt końcowy będzie tylko zwracać wykryte smugi kondensacyjne z satelitów określonych w satellite_origins.

Jeśli ten parametr nie jest obecny, zwraca wykryte smugi kondensacyjne ze wszystkich odpowiednich dostawców danych satelitarnych.

This is the corrected translation.

Przykład: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]
bounds[]

string

Opcjonalnie. Lista par ciągów znaków, z których każda musi być w formacie „szerokość geograficzna,długość geograficzna”, określająca wierzchołki wielokąta ograniczającego.

Jeśli ten parametr jest obecny, należy określić co najmniej 3 wartości bounds. Granice muszą tworzyć prawidłowy wielokąt (np.bez zduplikowanych wierzchołków i bez samoprzecięć).

Jeśli ten parametr jest obecny, ten punkt końcowy będzie tylko zwracać wykryte smugi kondensacyjne, które przecinają się z dowolną częścią wielokąta ograniczającego.

Jeśli ten parametr nie jest obecny, zwraca wykryte smugi kondensacyjne niezależnie od lokalizacji.

This is the corrected translation.

Przykład: ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]

Przykłady

  • Aby pobrać wszystkie wykryte smugi kondensacyjne w określonym przedziale czasu:

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

  • Aby pobrać wszystkie wykryte smugi kondensacyjne w określonym przedziale czasu, ograniczone przez wielokąt ograniczający:

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

  • Aby pobrać wykryte smugi kondensacyjne w określonym przedziale czasu, ograniczone do wykryć Himawari:

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

    lub w 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"

    Odpowiedź GeoJSON na to żądanie zawiera dane wykrywania smug kondensacyjnych z satelitów Himawari w żądanym przedziale czasu:

    {
  "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"
      }
    }
  ]
}