Получить прогнозные регионы

GET https://contrails.googleapis.com/v2/regions : Получение областей, позволяющих избежать инверсионных следов, в формате GeoJSON multipolygon.

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

Области предотвращения образования инверсионных следов, отображенные в формате полигонов, оцениваются по уровням серьезности, от 1 до 4 для каждого уровня полета. Чем выше значение, тем серьезнее инверсионный след.

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

Параметры
time

string

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

Формат: строка даты и времени ISO 8601 ИЛИ целое число эпохи Unix

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

flightLevel[]

integer

Необязательно. Эпохи полета туда и обратно. Если эпоха полета не указана, то включены все эпохи.

Формат: эшелоны полета в гектофотах; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440]

Пример: [270, 280, 290, 300]

threshold

integer

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

Формат: Допустимые значения находятся в диапазоне от 1 до 4 (включительно).

aircraftClass

string

Необязательно. Класс самолета. В настоящее время поддерживается только default .

Примеры

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

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

    В ответе GeoJSON перечислены все зоны, где возможно предотвращение образования инверсионных следов, в формате полигонов:

    геометрия уровень полета порог время прогнозное_время класс_самолета
    0 МНОГОПОЛИГОН Z (((166.25 81.12 8229.6, 168.37 ... 270 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 по умолчанию
    1 МНОГОПОЛИГОН Z (((92.38 45.5 8229.6, 93 46.62 ... 270 2 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 по умолчанию
    2 МНОГОПОЛИГОН Z (((83.38 65 8229.6, 84 66.12 82... 270 3 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 по умолчанию
    3 МНОГОПОЛИГОН Z (((57.38 76 8229.6, 57.75 76.88... 270 4 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 по умолчанию
    4 МНОГОПОЛИГОН Z (((162.38 79 8534.4, 162.75 79.... 280 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 по умолчанию

  • Чтобы получить информацию о зонах предотвращения образования инверсионных следов, ограниченных определенными эшелонами полета, с указанием времени в виде целого числа эпохи Unix:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 1768942800,
    "flightLevel": [300,310,320,330]
  },
  headers={"x-goog-api-key": API_KEY},
)

  • Для получения информации о зонах предотвращения образования инверсионных следов, ограниченных определенными эшелонами полета и имеющих уровень серьезности, равный или превышающий 3:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 2026-01-27T12:00:00Z,
    "flightLevel": [300,310,320,330],
    "threshold": 3
  },
  headers={"x-goog-api-key": API_KEY},
)