POST AI agent ready /v1/air-quality/check

API качества воздуха — AQI и уровни загрязняющих веществ по координатам

Возвращает текущий индекс качества воздуха (по шкале Агентства по охране окружающей среды США и по европейской шкале) и отдельные концентрации загрязняющих веществ для заданной широты и долготы. Загрязняющие вещества включают PM2,5, PM10, окись углерода, диоксид азота, диоксид серы и озон.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/air-quality/check \
  -H "Content-Type: application/json" \
  -d '{"lat":40.7128,"lng":-74.006}'

When to use this API

Обогащение недвижимости и списков объектов недвижимости

Добавьте оценки качества воздуха в списки объектов недвижимости. Покупатели, ищущие дома, могут фильтровать их по среднему AQI, а на страницах с объявлениями могут отображаться текущие уровни загрязнения наряду с данными о районах, таких как школы и транспорт.

Панели экологического мониторинга

Создайте панель мониторинга качества воздуха в реальном времени, которая каждые 30 минут опрашивает эту конечную точку для нескольких местоположений. Отображайте исторические тенденции, устанавливайте пороговые оповещения для выбросов PM2,5 или озона, а также создавайте ежедневные отчеты о качестве воздуха для руководителей предприятий.

Frequently asked questions

В чем разница между американским и европейским AQI?

Шкала AQI Агентства по охране окружающей среды США варьируется от 0 до 500 с контрольными точками 50 (хорошо), 100 (средне), 150 (нездорово для чувствительных групп) и выше. Европейский AQI использует шкалу от 0 до 100+ с различными весами загрязняющих веществ. Оба возвращаются, поэтому вы можете использовать масштаб, которого ожидает ваша аудитория.

В каких единицах выражаются концентрации загрязняющих веществ?

PM2,5 и PM10 измеряются в микрограммах на кубический метр (мкг/м3). Угарный газ измеряется в мкг/м3. Диоксид азота, диоксид серы и озон указаны в мкг/м3. Это стандартные единицы измерения атмосферы.

Как часто обновляются данные о качестве воздуха?

Показания качества воздуха обновляются ежечасно из сетей мониторинга выше по течению. Для большинства случаев использования кэширование в течение 30–60 минут является разумным.

Могу ли я получить данные о качестве воздуха для названия города вместо координат?

Для этой конечной точки требуются координаты широты и долготы. Сначала используйте конечную точку геокодирования, чтобы преобразовать название города в координаты, а затем передайте их в эту конечную точку.

Что означает aqi_category?

Поле aqi_category возвращает удобочитаемую метку на основе AQI Агентства по охране окружающей среды США: «Хорошо» (0–50), «Умеренно» (51–100), «Нездорово для чувствительных групп» (101–150), «Нездорово» (151–200), «Очень вредно» (201–300) или «Опасно» (301+).

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.