位置別微小粒子状物質

このスキルの機能

基本的に https://k-skill-proxy.nomadamas.org/v1/fine-dust/report にリクエストを送信して、PM10 / PM2.5 / 統合大気等級をまとめて返します。

使用場面

• 「今この場所の微小粒子状物質はどう？」
• 「江南地域の超微小粒子状物質の数値を教えて」
• 「ここの空気質はいい？」

入力値

• 通常の入力：地域名/行政区域ヒント
• 再調査入力：正確な測定所名

地域名命名規則

地域名は以下のように測定所名に近い韓国語行政区域名を優先して使用します。

• 良い例：강남구, 서울 강남구, 종로구, 수원시
• 曖昧な例：강남, 서울 남쪽, 코엑스 근처

複数のトークンが入力された場合、helper / proxy は通常最も具体的なトークンを優先します。例：서울 강남구 → 강남구。

デフォルトパス

追加の client API レイヤーは不要です。プロキシサーバーへの HTTP リクエストを送るだけで十分です。

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
  --data-urlencode 'regionHint=서울 강남구'

スクリプト helper も同じ report endpoint をデフォルトパスとして使用します。

python3 scripts/fine_dust.py report --region-hint '서울 강남구' --json

曖昧な位置

入力された地域名が単一の測定所として直ちに確定されない場合、proxy は ambiguous_location と共に候補測定所のリストを返します。

例：

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
  --data-urlencode 'regionHint=광주 광산구'

この場合、応答の candidate_stations から一つを選んで、stationName で再度調査します。

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/fine-dust/report' \
  --data-urlencode 'stationName=우산동(광주)'

詳細な API パス

元の AirKorea に似たパススルー経路（/B552584/...）やダイレクトフォールバック詳細については、以下のドキュメントのみを参照してください。

• docs/features/fine-dust-location.md
• docs/features/k-skill-proxy.md

回答は簡潔に

応答には以下のみを最初にまとめます。

• 測定所
• 調査時刻
• PM10 値と等級
• PM2.5 値と等級
• 統合大気等級
• 調査方式（fallback）

障害モード

• regionHint が広すぎるか、単一の測定所を確定できない場合
• プロキシサーバーがダウンしているか、upstream キーが空の場合
• 測定所名と地域名が異なり、ダイレクトフォールバックが必要な場合

注釈

• デフォルトパスは常に k-skill-proxy.nomadamas.org の report endpoint です。
• 地域名調査は最初に候補を取得し、必要に応じて正確な測定所名で再調査します。
• パススルー / ダイレクト AirKorea の実装詳細は、スキル本文で長く繰り返しません。
• 無料 API プロキシは公開 endpoint をデフォルトとします。