airqualitylisted

# data-go-kr — 에어코리아 대기오염정보 Fetch real-time air quality. Clean columns: `station`, `measured_at`, `khai`/`khai_grade` (통합대기환경지수), and per pollutant a value + `_grade` + `_flag`: `pm10`/`pm25` (미세먼지· 초미세먼지, ㎍/㎥, integers), `so2`/`co`/`o3`/`no2` (ppm, decimals). Grades: 1 좋음 · 2 보통 · 3 나쁨 · 4 매우나쁨. | operation | 조회 | |---|---| | `by_sido` | 시도별 실시간 (a province's stations, latest) | | `by_station` | 측정소별 실시간 (one station over a term) | ## Prerequisite ``` pipx install data-go-kr # or: pip install data-go-kr ``` A data.go.kr **decoding** key must be configured (env `DATA_GO_KR_API_KEY` or `~/.config/data-go-kr/credentials.json`), and the 대기오염정보 dataset (service B552584) applied for (활용신청). It is 자동승인 for a development account. ## Running ``` data-go-kr airquality by_sido <시도명> [--json] data-go-kr airquality by_station <측정소명> [--data-term TERM] [--json] ``` - `<시도명>`: 서울 / 부산 / 인천 / 경기 / ... (a 광역시도). - `<측정소명>`: a station, e.g. 종로구. `--data-term` is `DAILY` (default) / `MONTH` / `3MONTH`. ## Procedure 1. **Pick the query.** "서울 미세먼지" -> `by_sido 서울`; a named station over time -> `by_station <name> --data-term MONTH`. 2. **Run.** ```bash data-go-kr airquality by_sido 서울 ``` Add `--json` for machine-readable data. 3. **Relay the result.** Report `pm10`/`pm25` with their grade (좋음/보통/나쁨/매우나쁨). A `_flag` value means that pollutant's measurement was unavailable. 4. **Error handling.** A one-line `data-go-kr: <message>` on stderr