산업특화

산업분야에서 필요로하는 데이터를 묶음으로 제공합니다.

API 대표이미지 배너

1. 지상관측데이터 일통계(일사, 일조, 구름, 기온, 습도) 조회서비스

호출URL정보

생성 URL

https://apihub.kma.go.kr/api/typ01/url/sun_sfc_day.php?authKey=hrQs0zeMSfq0LNM3jLn6RA

요청인자

데이터 기본 정보
인자명 입력 의미 설명

stn

지점번호

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

tm1

년월일(KST)

기간: 시작일 (yyyymmdd / 없으면 현재시간)

tm2

년월일(KST)

기간: 종료일 (yyyymmdd / 없으면 현재시간)

help

도움말추가

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

disp

표출

1(빈칸없는 CSV파일), 0(일정 간격)

authKey

인증키

발급된 API 인증키

2. 지상관측데이터 평년값(일조, 구름, 기온, 습도) 조회서비스

호출URL정보

생성 URL

https://apihub.kma.go.kr/api/typ01/url/sun_sfc_norm.php?authKey=hrQs0zeMSfq0LNM3jLn6RA

요청인자

데이터 기본 정보
인자명 입력 의미 설명

stn

지점번호

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

norm

평년종류

D(일), S(순), M(월), Y(연)

tmst

평년기간

1991(1961~1990년), 2001(1971~2000년), 2011(1981~2010년), 2021(1991~2020년)

MM1

시작 월

기간 : MM1월 DD1일 ~ MM2월 DD2일

DD1

시작 일

순별 평년값인 경우, 100(상순), 200(중순), 300(하순)

MM2

종료 월

DD2

종료 일

authKey

인증키

발급된 API 인증키

3. 관측-통계(일사, 일조) 묶음형 조회서비스

호출URL정보

생성 URL

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-sun_sfc_sts_pkg?authKey=hrQs0zeMSfq0LNM3jLn6RA

요청인자

데이터 기본 정보
인자명 입력 의미 설명

stn

지점번호

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

tm1

년월일시분(KST)

기간: 시작시간 (yyyymmddhhmm / 없으면 현재시간)

tm2

년월일시분(KST)

기간: 종료시간 (yyyymmddhhmm / 없으면 현재시간)

mode

자료종류

조회 자료 종류 (ss:일조시간, si:일사량)

help

도움말추가

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

disp

표출

1(빈칸없는 CSV파일), 0(일정 간격)

authKey

인증키

발급된 API 인증키

4. 천리안2A호 인공지능 기반 일사량 데이터 지점 조회서비스

호출URL정보

생성 URL

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph_sun_sat_ana_txt?authKey=hrQs0zeMSfq0LNM3jLn6RA

요청인자

데이터 기본 정보
인자명 입력 의미 설명

tm1

년월일시분(UTC)

기간: 시작시간 (yyyymmddhhmm / 없으면 현재시간 / 30분 간격)

tm2

년월일시분(UTC)

기간: 종료시간 (yyyymmddhhmm / 없으면 현재시간 / 30분 간격)

int

자료간격

읽어들일 생산시간 간격(분), 생산시각을 기준으로 인터벌 간격으로 데이터를 읽어들일지 결정 (30분 단위)

lat

위도

가장 가까운 격자점 값을 사용 (행정구역, 위경도 중 택 1)

lon

경도

가장 가까운 격자점 값을 사용

area

행정구역 코드

입력한 시군구에 속한 데이터 제공 (행정구역, 위경도 중 택 1)

authKey

인증키

발급된 API 인증키

5. 천리안2A호 기상산출물(복사, 구름, 안개)지점 조회서비스

호출URL정보

생성 URL

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph_sun_sat_txt?authKey=hrQs0zeMSfq0LNM3jLn6RA

요청인자

데이터 기본 정보
인자명 입력 의미 설명

tm1

년월일시분(UTC)

기간: 시작시간 (yyyymmddhhmm / 없으면 현재시간)

tm2

년월일시분(UTC)

기간: 종료시간 (yyyymmddhhmm / 없으면 현재시간)

int

자료간격

읽어들일 생산시간 간격(분), 생산시각을 기준으로 인터벌 간격으로 데이터를 읽어들일지 결정 (10분 단위)

varn

자료종류

조회 자료 종류 (ASR=지면 흡수단파복사, DSR=지면 하향단파복사, FOG=안개, CA=운량, CLL=구름층 고도, CT=운형)

lat

위도

가장 가까운 격자점 값을 사용 (행정구역, 위경도 중 택 1)

lon

경도

가장 가까운 격자점 값을 사용

area

행정구역 코드

입력한 시군구에 속한 데이터 제공 (행정구역, 위경도 중 택 1)

authKey

인증키

발급된 API 인증키

6. 수치모델 데이터(복사, 기온, 구름, 강설) 지점 조회서비스

호출URL정보

생성 URL

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph_sun_nwp_txt?authKey=hrQs0zeMSfq0LNM3jLn6RA

요청인자

데이터 기본 정보
인자명 입력 의미 설명

nwp

모델 구분

UMG(UM-전구모델), KIMG(KIM-전구모델), KIMR(KIM-지역모델)

varn

자료종류

조회 자료 종류 (모델에 따라 선택 가능한 자료종류에 차이발생)

tm

발표시간(UTC)

발표시간 (yyyymmdd / 6시간 간격)

tmef1

발효시각(UTC)

기간: 발표시각 기준 발효시간 시작점 (yyyymmddhhmm / 6시간 간격)

tmef2

발효시각(UTC)

기간: 발표시각 기준 발효시간 종료점 (yyyymmddhhmm / 6시간 간격)

int

자료간격

읽어들일 생산시간 간격(시간), 생산시각을 기준으로 인터벌 간격으로 데이터를 읽어들일지 결정 (3시간 단위)

lat

위도

가장 가까운 격자점 값을 사용 (행정구역, 위경도 중 택 1)

lon

경도

가장 가까운 격자점 값을 사용

area

행정구역 코드

입력한 시군구에 속한 데이터 제공 (행정구역, 위경도 중 택 1)

authKey

인증키

발급된 API 인증키