Получить сетку прогноза

GET https://contrails.googleapis.com/v2/grids : сетку прогнозов образования инверсионных следов.

В случае успеха, в ответ будет получена функция NetCDF со значениями воздействия инверсионных следов.

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

Параметры
time

string

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

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

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

bbox[]

number

Необязательно. Границы региона будут возвращены.

Формат: [lng_min, lat_min, lng_max, lat_max]

Пример: [-40, 20, 20, 60]

aircraftType

string

Необязательно. Код самолета.

Формат: 4-символьный код типа воздушного судна ИКАО

Пример: A320

flightLevel[]

integer

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

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

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

format

string

Необязательно. Запрашиваемый формат. Передача значения, отличного от 'netcdf4', вызовет ошибку UNIMPLEMENTED, поскольку полигоны не поддерживаются.

aircraftClass

string

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

data[]

string

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

Пример: ["contrails", "expected_effective_energy_forcing"]

Примеры

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

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

    При загрузке с помощью xarray этот запрос возвращает следующий набор данных:

    Размеры: (долгота: 1441, широта: 721, эшелон полета: 18, время: 1)
    Координаты
    Имя Размеры Тип данных Ценности
    долгота (долгота) float32 -180.0 -179.8 ... 179.8 1...
    широта (широта) float32 -90.0 -89.75 -89.5 ... 8...
    уровень полета (уровень_полета) int16 270 280 290 300 ... 41...
    время (время) дата время64[нс] 2026-01-28T20:00:00
    прогнозное_время (время) дата время64[нс] 2026-01-27T08:00:00
    Переменные данных
    инверсионные следы (долгота, широта, эшелон полета, время) float32 0.0 0.0 0.0 0.0 ... 0.0 ...
    Атрибуты
    inference_pipeli... contrails.forecast-pipeline_20260115.02_p0
    api_version : contrails.api-service_20260125.00_p0
    aircraft_class : по умолчанию

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

    response = requests.get(
  url="https://contrails.googleapis.com/v2/grids",
  params={"time": 1769508160,
          "bbox": [-40, 20, 20, 60],
          "aircraftType": "A320"
          },
  headers={"x-goog-api-key": API_KEY},
)

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

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