Изучите возможности API Contrails и разберитесь в работе его конечных точек.
Обзор
API Contrails объединяет крупномасштабные метеорологические данные, данные о полетах и спутниковые снимки с современной моделью компьютерного зрения для создания прогнозов образования инверсионных следов на основе искусственного интеллекта. Эти прогнозы определяют зоны вероятности образования инверсионных следов и потенциальное воздействие инверсионных следов в течение следующих 48 часов.
Включение этих прогнозов в процессы планирования полетов может помочь пилотам избегать полетов через эти регионы, предотвращая образование инверсионных следов, способствующих нагреву.
Чтобы понять, где именно будут образовываться инверсионные следы и насколько сильным будет потепление, API Contrails предлагает прогнозы в виде сеток и регионов .
Прогнозы
API Contrails предоставляет следующие прогнозы:
Сетки: Высокоточные 4D-данные, представляющие значения индекса воздействия инверсионных следов по осям широты, долготы, высоты и времени, в формате NetCDF . Эти сетки представляют весь земной шар в виде сетки с шагом в четверть градуса, где шаг по широте и долготе составляет 0,25 градуса. Прогноз для каждой сетки составляется на полный час (UTC).
Значения индекса воздействия инверсионных следов варьируются от 0, что означает отсутствие значительного потепления, до 4, что означает наличие сильного потепления, вызванного инверсионными следами.
Использование сеток рекомендуется для программного планирования полетов, особенно при изменении маршрутов.
Регионы: Упрощенная, полигональная версия прогноза, представляющая собой зоны, избегающие инверсионных следов, в формате мультиполигонов GeoJSON.
Области, где необходимо избегать инверсионных следов, оцениваются по тем же уровням серьезности, но значение 0 не учитывается, а начинается только с 1 (легкое воздействие).
Регионы рекомендуются для специалистов по планированию полетов, которые могут устанавливать правила на основе уровней серьезности и вручную перенаправлять рейсы, как правило, путем вертикальных отклонений (т.е. путем корректировки эшелонов полета).
Аутентификация
Для использования API Contrails вам потребуется ключ API, а также необходимо активировать API Contrails.
Для получения более подробной информации следуйте руководству по настройке среды .
Ошибки
При использовании API Contrails могут возникать следующие ошибки:
| Код | Причина | Обработка ошибок |
|---|---|---|
| 400 (недействительные запросы) | Запрос с неверными данными | Не повторяйте попытку автоматически. Эта ошибка вызвана проблемами в коде; убедитесь, что вы используете правильный формат параметров. |
| 404 | Запрос на прогнозное время, которое еще не рассчитано. | Повторите попытку, используя стратегию экспоненциальной задержки . |
| 429 | Слишком много запросов (см. раздел «Ограничения использования »). | Повторите попытку с экспоненциальной задержкой. |
| 5XX | Ошибка сервера | Повторите попытку с экспоненциальной задержкой. |
Версионирование
Крупные обновления версий, такие как выпуск v2 , могут привести к появлению поведения, несовместимого с предыдущими версиями, и потребовать изменений в коде.
Ожидается, что регулярные обновления между основными релизами будут обратно совместимы.
О ключевых обновлениях можно прочитать в примечаниях к выпуску API Contrails .
Что дальше?
- Для начала использования API Contrails необходимо настроить среду .
- Для получения подробных инструкций по доступным методам API Contrails ознакомьтесь с документацией по API Contrails.
- Ознакомьтесь с обзором прогнозирования Contrails , чтобы понять, как рассчитываются прогнозы по API Contrails.