이 누리집은 대한민국 공식 전자정부 누리집입니다.
XML
JSON
한국환경공단_에어코리아_미세먼지 경보 발령 현황
QuickAISummary
오픈 API 정보
데이터 오류·개선 의견이 있으신가요?
기본 정보
-
OpenAPI 명
한국환경공단_에어코리아_미세먼지 경보 발령 현황
-
분류체계
환경 - 대기
- 제공기관
-
관리부서명
대기환경처 대기정책지원부
-
관리부서 전화번호
상세 및 제공정보
-
설명
미세먼지(PM10, PM2.5)에 대한 주의보, 경보 발령을 조회하기 위한 서비스입니다. API 상세 기능으로는 미세먼지 경보현황 정보를 조회가능한 기능으로 되어있으며 미세먼지, 초미세먼지에 대한 지역별,권역별, 주의보,경보 발령/해제시간, 항목별 농도,경보단계를 조회 가능합니다. OpenAPI 활용가이드를 활용하시면 초미세먼지의 경보권역 리스트를 확인하실 수 있습니다. ※ 운영계정으로 사용하고자 할 경우 "한국환경공단 에어코리아 OpenAPI 기술문서" 내 신청 가이드 참고
-
API 유형
REST
-
데이터 포맷
JSON+XML
-
공간범위
-
-
시간범위
-
-
키워드
미세먼지,코로나,오존,초미세먼지,에어코리아
-
활용신청 수
7968
-
등록일
2020-12-02
-
수정일
2026-06-30
이용 조건 및 라이선스 정보
-
비용부과유무
무료
-
이용허락범위
공공저작물 : 출처표시, 변경금지 (제 3유형)
-
심의유형
개발단계 : 자동승인 / 운영단계 : 심의승인
-
신청 가능 트래픽
개발계정 : 500 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
참고문서
-
한국환경공단 에어코리아 OpenAPI 기술문서_20260630.zip
표준 메타데이터
활용 정보
API 서비스
미세먼지(PM10, PM2.5)에 대한 지역별 주의보-경보 발령/해제시간, 농도를 조회합니다.
API 기본 정보
-
활용승인 절차
개발단계 : 자동승인 / 운영단계 : 심의승인
-
신청 가능 트래픽
개발계정 : 500 / 운영계정 : 활용사례 등록시 신청하면 트래픽 증가 가능
-
요청주소
https://apis.data.go.kr/B552584/UlfptcaAlarmInqireSvc/getUlfptcaAlarmInfo
-
서비스 URL
https://apis.data.go.kr/B552584/UlfptcaAlarmInqireSvc
요청변수(Request Parameter)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 서비스키 | serviceKey | 4 | 필 | 인증키(URL Encode) | 공공데이터포털에서 받은 인증키 |
| 데이터표출방식 | returnType | 4 | 옵 | xml | xml 또는 json |
| 한 페이지 결과 수 | numOfRows | 4 | 옵 | 100 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 4 | 옵 | 1 | 페이지번호 |
| 연도 | year | 4 | 필 | 2020 | 측정 연도 |
| 항목명 | itemCode | 4 | 옵 | PM10 | 미세먼지 항목 구분(PM10, PM25), PM10/PM25 모두 조회할 경우 파라미터 생략 |
출력결과(Response Element)
| 항목명(국문) | 항목명(영문) | 항목크기 | 항목구분 | 샘플데이터 | 항목설명 |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | 필 | 00 | 결과코드 |
| 결과메시지 | resultMsg | 50 | 필 | NORMAL SERVICE | 결과메시지 |
| 한 페이지 결과 수 | numOfRows | 4 | 필 | 100 | 한 페이지 결과 수 |
| 페이지 번호 | pageNo | 4 | 필 | 1 | 페이지번호 |
| 전체 결과 수 | totalCount | 4 | 필 | 251 | 전체 결과 수 |
| 목록 | items | 0 | 옵 | - | 목록 |
| 일련번호 | sn | 5 | 필 | 262 | 미세먼지 경보 현황 일련번호 |
| 발령일 | dataDate | 10 | 필 | 2020-10-28 | 발령 날짜 |
| 지역명 | districtName | 100 | 필 | 경기 | 발령 지역 이름 |
| 권역명 | moveName | 100 | 필 | 남부권 | 발령 권역 이름 |
| 항목명 | itemCode | 10 | 필 | PM25 | 미세먼지 항목 구분(PM10, PM25) |
| 경보단계 | issueGbn | 10 | 필 | 주의보 | 경보단계(주의보, 경보) |
| 발령일 | issueDate | 10 | 필 | 2020-10-28 | 발령 날짜 |
| 발령시간 | issueTime | 5 | 필 | 03:00 | 발령 시간 |
| 발령농도 | issueVal | 10 | 필 | 76 | 발령시 미세먼지 농도(단위: ug/m3) |
| 해제일 | clearDate | 10 | 필 | 2020-10-28 | 해제 날짜 |
| 해제시간 | clearTime | 5 | 필 | 13:00 | 해제 시간 |
| 해제농도 | clearVal | 10 | 필 | 28 | 해제시 미세먼지 농도(단위: ug/m3) |