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

大気質 API - 座標別の AQI および汚染物質レベル

現在の大気質指数 (米国 EPA スケールと欧州スケールの両方) と、指定された緯度と経度の個々の汚染物質濃度を返します。汚染物質には、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 が 100 を超える場合 (敏感なグループにとっては不健康)、屋外でのランニングやサイクリングではなく、屋内でのトレーニングを提案します。アプリのダッシュボードに色分けされた AQI バッジを表示します。

不動産および物件リストの充実

空気品質スコアを不動産リストに追加します。住宅を探している購入者は平均 AQI でフィルターをかけることができ、物件ページには学校や交通機関などの近隣データと並べて現在の汚染レベルを表示できます。

環境モニタリングダッシュボード

複数の場所について 30 分ごとにこのエンドポイントをポーリングするライブ大気質ダッシュボードを構築します。過去の傾向を表示し、PM2.5 またはオゾンスパイクのしきい値アラートを設定し、施設管理者向けに日次大気質レポートを生成します。

Frequently asked questions

米国と欧州の AQI の違いは何ですか?

米国 EPA の AQI スケールは 0 ～ 500 で、ブレークポイントは 50 (良好)、100 (中程度)、150 (敏感なグループにとっては不健康) 以上です。ヨーロッパの AQI は、汚染物質の重み付けが異なる 0 ～ 100+ のスケールを使用します。両方が返されるため、視聴者が期待するスケールを使用できます。

汚染物質の濃度は何の単位ですか?

PM2.5 と PM10 は、立方メートルあたりのマイクログラム (ug/m3) で表されます。一酸化炭素の単位はug/m3です。二酸化窒素、二酸化硫黄、オゾンの単位は ug/m3 です。これらは標準的な大気測定単位です。

大気質データはどのくらいの頻度で更新されますか?

大気質の測定値は、上流の監視ネットワークから 1 時間ごとに更新されます。ほとんどのユースケースでは、30 ～ 60 分のキャッシュが妥当です。

座標ではなく都市名の空気質データを取得できますか?

このエンドポイントには緯度/経度座標が必要です。まず geo ジオコードエンドポイントを使用して都市名を座標に変換し、それをこのエンドポイントに渡します。

aqi_category とはどういう意味ですか?

aqi_category フィールドは、米国 EPA 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.