Получить обнаруженные объекты

GET https://contrails.googleapis.com/v2/detections : Получение данных об обнаружении инверсионных следов в формате GeoJSON LineString.

В случае успеха ответом будет предоставлен FeatureCollection в формате GeoJSON.

Возвращаемые координаты представляют собой долготу и широту конечных точек линеаризованного обнаружения, спроецированные на поверхность Земли с точки зрения спутника. Для обнаружений GOES возвращаемые координаты также могут дополнительно включать предполагаемые значения высоты.

Запросы к данным об обнаружении с временным диапазоном, выходящим за рамки рассматриваемой области, например, с указанным временем в будущем, возвращают пустую FeatureCollection ).

Параметры запроса

Параметры
start_time

string

Обязательно. Время начала обработки запроса.

Формат: строка даты и времени ISO 8601

Пример: 2026-01-20T21:00:00Z

end_time

string

Обязательно. Время окончания запроса (включительно). Обратите внимание, что end_time не может превышать start_time более чем на 24 часа.

Формат: строка даты и времени ISO 8601

Пример: 2026-01-20T22:00:00Z

satellite_origins[]

string

Необязательно. Допустимые значения: GOES-EAST-FULL-DISK , HIMAWARI-FULL-DISK и MTG-000-FULL-DISK , обозначающие спутники GOES_EAST, Himawari и MTG соответственно.

При наличии этой конечной точки она будет возвращать только обнаруженные инверсионные следы от спутников, указанных в satellite_origins .

При отсутствии данных система возвращает информацию об обнаруженных инверсионных следах от всех соответствующих поставщиков спутниковых данных.

Формат: массив строк

Пример: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]

bounds[]

string

Необязательно. Список пар строк, каждая из которых должна быть в формате "широта, долгота", указывающих вершины ограничивающего многоугольника.

Если заданы bounds , необходимо указать как минимум три из них. Границы должны образовывать допустимый многоугольник (например, без повторяющихся вершин, без самопересечения).

При наличии этой конечной точки она будет возвращать только обнаруженные инверсионные следы, пересекающиеся с любой частью ограничивающего многоугольника.

При отсутствии следов, система возвращает обнаруженные инверсионные следы независимо от местоположения.

Формат: массив строк

Пример: ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]

Примеры

  • Чтобы получить все данные об обнаружении инверсионных следов за определенный промежуток времени:

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

  • Чтобы получить все данные об обнаружении инверсионных следов за определенный промежуток времени, ограниченный ограничивающим многоугольником:

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

  • Чтобы получить данные об обнаружении инверсионных следов за определенный промежуток времени, с ограничением по данным 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},
)

    или в 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"

    В ответе GeoJSON на этот запрос представлены данные об обнаружении инверсионных следов со спутников Himawari за запрошенный временной диапазон:

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