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

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

В случае успеха ответом будет FeatureCollection в формате GeoJSON. Обратите внимание, что возможен возврат пустого 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`, эта конечная точка будет возвращать только обнаруженные инверсионные следы от спутников, указанных в параметре satellite_origins .

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

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

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

Примеры

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

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

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

Успешный ответ с обнаружением инверсионных следов будет выглядеть примерно так:

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