공공5 APIs

대기오염정보

#한국환경공단#에어코리아#대기오염#초미세먼지#통합대기환경지수#헬스케어#스마트홈

OVERVIEW

상품요약

환경부 산하 한국환경공단의 에어코리아(AirKorea)가 공공데이터포털을 통해 개방하는 대기질·초미세먼지 예보, 측정소별·시도별 실시간 측정 정보, 통합대기환경지수 나쁨 이상 측정소 목록을 한 번에 조회하는 유형의 API입니다. 통보시간·예보 개황·발생 원인·예보 등급·행동 요령·시간대별 예측 모델 이미지, 아황산가스·일산화탄소·오존·이산화질소·미세먼지·초미세먼지 농도 수치·플래그·통합대기환경수치까지 공통 스키마로 정규화되어 헬스케어·웨더·IoT·학교·공공기관이 외부 활동 가이드, 건강 알림, 스마트홈 환기 제어, 보도 콘텐츠를 구성할 수 있도록 설계되어 있습니다. 헬스케어·날씨·미디어·공공기관·학교·스마트홈 IoT 서비스가 대기질 알림, 외부 활동 가이드, 공기청정기·환기 자동 제어, 대기질 기반 건강 리포트를 구성할 때 자주 선택되는 카테고리입니다.

분류
공공 데이터
자료 출처
한국환경공단
수집 방식
한국환경공단가 제공하는 API를 호출해 단일 스키마로 정규화
제공 API
5종
연동 구조
단일 원천, 서브 API 병렬 호출
주요 활용
헬스케어·호흡기 취약 계층 알림, 학교·공공기관의 야외 활동 지침, 스마트홈·미디어 콘텐츠

SYSTEM FLOW

시스템 흐름

클라이언트 요청이 SIONLAB API 게이트웨이를 거쳐 원천 기관으로 전달·통합되는 경로입니다. 5개 서브 API를 병렬로 호출해 단일 응답으로 정규화합니다.

ENDPOINTS

제공 API (5종)

API명제공 정보자료 출처
대기질 예보통보 조회
입력조회 일자·지역
반환통보시간·예보 개황·발생 원인·예보 등급·행동 요령·시간대별 예측 모델 결과 사진
한국환경공단
초미세먼지 주간예보 조회
반환첫째날~넷째날 예보·대기질 전망
한국환경공단
측정소별 실시간 측정정보 조회
입력측정소명
반환측정일·측정소명·아황산가스/일산화탄소/오존/이산화질소/미세먼지/초미세먼지 농도·수치·플래그·통합대기환경수치
한국환경공단
통합대기환경지수 나쁨 이상 측정소 목록조회
반환측정소명·측정소 주소 (나쁨 이상 구간)
한국환경공단
시도별 실시간 측정정보 조회
입력시도 코드
반환시도 내 측정소별 측정일·농도·수치·플래그·통합대기환경수치
한국환경공단

USE CASES

이용사례

헬스케어·날씨·미디어·공공기관·학교·스마트홈 IoT 서비스가 에어코리아 대기질·초미세먼지 예보와 실시간 측정치를 묶어 외부 활동 가이드·건강 알림·스마트 환기 제어·대기질 리포트를 구성하려 할 때 자주 선택되는 대기오염 정보 API 유형입니다.

헬스케어·호흡기 취약 계층 알림

  • 사용자 위치 기준 실시간 농도 데이터를 수집해 개인 맞춤 알림 발송
  • 호흡기·심혈관 위험군 사용자에게 나쁨 이상 구간 선제 경고
  • 대기질 노출 이력을 축적해 건강 리포트의 보조 지표로 활용

학교·공공기관의 야외 활동 지침

  • 학교 체육·야외 행사 일정에 예보 등급·행동 요령을 자동 반영
  • 공공기관 민원 창구에 지역 대기질 상태를 상시 노출
  • 지자체 공지·재난 문자 발송 트리거로 나쁨 이상 측정소 목록을 사용

스마트홈·미디어 콘텐츠

  • 공기청정기·환기 시스템 IoT와 연동해 실시간 측정치 기반 자동 제어
  • 날씨 앱·뉴스에 대기질 전망과 주간 예보를 임베드
  • 지역별 대기질 데이터를 지도 기반 대시보드로 시각화

ONBOARDING

도입 절차

상담부터 연동·검수까지 네 단계로 진행합니다. 목록에 없는 API도 요청할 수 있습니다.

  1. STEP 01

    상담 신청

    필요한 데이터와 사용 목적을 알려주시면 접수합니다. 목록에 없는 API도 요청할 수 있습니다.

  2. STEP 02

    타당성·범위 회신

    원천 공개 여부와 수집 방식, 법적 검토를 거쳐 상담 접수 후 2~5영업일 내 타당성을 회신드립니다.

  3. STEP 03

    응답 스키마 합의

    견적 단계에서 응답 스키마를 합의합니다. 필드명·필터·요약 가공은 정규화 레이어에서 조정합니다.

  4. STEP 04

    연동·검수

    인증키를 발급하고 연동합니다. 필요한 원천을 병렬 호출해 단일 응답으로 정규화한 결과를 함께 검수합니다.

FAQ

자주 묻는 질문

대기오염정보 API는 어떤 데이터를 조회할 수 있나요?

대기질 예보통보 조회, 초미세먼지 주간예보 조회, 측정소별 실시간 측정정보 조회, 통합대기환경지수 나쁨 이상 측정소 목록조회, 시도별 실시간 측정정보 조회의 엔드포인트를 제공합니다. 입력: 조회 일자·지역 / 반환: 통보시간·예보 개황·발생 원인·예보 등급·행동 요령·시간대별 예측 모델 결과 사진

헬스케어·호흡기 취약 계층 알림에 대기오염정보 API를 어떻게 활용하나요?

사용자 위치 기준 실시간 농도 데이터를 수집해 개인 맞춤 알림 발송. 호흡기·심혈관 위험군 사용자에게 나쁨 이상 구간 선제 경고. 대기질 노출 이력을 축적해 건강 리포트의 보조 지표로 활용.

학교·공공기관의 야외 활동 지침에 대기오염정보 API를 어떻게 활용하나요?

학교 체육·야외 행사 일정에 예보 등급·행동 요령을 자동 반영. 공공기관 민원 창구에 지역 대기질 상태를 상시 노출. 지자체 공지·재난 문자 발송 트리거로 나쁨 이상 측정소 목록을 사용.

스마트홈·미디어 콘텐츠에 대기오염정보 API를 어떻게 활용하나요?

공기청정기·환기 시스템 IoT와 연동해 실시간 측정치 기반 자동 제어. 날씨 앱·뉴스에 대기질 전망과 주간 예보를 임베드. 지역별 대기질 데이터를 지도 기반 대시보드로 시각화.

대기오염정보 데이터는 어디에서 가져오나요?

한국환경공단가 제공하는 API를 호출해 단일 스키마로 정규화합니다. 원천 공개 여부와 수집 방식, 법적 검토는 상담 접수 후 타당성 회신 단계에서 확인합니다.

비용과 기간은 어떻게 정해지나요?

상담 접수 후 2~5영업일 내 타당성과 범위를 회신하고, 견적 단계에서 응답 스키마(필드명·필터·요약 가공)를 합의합니다. 비용과 기간은 이 합의 범위에 따라 견적으로 안내합니다.

목록에 없는 새 API도 요청 가능한가요?

가능합니다. 원천 공개 여부·수집 방식·법적 검토가 선행되며, 상담 접수 후 2~5영업일 내 타당성 회신을 드립니다.

문의하기