지상관측

목측과 자동기상관측장비, 황사관측장비 등으로 관측한 일기현상, 기온, 강수, 바람, 황사, 자외선 등의 데이터를 제공합니다.

api 상세
개요

황사관측(PM10)는 대기 중에 부유하는 에어로졸 중 직경이 10㎛ 이하인 입자의 농도를 연속 측정합니다. 먼지(황사 포함)가 필터에 침적되고, 동위원소 C-14에서 방출되는 베타선을 필터 여지에 쏘아 감쇄된 베타선을 검출기로 측정하여 황사의 농도를 산출합니다.

요 소

부유분진 농도

지 점

27지점 (2020. 4. 1. 기준)

보유기간

2003년 4월 ∼ 현재(지점별 상이함)

생산주기

분(5분 주기), 시간 자료

1. 기상청 PM10 관측자료 조회

https://apihub.kma.go.kr/api/typ01/url/kma_pm10.php?tm1=201708011215&tm2=201708011230&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

tm1

년월일시분(KST)

요청시간 기준의 시작시간 (없으면 현재시간)

tm2

년월일시분(KST)

요청시간 기준의 종료시간 (없으면 현재시간)

stn

지점번호

해당 지점 (0 이거나 없으면 전체지점)

authKey

인증키

발급된 API 인증키

출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

TM

관측시각(KST, 년월일시분)

STN_ID

기상청 PM10 지점번호

PM10

PM10 (ug/m3)

FLAG

장비상태

MQC

MQC 결과

2. 황사관측자료 조회

ADM DB테이블 참고자료

중국기상청 환경관측 DB테이블 참고자료

2.1 황사지점정보

https://apihub.kma.go.kr/api/typ01/url/stn_pm10_inf.php?inf=kma&stn=&tm=201011110000&help=1&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

inf

기관종류

황사자료 기관종류 (없으면 전체기관)

tm

년월일시분(KST)

해당 시점에 존재하는 지점목록(없으면 현재시각)

stn

지점번호

해당 지점의 정보 표출 (없으면 전체지점)

help

도움말

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

tm_st

년월일시분(KST)

검색시작시각 (있으면 tm이 검색종료시각, 없으면 단일표출)

org

기관종류

황사자료 기관종류 (없으면 전체기관)

data

관측시간단위

0 이거나 없으면 관측자료를 5분단위로 표출
1 이면 관측자료를 정시단위로 표출

authKey

인증키

발급된 API 인증키

출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

STN_ID

지점번호

TM_ST

시작시각

TM_ED

종료시각

STN_KO

지점명(한글)

STN_EN

지점명(영문)

STN_SP

지점 특성코드

LON

경도(degree)

LAT

위도(degree)

HT

노장 해발고도 (m)

STN_AD

관리관서번호

FCT_ID

예보구역코드

kma

기상청

cma

중국기상청

kcc

고려대기환경연구소

moe

환경부

TM

관측시간 (KST)

ORG

관측기관

STN

지점번호

PM10

PM10 관측값

AQC

AQC결과값 (org=kma 일때만)

MQC

MQC결과값 (org=kma 일때만)

AVG

PM10 시간평균값

MIN

PM10 시간최소값

MAX

PM10 시간최대값

CNT

PM10 자료갯수

2.2 황사(PM10) 관측자료

https://apihub.kma.go.kr/api/typ01/url/dst_pm10_tm.php?tm=201012310900&org='kma'&stn=&data=&mode=1&help=1&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

inf

기관종류

황사자료 기관종류 (없으면 전체기관)

tm

년월일시분(KST)

해당 시점에 존재하는 지점목록(없으면 현재시각)

stn

지점번호

해당 지점의 정보 표출 (없으면 전체지점)

help

도움말

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

tm_st

년월일시분(KST)

검색시작시각 (있으면 tm이 검색종료시각, 없으면 단일표출)

org

기관종류

황사자료 기관종류 (없으면 전체기관)

data

관측시간단위

0 이거나 없으면 관측자료를 5분단위로 표출
1 이면 관측자료를 정시단위로 표출

authKey

인증키

발급된 API 인증키

출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

STN_ID

지점번호

TM_ST

시작시각

TM_ED

종료시각

STN_KO

지점명(한글)

STN_EN

지점명(영문)

STN_SP

지점 특성코드

LON

경도(degree)

LAT

위도(degree)

HT

노장 해발고도 (m)

STN_AD

관리관서번호

FCT_ID

예보구역코드

kma

기상청

cma

중국기상청

kcc

고려대기환경연구소

moe

환경부

TM

관측시간 (KST)

ORG

관측기관

STN

지점번호

PM10

PM10 관측값

AQC

AQC결과값 (org=kma 일때만)

MQC

MQC결과값 (org=kma 일때만)

AVG

PM10 시간평균값

MIN

PM10 시간최소값

MAX

PM10 시간최대값

CNT

PM10 자료갯수

2.3 황사(PM10) 시간통계자료

https://apihub.kma.go.kr/api/typ01/url/dst_pm10_hr.php?tm=201012310900&org='kma'&stn=&mode=1&help=1&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

inf

기관종류

황사자료 기관종류 (없으면 전체기관)

tm

년월일시분(KST)

해당 시점에 존재하는 지점목록(없으면 현재시각)

stn

지점번호

해당 지점의 정보 표출 (없으면 전체지점)

help

도움말

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

tm_st

년월일시분(KST)

검색시작시각 (있으면 tm이 검색종료시각, 없으면 단일표출)

org

기관종류

황사자료 기관종류 (없으면 전체기관)

data

관측시간단위

0 이거나 없으면 관측자료를 5분단위로 표출
1 이면 관측자료를 정시단위로 표출

authKey

인증키

발급된 API 인증키

출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

STN_ID

지점번호

TM_ST

시작시각

TM_ED

종료시각

STN_KO

지점명(한글)

STN_EN

지점명(영문)

STN_SP

지점 특성코드

LON

경도(degree)

LAT

위도(degree)

HT

노장 해발고도 (m)

STN_AD

관리관서번호

FCT_ID

예보구역코드

kma

기상청

cma

중국기상청

kcc

고려대기환경연구소

moe

환경부

TM

관측시간 (KST)

ORG

관측기관

STN

지점번호

PM10

PM10 관측값

AQC

AQC결과값 (org=kma 일때만)

MQC

MQC결과값 (org=kma 일때만)

AVG

PM10 시간평균값

MIN

PM10 시간최소값

MAX

PM10 시간최대값

CNT

PM10 자료갯수

3. 황사정보(위성영상, 일기도, 관측자료) 조회서비스

3.1 황사위성영상조회

https://apihub.kma.go.kr/api/typ02/openApi/YdstInfoService/getYdstSatlitImg?pageNo=1&numOfRows=10&dataType=XML&time=202409060000&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

sat

위성구분

천리안위성자료(C)

code

코드

황사지수(IDI)

time

시간

년월일(YYYYMMDD) 최근 1일 조회가능

authKey

인증키

발급된 API 인증키

출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

sat-img-file

파일배열

3.2 황사관측조회

https://apihub.kma.go.kr/api/typ02/openApi/YdstInfoService/getYdstObs?pageNo=1&numOfRows=10&dataType=XML&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

tm

관측시각 (년월일시분)

년월일시분(YYYYMMDDHH24MI) 최근 1일 조회 가능(5분 주기)

authKey

인증키

발급된 API 인증키

출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stnId

지점번호

tm

관측시각 (년월일시분)

pm10

PM10 관측값

3.3 황사일기도조회

https://apihub.kma.go.kr/api/typ02/openApi/YdstInfoService/getYdstSfcChart?pageNo=1&numOfRows=10&dataType=XML&time=202409050000&authKey={인증키입력}

요청인자
데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)Default: XML

time

시간

년월일(YYYYMMDD) 최근 1일 조회 가능

authKey

인증키

발급된 API 인증키

출력결과
출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

sfc3-file

파일배열